SendGrid コネクタのリファレンス

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者は プレビュー ページから SendGrid向けLakeflow Connect を有効にする必要があります。Databricksのプレビューを管理するを参照してください。

このページには、サポートされているソーステーブルや宛先テーブルのスキーマなど、管理対象のSendGridコネクタに関する参照情報が記載されています。

サポートされているソーステーブル

SendGridコネクタは、すべてdefaultソーススキーマ配下の以下のソーステーブルをサポートしています。

ソーステーブル	プライマリーキー	説明	同期モード
`subusers`	`id`	親SendGridアカウント配下のサブユーザー。各サブユーザーのユーザー名、Eメール、および無効状態を含みます。	フル更新のみ
`recent_access_attempts`	`subuser`, `ip`	各サブユーザーの代理で取得された、各サブユーザーの最近のIPアクセス試行。	フル更新のみ
`parent_access_attempts`	`ip`	親アカウント自体の最近のIPアクセス試行。	フル更新のみ
`bounces`		バウンス抑制リストに登録されているEメールアドレスと、バウンスのステータスおよび理由。	フル更新のみ
`spam_reports`		スパムレポートの抑制リストに登録されているEメールアドレス。	フル更新のみ
`global_suppressions`		すべてのEメールの配信を停止したEメールアドレス	フル更新のみ
`blocks`		ブロック抑制リストに登録されているEメールアドレスと、ブロックのステータスおよび理由。	フル更新のみ
`invalid_emails`		無効なEメールの抑制リストに登録されているEメールアドレスと、その理由。	フル更新のみ
`suppression_group_members`	`group_id`, `email`	配信停止グループから抑制されているEメールアドレスと、その所属グループ。	フル更新のみ
`suppression_groups`	`id`	アカウントで定義された配信停止（抑制）グループ。	フル更新のみ
`contacts`	`contact_id`	マーケティング連絡先（カスタムフィールドを含む）。コネクターは、SendGrid の連絡先エクスポートを通じて連絡先リスト全体を読み取ります。	フル更新のみ
`lists`	`id`	各リストの連絡先数を含むマーケティング連絡先リスト。	フル更新のみ
`singlesends`	`id`	マーケティングのSingle Send（ステータス、カテゴリ、A/Bテスト設定を含む）。	フル更新のみ
`templates`	`id`	レガシーおよび動的なトランザクションEメールTemplateと、そのバージョン。	フル更新のみ
`singlesend_stats`	`id`、`ab_phase`、`ab_variation`、 `aggregation`	Single Sends、A/B フェーズ、A/B バリエーション、集計ごとに1行のエンゲージメント統計	フル更新のみ
`automations_stats`	`id`、`step_id`、 `aggregation`	Automation、ステップ、集計ごとのエンゲージメント統計。	フル更新のみ
`segments`	`id`	マーケティングセグメント（Segmentation v2）、連絡先数とクエリー検証ステータス。	フル更新のみ

ソーステーブル	プライマリーキー	説明	同期モード
`subusers`	`id`	親SendGridアカウント配下のサブユーザー。各サブユーザーのユーザー名、Eメール、および無効状態を含みます。	フル更新のみ
`recent_access_attempts`	`subuser`, `ip`	各サブユーザーの代理で取得された、各サブユーザーの最近のIPアクセス試行。	フル更新のみ
`parent_access_attempts`	`ip`	親アカウント自体の最近のIPアクセス試行。	フル更新のみ
`bounces`		バウンス抑制リストに登録されているEメールアドレスと、バウンスのステータスおよび理由。	フル更新のみ
`spam_reports`		スパムレポートの抑制リストに登録されているEメールアドレス。	フル更新のみ
`global_suppressions`		すべてのEメールの配信を停止したEメールアドレス	フル更新のみ
`blocks`		ブロック抑制リストに登録されているEメールアドレスと、ブロックのステータスおよび理由。	フル更新のみ
`invalid_emails`		無効なEメールの抑制リストに登録されているEメールアドレスと、その理由。	フル更新のみ
`suppression_group_members`	`group_id`, `email`	配信停止グループから抑制されているEメールアドレスと、その所属グループ。	フル更新のみ
`suppression_groups`	`id`	アカウントで定義された配信停止（抑制）グループ。	フル更新のみ
`contacts`	`contact_id`	マーケティング連絡先（カスタムフィールドを含む）。コネクターは、SendGrid の連絡先エクスポートを通じて連絡先リスト全体を読み取ります。	フル更新のみ
`lists`	`id`	各リストの連絡先数を含むマーケティング連絡先リスト。	フル更新のみ
`singlesends`	`id`	マーケティングのSingle Send（ステータス、カテゴリ、A/Bテスト設定を含む）。	フル更新のみ
`templates`	`id`	レガシーおよび動的なトランザクションEメールTemplateと、そのバージョン。	フル更新のみ
`singlesend_stats`	`id`、`ab_phase`、`ab_variation`、 `aggregation`	Single Sends、A/B フェーズ、A/B バリエーション、集計ごとに1行のエンゲージメント統計	フル更新のみ
`automations_stats`	`id`、`step_id`、 `aggregation`	Automation、ステップ、集計ごとのエンゲージメント統計。	フル更新のみ
`segments`	`id`	マーケティングセグメント（Segmentation v2）、連絡先数とクエリー検証ステータス。	フル更新のみ

