ドキュメントメニュー

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. 初回の実行が完了するまで同期履歴を確認します。

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

同期の動作#

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

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトのスケジュールでは、組織のタイムゾーンで平日の 5:00、10:00、15:00、20:00 と日曜日の 20:00 に同期し、各ソースはその時刻から 30 分以内に開始します。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルにはシステム列 _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 で絞り込んでください。