[Ultimate]{class="badge positive"}

Snowflake ソース

IMPORTANT
  • Real-Time Customer Data Platform Ultimateを購入したユーザーは、ソースカタログで Snowflake ソースを利用できます。
  • デフォルトでは、Snowflake ソースは null を空の文字列として解釈します。 null 値がAdobe Experience Platformで null 定されたとおりに正しく記述されていることを確認するには、Adobe担当者にお問い合わせください。
  • Experience Platformでデータを取り込むには、すべてのテーブルベースのバッチソースのタイムゾーンを UTC に設定する必要があります。 Snowflake ソースに対してサポートされているタイムスタンプは、UTC 時間を使用した TIMESTAMP_NTZ のみです。
WARNING
Snowflake ソースの基本認証(またはアカウントキー認証)は、2025 年 11 月に非推奨(廃止予定)になります。 ソースの使用とデータベースからExperience Platformへのデータの取り込みを続行するには、キーペアベースの認証に移行する必要があります。 非推奨(廃止予定)について詳しくは、Snowflake 資格情報の漏洩リスクの軽減に関するベストプラクティスガイドを参照してください。

Adobe Experience Platformを使用すると、データを外部ソースから取得しながら、Experience Platform サービスを使用して、受信データの構造化、ラベル付け、拡張を行うことができます。 アドビのアプリケーション、クラウドベースのストレージ、データベースなど、様々なソースからデータを取り込むことができます。

Experience Platform は、サードパーティのデータベースからデータを取得する機能を備えています。Experience Platformは、リレーショナル、NoSQL、データウェアハウスなど、様々なタイプのデータベースに接続できます。 データベースプロバイダーのサポートには、Snowflake が含まれます。

前提条件 prerequisites

この節では、Snowflake ソースをExperience Platformに接続する前に行う必要がある設定作業の概要を説明します。

アカウント識別子の取得 retrieve-your-account-identifier

アカウント ID を使用してExperience Platformで Snowflake インスタンスを認証するため、Snowflake UI ダッシュボードからアカウント ID を取得する必要があります。

アカウント識別子を取得するには:

  • Snowflake アプリケーション UI ダッシュボードでアカウントに移動します。
  • 左側のナビゲーションで「Accounts」を選択し、続いてヘッダーから「Active Accounts」を選択します。
  • 次に、情報アイコンを選択し、現在の URL のドメイン名を選択してコピーします。

ドメイン名が選択されたSnowflake UI ダッシュボード。

秘密鍵の取得 retrieve-your-private-key

Snowflake 接続でキーペア認証を使用している場合は、Experience Platformに接続する前に秘密鍵も生成する必要があります。

暗号化された秘密鍵の作成

暗号化された Snowflake 秘密鍵を生成するには、ターミナルで次のコマンドを実行します。

code language-shell
openssl genrsa 2048 | openssl pkcs8 -topk8 -v2 des3 -inform PEM -out rsa_key.p8

成功した場合は、PEM 形式の秘密鍵が届きます。

code language-shell
-----BEGIN ENCRYPTED PRIVATE KEY-----
MIIE6T...
-----END ENCRYPTED PRIVATE KEY-----
暗号化されていない秘密鍵の作成

暗号化されていない Snowflake 秘密鍵を生成するには、ターミナルで次のコマンドを実行します。

code language-shell
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

成功した場合は、PEM 形式の秘密鍵が届きます。

code language-shell
-----BEGIN PRIVATE KEY-----
MIIE6T...
-----END PRIVATE KEY-----

次に、秘密鍵を取得し、Base64 でエンコードします。 Snowflake 秘密鍵に対して変換や形式変換を行わないようにしてください。 さらに、秘密鍵を Base64 でエンコードする前に、秘密鍵の末尾に末尾の改行文字がないことを確認する必要があります。

設定の検証

Snowflake データのソース接続を作成する前に、次の設定も満たしていることを確認する必要があります。

  • 特定のユーザーに割り当てられるデフォルトのウェアハウスは、Experience Platformへの認証時に入力するウェアハウスと同じである必要があります。
  • 特定のユーザーに割り当てられたデフォルトのロールは、Experience Platformへの認証時に入力したのと同じデータベースにアクセスできる必要があります。

ロールとウェアハウスを検証するには:

  • 左側のナビゲーションで「Admin」を選択し、「Users & Roles」を選択します。
  • 適切なユーザーを選択し、右上隅にある省略記号(...)を選択します。
  • 表示される Edit user ウィンドウで、Default Role に移動し、特定のユーザーに関連付けられている役割を表示します。
  • 同じウィンドウで、Default Warehouse に移動し、特定のユーザーに関連付けられているウェアハウスを表示します。

ロールとウェアハウスを確認できるSnowflake UI。

正常にエンコードされると、Base64 でエンコードされた秘密鍵をExperience Platformで使用して Snowflake アカウントを認証できます。

IP アドレス許可リスト

ソースコネクタを操作する前に、IP アドレスのリストを許可リストに追加する必要があります。 地域固有の IP アドレスを許可リストに追加しないと、ソースを使用する際にエラーが発生したり、パフォーマンスが低下する場合があります。 詳しくは、IP アドレスの許可リストページを参照してください。

以下のドキュメントでは、API やユーザーインターフェイスを使用して Snowflake をExperience Platformに接続する方法について説明しています。

API を使用した Snowflake のExperience Platformへの接続

UI を使用した Snowflake のExperience Platformへの接続

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