コネクターのオプション

SendGrid コネクタには、すべてのマネージドコネクタで利用可能なパイプライン設定以外の追加の構成オプションはありません。「SendGrid からのデータの取り込み」を参照してください。

宛先テーブルのスキーマ

`subusers`

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
`id`	`BIGINT`
`username`	`STRING`
`email`	`STRING`
`disabled`	`BOOLEAN`

`recent_access_attempts`

プライマリキー: subuser、ip 同期モード: 完全更新のみ

フィールド	データ型
`subuser`	`STRING`
`allowed`	`BOOLEAN`
`auth_method`	`STRING`
`first_at`	`BIGINT`
`last_at`	`BIGINT`
`ip`	`STRING`
`location`	`STRING`

`parent_access_attempts`

主キー: ip 同期モード: 完全更新のみ

フィールド	データ型
`allowed`	`BOOLEAN`
`auth_method`	`STRING`
`first_at`	`BIGINT`
`last_at`	`BIGINT`
`ip`	`STRING`
`location`	`STRING`

`bounces`

主キー： なし 同期モード： 完全更新のみ

フィールド	データ型
`email`	`STRING`
`created`	`BIGINT`
`status`	`STRING`
`reason`	`STRING`

`spam_reports`

主キー： なし 同期モード： 完全更新のみ

フィールド	データ型
`email`	`STRING`
`created`	`BIGINT`
`ip`	`STRING`

`global_suppressions`

主キー： なし 同期モード： 完全更新のみ

フィールド	データ型
`email`	`STRING`
`created`	`BIGINT`

`blocks`

主キー： なし 同期モード： 完全更新のみ

フィールド	データ型
`email`	`STRING`
`created`	`BIGINT`
`status`	`STRING`
`reason`	`STRING`

`invalid_emails`

主キー： なし 同期モード： 完全更新のみ

フィールド	データ型
`email`	`STRING`
`created`	`BIGINT`
`reason`	`STRING`

`suppression_group_members`

プライマリキー: group_id、email 同期モード: 完全更新のみ

フィールド	データ型
`email`	`STRING`
`group_id`	`BIGINT`
`group_name`	`STRING`
`created_at`	`BIGINT`

`suppression_groups`

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
`id`	`BIGINT`
`name`	`STRING`
`description`	`STRING`
`is_default`	`BOOLEAN`
`unsubscribes`	`BIGINT`

`contacts`

主キー: contact_id 同期モード: 完全更新のみ

フィールド	データ型
`contact_id`	`STRING`
`email`	`STRING`
`first_name`	`STRING`
`last_name`	`STRING`
`alternate_emails`	`ARRAY<STRING>`
`address_line_1`	`STRING`
`address_line_2`	`STRING`
`city`	`STRING`
`state_province_region`	`STRING`
`postal_code`	`STRING`
`country`	`STRING`
`phone_number`	`STRING`
`phone_number_id`	`STRING`
`whatsapp`	`STRING`
`line`	`STRING`
`facebook`	`STRING`
`unique_name`	`STRING`
`external_id`	`STRING`
`anonymous_id`	`STRING`
`custom_fields`	`VARIANT`
`created_at`	`STRING`
`updated_at`	`STRING`

フィールド	データ型
`contact_id`	`STRING`
`email`	`STRING`
`first_name`	`STRING`
`last_name`	`STRING`
`alternate_emails`	`ARRAY<STRING>`
`address_line_1`	`STRING`
`address_line_2`	`STRING`
`city`	`STRING`
`state_province_region`	`STRING`
`postal_code`	`STRING`
`country`	`STRING`
`phone_number`	`STRING`
`phone_number_id`	`STRING`
`whatsapp`	`STRING`
`line`	`STRING`
`facebook`	`STRING`
`unique_name`	`STRING`
`external_id`	`STRING`
`anonymous_id`	`STRING`
`custom_fields`	`VARIANT`
`created_at`	`STRING`
`updated_at`	`STRING`

注記

このテーブルにはVARIANT列があるため、SCDタイプ2はサポートされていません。

`lists`

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
`id`	`STRING`
`name`	`STRING`
`contact_count`	`BIGINT`
`_metadata`	`STRUCT<self: STRING>`

`singlesends`

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
`id`	`STRING`
`name`	`STRING`
`status`	`STRING`
`categories`	`ARRAY<STRING>`
`send_at`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`is_abtest`	`BOOLEAN`
`abtest`	`STRUCT<type: STRING, winner_criteria: STRING, test_percentage: BIGINT, duration: STRING, winning_template_id: STRING, winner_selected_at: STRING, expiration_date: STRING>`

