ドキュメントメニュー

SendGrid#

API キーを使って SendGrid を接続します。このソースは titan.sendgrid に 6 個の固定テーブルを書き込みます。

sql
select
  id,
  email,
  first_name
from titan.sendgrid.contacts
limit 10

SendGridを接続する#

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

  2. API キーを入力します。

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

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

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

同期の動作#

コンタクト、リスト、キャンペーン、メールテンプレート、配信抑止、全体の配信停止をまとめて同期します。

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

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

テーブルリファレンス#

contacts#

titan.sendgrid.contacts には 9 個のソース列があります。

sendgrid.contacts9列
idstringpk

ソースのフィールド id

emailstring

ソースのフィールド email

first_namestring

ソースのフィールド firstName

last_namestring

ソースのフィールド lastName

citystring

ソースのフィールド city

countrystring

ソースのフィールド country

created_atdatetime

ソースのフィールド createdAt

updated_atdatetime

ソースのフィールド updatedAt

custom_fieldsjson

ソースのフィールド customFields

lists#

titan.sendgrid.lists には 5 個のソース列があります。

sendgrid.lists5列
idstringpk

ソースのフィールド id

namestring

ソースのフィールド name

contact_countinteger

ソースのフィールド contactCount

created_atdatetime

ソースのフィールド createdAt

updated_atdatetime

ソースのフィールド updatedAt

campaigns#

titan.sendgrid.campaigns には 6 個のソース列があります。

sendgrid.campaigns6列
idstringpk

ソースのフィールド id

namestring

ソースのフィールド name

statusstring

ソースのフィールド status

send_atdatetime

ソースのフィールド sendAt

created_atdatetime

ソースのフィールド createdAt

updated_atdatetime

ソースのフィールド updatedAt

templates#

titan.sendgrid.templates には 4 個のソース列があります。

sendgrid.templates4列
idstringpk

ソースのフィールド id

namestring

ソースのフィールド name

generationstring

ソースのフィールド generation

updated_atdatetime

ソースのフィールド updatedAt

suppressions#

titan.sendgrid.suppressions には 4 個のソース列があります。

sendgrid.suppressions4列
emailstringpk

ソースのフィールド email

reasonstring

ソースのフィールド reason

statusstring

ソースのフィールド status

created_atdatetime

ソースのフィールド createdAt

global_unsubscribes#

titan.sendgrid.global_unsubscribes には 2 個のソース列があります。

sendgrid.global_unsubscribes2列
emailstringpk

ソースのフィールド email

createddatetime

ソースのフィールド created

削除と履歴#

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