ドキュメントメニュー

Amplitude#

API キー、シークレット、過去データの取得開始日を使って Amplitude を接続します。このソースは titan.amplitude に 1 個の固定テーブルを書き込みます。

sql
select
  uuid,
  event_id,
  event_type
from titan.amplitude.events
limit 10

Amplitudeを接続する#

  1. アプリを開き、アプリを接続を選択してから、Amplitudeを選択します。

  2. API キー、シークレット、過去データの取得開始日を入力します。

  3. テーブルを確認してからソースを保存します。

  4. 初回の実行が完了するまで同期履歴を確認します。

認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。

同期の動作#

初回は設定した過去データの取得開始日から実行します。以降は最後に完了した期間から再開します。

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトの繰り返し間隔は 4 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルにはシステム列 _synced_at_deleted もあります。以下の列リファレンスにはソースの列のみを記載しています。

テーブルリファレンス#

events#

titan.amplitude.events には 40 個のソース列があります。

amplitude.events40列
uuidstringpk

ソースのフィールド uuid

event_idinteger

ソースのフィールド event_id

event_typestring

ソースのフィールド event_type

event_timedatetime

ソースのフィールド event_time

user_idstring

ソースのフィールド user_id

session_idinteger

ソースのフィールド session_id

amplitude_idinteger

ソースのフィールド amplitude_id

amplitude_attribution_idsstring

ソースのフィールド amplitude_attribution_ids

server_received_timedatetime

ソースのフィールド server_received_time

server_upload_timedatetime

ソースのフィールド server_upload_time

client_upload_timedatetime

ソースのフィールド client_upload_time

client_event_timedatetime

ソースのフィールド client_event_time

sample_ratestring

ソースのフィールド sample_rate

start_versionstring

ソースのフィールド start_version

appinteger

ソースのフィールド app

librarystring

ソースのフィールド library

device_carrierstring

ソースのフィールド device_carrier

processed_timedatetime

ソースのフィールド processed_time

version_namestring

ソースのフィールド version_name

payingboolean

ソースのフィールド paying

platformstring

ソースのフィールド platform

os_namestring

ソースのフィールド os_name

os_versionstring

ソースのフィールド os_version

device_idstring

ソースのフィールド device_id

device_typestring

ソースのフィールド device_type

device_familystring

ソースのフィールド device_family

languagestring

ソースのフィールド language

countrystring

ソースのフィールド country

regionstring

ソースのフィールド region

citystring

ソースのフィールド city

dmastring

ソースのフィールド dma

ip_addressstring

ソースのフィールド ip_address

datajson

ソースのフィールド data

event_propertiesjson

ソースのフィールド event_properties

user_propertiesjson

ソースのフィールド user_properties

group_propertiesjson

ソースのフィールド group_properties

groupsjson

ソースのフィールド groups

location_latfloat

ソースのフィールド location_lat

location_lngfloat

ソースのフィールド location_lng

insert_idstring

ソースのフィールド insert_id

削除と履歴#

行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して _deleted を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには where not _deleted で絞り込んでください。