フィールド	データ型
`id`	`STRING`
`name`	`STRING`
`status`	`STRING`
`categories`	`ARRAY<STRING>`
`send_at`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`is_abtest`	`BOOLEAN`
`abtest`	`STRUCT<type: STRING, winner_criteria: STRING, test_percentage: BIGINT, duration: STRING, winning_template_id: STRING, winner_selected_at: STRING, expiration_date: STRING>`

`templates`

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
`id`	`STRING`
`name`	`STRING`
`generation`	`STRING`
`updated_at`	`STRING`
`versions`	`ARRAY<STRUCT<id: STRING, template_id: STRING, active: BIGINT, name: STRING, subject: STRING, updated_at: STRING, generate_plain_content: BOOLEAN, editor: STRING, thumbnail_url: STRING>>`

フィールド	データ型
`id`	`STRING`
`name`	`STRING`
`generation`	`STRING`
`updated_at`	`STRING`
`versions`	`ARRAY<STRUCT<id: STRING, template_id: STRING, active: BIGINT, name: STRING, subject: STRING, updated_at: STRING, generate_plain_content: BOOLEAN, editor: STRING, thumbnail_url: STRING>>`

`singlesend_stats`

プライマリキー： id、ab_phase、ab_variation、aggregation 同期モード： 完全更新のみ

フィールド	データ型
`id`	`STRING`
`ab_phase`	`STRING`
`ab_variation`	`STRING`
`aggregation`	`STRING`
`stats`	`STRUCT<bounce_drops: BIGINT, bounces: BIGINT, clicks: BIGINT, delivered: BIGINT, invalid_emails: BIGINT, opens: BIGINT, requests: BIGINT, spam_report_drops: BIGINT, spam_reports: BIGINT, unique_clicks: BIGINT, unique_opens: BIGINT, unsubscribes: BIGINT>`

フィールド	データ型
`id`	`STRING`
`ab_phase`	`STRING`
`ab_variation`	`STRING`
`aggregation`	`STRING`
`stats`	`STRUCT<bounce_drops: BIGINT, bounces: BIGINT, clicks: BIGINT, delivered: BIGINT, invalid_emails: BIGINT, opens: BIGINT, requests: BIGINT, spam_report_drops: BIGINT, spam_reports: BIGINT, unique_clicks: BIGINT, unique_opens: BIGINT, unsubscribes: BIGINT>`

`automations_stats`

主キー： id、step_id、aggregation 同期モード： 完全更新のみ

フィールド	データ型
`id`	`STRING`
`aggregation`	`STRING`
`step_id`	`STRING`
`stats`	`STRUCT<bounce_drops: BIGINT, bounces: BIGINT, clicks: BIGINT, delivered: BIGINT, invalid_emails: BIGINT, opens: BIGINT, requests: BIGINT, spam_report_drops: BIGINT, spam_reports: BIGINT, unique_clicks: BIGINT, unique_opens: BIGINT, unsubscribes: BIGINT>`

フィールド	データ型
`id`	`STRING`
`aggregation`	`STRING`
`step_id`	`STRING`
`stats`	`STRUCT<bounce_drops: BIGINT, bounces: BIGINT, clicks: BIGINT, delivered: BIGINT, invalid_emails: BIGINT, opens: BIGINT, requests: BIGINT, spam_report_drops: BIGINT, spam_reports: BIGINT, unique_clicks: BIGINT, unique_opens: BIGINT, unsubscribes: BIGINT>`

`segments`

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
`id`	`STRING`
`name`	`STRING`
`query_version`	`STRING`
`contacts_count`	`BIGINT`
`parent_list_ids`	`ARRAY<STRING>`
`sample_updated_at`	`STRING`
`next_sample_update`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`status`	`STRUCT<query_validation: STRING, error_message: STRING>`

フィールド	データ型
`id`	`STRING`
`name`	`STRING`
`query_version`	`STRING`
`contacts_count`	`BIGINT`
`parent_list_ids`	`ARRAY<STRING>`
`sample_updated_at`	`STRING`
`next_sample_update`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`status`	`STRUCT<query_validation: STRING, error_message: STRING>`

サポートされているソーステーブル​

コネクターのオプション​

宛先テーブルのスキーマ​

subusers​

recent_access_attempts​

parent_access_attempts​

bounces​

spam_reports​

global_suppressions​

blocks​

invalid_emails​

suppression_group_members​

suppression_groups​

contacts​

lists​

singlesends​

templates​

singlesend_stats​

automations_stats​

segments​

サポートされているソーステーブル

コネクターのオプション

宛先テーブルのスキーマ

`subusers`

`recent_access_attempts`

`parent_access_attempts`

`bounces`

`spam_reports`

`global_suppressions`

`blocks`

`invalid_emails`

`suppression_group_members`

`suppression_groups`

`contacts`

`lists`

`singlesends`

`templates`

`singlesend_stats`

`automations_stats`

`segments`