ドキュメントメニュー

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

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

同期の動作#

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

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

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