[Ultimate]{class="badge positive"}

Azure Synapse Analytics

IMPORTANT
Real-Time Customer Data Platform Ultimateを購入したユーザーは、ソースカタログで Azure Synapse Analytics ソースを利用できます。

Azure Synapse Analytics は、ビッグデータとデータウェアハウスを統合するクラウドベースの分析サービスです。 SQL、Spark、リアルタイムのツールを使用して、データを移動することなく、データの取り込み、調査、準備、分析を行うことができます。

Azure Synapse Analytics ソースを使用してアカウントを接続し、データをAdobe Experience Platformに取り込むことができます。

前提条件 prerequisites

Azure Synapse Analytics アカウントをExperience Platformに接続する前に、以下の節を参照して前提条件の設定を完了してください。

IP アドレスの許可リスト

ソースをExperience Platformに接続する前に、地域固有の IP アドレスを許可リストに追加する必要があります。 詳しくは、Experience Platformへの接続に対する IP アドレスの許可リストに加える に関するガイドを参照してください。

権限の設定

ソースアカウントをExperience Platformに接続するには、アカウントで次の両方の権限が有効になっている必要があります。

  • ソースの表示
  • ソースの管理

これらの権限がない場合は、製品管理者に連絡してアクセス権をリクエストしてください。 詳しくは、 アクセス制御 UI ガイドを参照してください。

Experience Platformに対する認証

アカウントキー認証またはサービスプリンシパルキー認証のいずれかを使用して、Azure Synapse Analytics をExperience Platformに接続できます。

アカウントキー認証

アカウントキー認証を使用して Azure Synapse Analytics データベースをExperience Platformに接続するには、次の資格情報の値を指定します。

table 0-row-2 1-row-2 2-row-2
資格情報 説明
接続文字列 Azure Synapse Analytics での認証に使用する 接続文字列 です。 標準形式は Server=tcp:{SERVER_NAME}.database.windows.net,1433;Database={DATABASE};User ID={USERNAME}@{SERVER_NAME};Password={PASSWORD};Trusted_Connection=False;Encrypt=True;Connection Timeout=30 です。 プレースホルダーを実際の接続の詳細に置き換える必要があります。
接続仕様 ID 接続仕様 は、データソースのコネクタプロパティを提供します。 認証仕様や、ベース 接続と ソース 接続の両方を作成するための要件などの詳細が含まれます。 Azure Synapse Analytics の場合、接続仕様 ID は a49bcc7d-8038-43af-b1e4-5a7a089a7d79 です。 メモ: この資格情報は、API 経由で接続する場合にのみ必要です。
サービスプリンシパルキー認証

サービスプリンシパルキー認証用の資格情報を取得するには、Microsfot Entra admin center に移動して、次の値を取得します。

  • アプリ ID
  • 表示名
  • 秘密鍵
  • テナント ID

次に、Azure Synapse Analytics インスタンスに移動し、外部プロバイダーからユーザーを作成するオプションを選択します。 ここから、スキーマのサービスプリンシパルに適した権限を指定します。 メモ::スキーマのプレビューには、「コピー」と同様に、「SELECT」を含める必要があります。 例えば、次のようなコマンドがあります。

code language-sql
GRANT SELECT ON SCHEMA::dbo TO {APP_ID};

サービスプリンシパルキー認証を使用して Azure Synapse Analytics データベースをExperience Platformに接続するには、次の資格情報の値を指定します。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
資格情報 説明
サーバー Azure Synapse Analytics SQL エンドポイントの完全修飾ドメイン名。
データベース Azure Synapse Analytics ワークスペース内の特定のデータベースの名前。
テナント Azure サブスクリプションに関連付けられた Azure Active Directory テナント ID。
サービスプリンシパル ID Azure Active Directory アプリケーションのクライアント ID。
サービスプリンシパルキー サービスプリンシパルに関連付けられたクライアントの秘密鍵またはパスワード。
接続仕様 ID 接続仕様 は、データソースのコネクタプロパティを提供します。 認証仕様や、ベース 接続と ソース 接続の両方を作成するための要件などの詳細が含まれます。 Azure Synapse Analytics の場合、接続仕様 ID は a49bcc7d-8038-43af-b1e4-5a7a089a7d79 です。 メモ: この資格情報は、API 経由で接続する場合にのみ必要です。

詳しくは、Azure の ID の管理に関するドキュメント Azure Synapse Analytics を参照してください。

API を使用した Azure Synapse Analytics のExperience Platformへの接続

UI を使用した Azure Synapse Analytics のExperience Platformへの接続

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089