SendGridへの認証を構成する
ベータ版
この機能はベータ版です。使用するには、ワークスペース管理者は プレビュー ページから Lakeflow Connect for SendGrid を有効にする必要があります。Databricksのプレビューを管理するを参照してください。
このページでは、SendGrid コネクタに対して Databricks からの認証を有効にするための SendGrid の構成方法を説明します。SendGrid コネクタは、SendGrid API キーを使用して Databricks にデータを取り込みます。このページのステップで取得した資格情報を使用して、Databricks で Unity Catalog 接続を作成します。
前提条件
- Pro または Premier Eメール API プラン、あるいは Advanced マーケティング Campaigns プランの SendGrid アカウント。サブユーザーは、これらのプランでのみ利用可能です。詳細については、SendGrid ドキュメントのサブユーザーを参照してください。
- Subusers、IP Access Management、Suppressions、Unsubscribe グループ、マーケティング、Template データへの読み取りアクセス権を持つ API キーを作成するための管理者アクセス権。
contacts、lists、segments、singlesends、singlesend_stats、automations_statsのテーブルを取り込むには、マーケティング Campaignsが有効になっているSendGridアカウントが必要です。- アカウントで IP アクセス管理が有効になっている場合は、Databricks Serverless のエグレス IP アドレスを許可リストに追加する必要があります。SendGrid は、リストにない IP アドレスからの API アクセスをブロックします。
SendGridの構成
取り込みたいテーブルのAPIへの読み取りアクセス権を持つSendGrid APIキーを作成します。情報については、SendGridのドキュメントのAPIキーを参照してください。
-
管理者としてSendGridアプリケーションにサインインしてください。
-
左側のナビゲーションで、 [設定] > [APIキー] を選択します。
-
APIキーを作成 をクリックします。
-
キーの名前を入力し、 カスタムアクセス を選択してください。
-
取り込むテーブルに応じて、次の権限に対する読み取りアクセス権を付与します。各権限が対応するAPIキーのスコープについては、SendGridドキュメントのAPIキーの権限を参照してください。
権限 | APIキーのスコープ | テーブル |
|---|---|---|
IPアクセス管理 | 読み取りアクセス |
|
サブユーザー | 読み取りアクセス |
|
抑制 |
|
|
グループのサブスクリプションを解除 |
|
|
マーケティング |
|
|
Templates |
|
|
選択を行う間は、各権限カテゴリーを展開したままにしてください。カテゴリーを折りたたむと、そのカテゴリーで選択した項目がResetされる場合があります。 6. [ Create & View ] をクリックし、生成されたキーをコピーします。SendGrid では、キー値は 1 回のみ表示されます。
- キーを安全に保存します。Databricks で接続を作成する際に、 API キー としてこの値を入力します。
Bearerプレフィックスを付けず、キーの値のみを入力してください。
SendGridアカウントのデータリージョンを確認してください。EUのデータ・レジデンシーアカウントではapi.eu.sendgrid.comを使用し、それ以外のアカウントではグローバルEndpoint api.sendgrid.comを使用します。このリージョンは、接続の作成時に選択します。マーケティングキャンペーンテーブル（contacts、lists、segments、singlesends、singlesend_stats、automations_stats）は、米国リージョンのアカウントでのみ利用できます。euリージョンを使用する接続では、それらを選択しないでください。
APIキーは、それが属するアカウントのデータのみを読み取ります。複数のSendGridアカウントまたはサブユーザーから取り込むには、それぞれに個別のAPIキーと接続を作成してください。
次のステップ
Databricks で SendGrid 接続を作成します。SendGrid接続の作成を参照してください。