Google Cloud Serviceアカウントの設定方法を学び、Azure DatabricksがGmailメールボックスからデータを取り込めるようにしましょう。
Important
この機能は ベータ版です。 ワークスペース管理者は、[ プレビュー] ページからこの機能へのアクセスを制御できます。 Manage Azure Databricks プレビューを参照してください。
Gmailコネクターは、ドメイン全体の委任を用いて単一のメールボックスを模倣するGoogleサービスアカウントで認証します。 このタスクでは、サービスアカウントとJSONキーを作成し、Gmailデータへの読み取り専用アクセスを許可し、なりすまし用のメールボックスを特定します。 取得した認証情報を使って、Azure Databricks Unity CatalogのGmail接続を作成します。
前提条件
- サービスアカウントを作成したいGoogle Cloudプロジェクトへのアクセス権と、サービスアカウントの作成権限、キーの作成権限。
- Google Workspaceのスーパー管理者権限によりドメイン全体の委任権限が付与されます。
- 取り込みたいGmailメールボックスのメールアドレス。
サービスアカウントとJSONキーを作成します
Google Cloudコンソールで「 IAM & Admin > Service Accounts」に行きます。
サービスアカウントを作成をクリックします。
サービスアカウントの名前と説明を入力し、作成をクリックして 続けてください。
完了をクリックします。 プロジェクトレベルの役割を必ずしも付与する必要はありません。
サービスアカウントのページで、作成したサービスアカウントをクリックします。
キータブで「キーを追加」>「新しいキーを作成」をクリックします。
JSONを選択し、その後「作成」をクリックします。 JSONキーファイルはあなたのマシンにダウンロードされます。
JSONキーは安全に保存してください。 Unity Catalogの接続を作成するときにその内容を貼り付けます。
Gmail APIを有効にしてください
- Google Cloudコンソールで「 API & Services」 > ライブラリに行ってください。
- Gmail APIを検索してからクリックします。
- [有効化]をクリックします。
ドメイン全体の委任を付与する
ユーザーを代表してメールボックスデータを読み取るには、サービスアカウントがGoogle Workspaceでドメイン全体の委任権限を持つ必要があります。
Google Cloudコンソールで、詳細タブからサービスアカウントのUnique ID(クライアントID)をコピーします。
Google管理コンソールで、セキュリティ>アクセスとデータ制御>APIコントロールに移動します。
ドメイン全体の委任の「ドメイン全体の委任管理」をクリックします。
[ 新規追加] をクリックします。
クライアントIDにサービスアカウントのユニークなIDを貼り付けます。
OAuthスコープでは、以下の読み取り専用スコープを入力します:
https://www.googleapis.com/auth/gmail.readonly承認をクリックします。
なりすまし用の郵便受けを特定してください
サービスアカウントは単一のメールボックスを模倣します。 取り込みたい郵便受けのメールアドレス、例えば user@example.comをメモしてください。 Unityカタログの接続を作成する際に、このアドレスを偽装メールとして提供します。
複数のメールボックスを取り込むには、それぞれのメールボックスごとに別々の接続とパイプラインを作成します。
