Gmailコネクタ

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

Lakeflow Connectの管理型Gmailコネクターは、Gmailメールボックスからメッセージ、ラベル、ドラフト、フィルターをDatabricksに取り込みます。

このコネクタは、Google サービスアカウントを使用して接続ごとに単一のメールボックスから読み取りを行い、読み取り専用となります。ソースのメールボックスが変更されることはありません。messages テーブルと message_labels テーブルは、Gmail History API を使用して増分同期されます。その他のテーブルは、パイプラインのランごとに完全に取り込み直されます。

機能の利用可能性

Gmailはクラウドに依存しません。以下の機能の可用性は、AWSおよびGCPに適用されます。

機能	可用性
UIベースのパイプライン作成	サポート
API ベースのパイプラインオーサリング	サポート
宣言型オートメーションバンドル	サポート
増分取り込み	サポート messagesテーブルおよびmessage_labelsテーブルのみが対象です。その他のテーブルはフル更新のみとなります。
Unity Catalog ガバナンス	サポート
Databricks Workflows を使用したオーケストレーション	サポート
SCDタイプ2	サポートされていません messages または message_labels テーブルに対して SCD タイプ 2 を構成すると、パイプラインの検証が失敗します。

機能	可用性
UIベースのパイプライン作成	サポート
API ベースのパイプラインオーサリング	サポート
宣言型オートメーションバンドル	サポート
増分取り込み	サポート messagesテーブルおよびmessage_labelsテーブルのみが対象です。その他のテーブルはフル更新のみとなります。
Unity Catalog ガバナンス	サポート
Databricks Workflows を使用したオーケストレーション	サポート
SCDタイプ2	サポートされていません messages または message_labels テーブルに対して SCD タイプ 2 を構成すると、パイプラインの検証が失敗します。

認証方法

認証方法	可用性
Googleサービスアカウント(ドメイン全体の委任を持つOAuthサービスアカウント)	サポート
OAuth U2M	サポートされていません
基本認証 (ユーザー名/パスワード)	サポートされていません

認証方法	可用性
Googleサービスアカウント(ドメイン全体の委任を持つOAuthサービスアカウント)	サポート
OAuth U2M	サポートされていません
基本認証 (ユーザー名/パスワード)	サポートされていません

コネクターは、Google サービスアカウントを使用して Gmail に対して認証を行います。サービスアカウントに https://www.googleapis.com/auth/gmail.readonly スコープのドメイン全体の委任を付与し、サービスアカウントが偽装するメールボックスを選択します。セットアップの手順については、「Databricks への取り込み用に Gmail を構成する」を参照してください。

始める前に知っておくべきこと

トピック	これが重要である理由
Databricks ユーザーペルソナ	ワークフローは、Databricks のユーザーペルソナによって異なります： シングルユーザー：管理者ユーザーが Unity Catalog 接続と取り込みパイプラインを作成します。 マルチユーザー：管理者が、管理者以外のユーザーがパイプラインを作成するための接続を作成します。
認証方法	コネクターは単一のメールボックスを模倣したGoogleサービスアカウントで認証します。
1 接続につき 1 メールボックス	各接続で 1 つのメールボックスを取り込みます。複数のメールボックスを取り込むには、メールボックスごとに個別の接続とパイプラインを作成します。メールボックスの値は、すべての行に mailbox 列としてスタンプされます。
インターフェース	パイプラインを作成するステップはインターフェースによって異なります。
取り込み頻度	パイプラインのスケジュールは、レイテンシとコストの要件によって異なります。

トピック	これが重要である理由
Databricks ユーザーペルソナ	ワークフローは、Databricks のユーザーペルソナによって異なります： シングルユーザー：管理者ユーザーが Unity Catalog 接続と取り込みパイプラインを作成します。 マルチユーザー：管理者が、管理者以外のユーザーがパイプラインを作成するための接続を作成します。
認証方法	コネクターは単一のメールボックスを模倣したGoogleサービスアカウントで認証します。
1 接続につき 1 メールボックス	各接続で 1 つのメールボックスを取り込みます。複数のメールボックスを取り込むには、メールボックスごとに個別の接続とパイプラインを作成します。メールボックスの値は、すべての行に mailbox 列としてスタンプされます。
インターフェース	パイプラインを作成するステップはインターフェースによって異なります。
取り込み頻度	パイプラインのスケジュールは、レイテンシとコストの要件によって異なります。

Gmail からの取り込みを開始する

次の表は、ユーザータイプ別のエンドツーエンドの Gmail 取り込みフローの概要を示しています。

ユーザー	ステップ
管理	Databricks からの認証を有効にするには、Google Cloud サービスアカウントを構成します。Databricks への取り込み用に Gmail を構成するを参照してください。 次のいずれか： 管理者以外のユーザーがパイプラインを作成できるように、カタログエクスプローラーを使用して Gmail への接続を作成します。Gmail 接続の作成を参照してください。 データ取り込み UI を使用して、接続とパイプラインを同時に作成します。「Gmail からのデータの取り込み」を参照してください。
非管理者	サポートされている任意のインターフェイスを使用して、既存の接続からパイプラインを作成します。「Gmail からのデータの取り込み」を参照してください。

ユーザー	ステップ
管理	Databricks からの認証を有効にするには、Google Cloud サービスアカウントを構成します。Databricks への取り込み用に Gmail を構成するを参照してください。 次のいずれか： 管理者以外のユーザーがパイプラインを作成できるように、カタログエクスプローラーを使用して Gmail への接続を作成します。Gmail 接続の作成を参照してください。 データ取り込み UI を使用して、接続とパイプラインを同時に作成します。「Gmail からのデータの取り込み」を参照してください。
非管理者	サポートされている任意のインターフェイスを使用して、既存の接続からパイプラインを作成します。「Gmail からのデータの取り込み」を参照してください。

その他のリソース

• Gmail コネクタの FAQ
• Gmailコネクタの制限事項
• Gmailコネクタのリファレンス
• Gmailインジェストのトラブルシューティング