Important
この機能は ベータ版です。 ワークスペース管理者は、[ プレビュー] ページからこの機能へのアクセスを制御できます。 Manage Azure Databricks プレビューを参照してください。
Lakeflow ConnectのマネージドGmailコネクターは、Gmailメールボックスからメッセージ、ラベル、ドラフト、フィルターをAzure Databricksに取り込みます。
コネクタは、Google サービス アカウントを使用して、接続ごとに 1 つのメールボックスのみからデータを読み取り、また、読み取り専用です。 送信元のメールボックスは一切変更されません。
messagesテーブルとmessage_labelsテーブルはGmail履歴APIを使って段階的に同期されます。 他のテーブルは、各パイプライン実行時に完全に再取り込みされます。
機能の可用性
以下の表はGmailコネクタの機能の利用可能性を示しています。
| 特徴 | 可用性 |
|---|---|
| UI ベースのパイプライン作成 |
サポート |
| API ベースのパイプライン作成 |
サポート |
| 宣言型オートメーション バンドル |
サポート |
| 増分インジェスト |
サポートmessagesとmessage_labelsのテーブルだけだ。 他のテーブルはフルリフレッシュのみです。 |
| Unity Catalog（ユニティカタログ）のガバナンス |
サポート |
| Databricks ワークフローを使用したオーケストレーション |
サポート |
| SCD タイプ 2 |
サポートされていませんmessages または message_labels テーブルに SCD タイプ 2 を設定すると、パイプラインの検証が失敗します。 |
認証方法
| 認証方法 | 可用性 |
|---|---|
| Googleサービスアカウント(ドメイン全体の委任を持つOAuthサービスアカウント) |
サポート |
| OAuth U2M |
サポートされていません |
| 基本認証 (ユーザー名/パスワード) |
サポートされていません |
コネクターはGoogleサービスアカウントでGmailに認証します。 サービスアカウントに https://www.googleapis.com/auth/gmail.readonly 範囲のドメイン全体委任を許可し、サービスアカウントが代用するメールボックスを選択します。 設定手順については、「Configure Gmail for Azure Databricks inestion」をご覧ください。
開始する前に知っておくべきこと
| トピック | 共同作業の重要性 |
|---|---|
| Azure Databricks ユーザーペルソナ | ワークフローは、Azure Databricks ユーザーペルソナによって異なります。
|
| 認証方法 | コネクターは単一のメールボックスを模倣したGoogleサービスアカウントで認証します。 |
| 接続ごとに1つの郵便受け | 各接続は1つのメールボックスを取り込みます。 複数のメールボックスを取り込むには、各メールボックスごとに別々の接続とパイプラインを作成します。 メールボックスの値は、各行に mailbox 列として記録されます。 |
| Interface | パイプラインを作成する手順は、インターフェイスによって異なります。 |
| インジェストの頻度 | パイプライン のスケジュールは、待機時間とコストの要件によって異なります。 |
Gmailから取り込み始めましょう
以下の表は、ユーザータイプに基づくエンドツーエンドのGmailインジェスションフローの概要を示しています。
| User | Steps |
|---|---|
| 管理者 |
|
| 非管理者 | サポートされているインターフェイスを使用して、既存の接続からパイプラインを作成します。 Gmailからデータを取り込む方法をご覧ください。 |
