[Ultimate]{class="badge positive"}

UI での Snowflake ソース接続の作成

Last update: Mon Sep 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

IMPORTANT

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

このチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用して Snowflake ソースコネクタを作成する手順を説明します。

はじめに

このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

ソース：Experience Platform を使用すると、データを様々なソースから取得しながら、Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
サンドボックス：Experience Platform には、単一の Platform インスタンスを別々の仮想環境に分割して、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。

必要な資格情報の収集

Snowflake ソースを認証するには、次の資格情報プロパティの値を指定する必要があります。

アカウントキー認証

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
資格情報	説明
アカウント	アカウント名は、組織内のアカウントを一意に識別します。この場合、アカウントを異なる Snowflake 組織で一意に識別する必要があります。これを行うには、アカウント名の前に組織名を追加する必要があります。例：`orgname-account_name`。詳しくは、アカウント識別子の取得に関するガイドを参 Snowflake してください。詳しくは、Snowflake ドキュメントを参照してください。
ウェアハウス	Snowflake ウェアハウスは、アプリケーションのクエリ実行プロセスを管理します。各 Snowflake ウェアハウスは互いに独立しており、データを Platform に取り込む際は個別にアクセスする必要があります。
データベース	Snowflake データベースには、Platform に取り込むデータが含まれています。
ユーザー名	Snowflake アカウントのユーザー名。
パスワード	Snowflake ユーザーアカウントのパスワード。
役割	Snowflake セッションで使用する既定のアクセス制御ロールです。役割は、指定したユーザーに既に割り当てられている既存の役割である必要があります。デフォルトの役割は `PUBLIC` です。
接続文字列	Snowflake インスタンスへの接続に使用する接続文字列。 Snowflake の接続文字列パターンは `jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}` です

キーペア認証

キーペア認証を使用するには、Snowflake ソースのアカウントを作成する際に、2048 ビットの RSA キーペアを生成してから、次の値を指定する必要があります。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
資格情報	説明
アカウント	アカウント名は、組織内のアカウントを一意に識別します。この場合、アカウントを異なる Snowflake 組織で一意に識別する必要があります。これを行うには、アカウント名の前に組織名を追加する必要があります。例：`orgname-account_name`。詳しくは、アカウント識別子の取得に関するガイドを参 Snowflake してください。詳しくは、Snowflake ドキュメントを参照してください。
ユーザー名	Snowflake アカウントのユーザー名。
秘密鍵	Snowflake アカウントの Base64- エンコードされた秘密鍵。暗号化された秘密鍵または暗号化されていない秘密鍵のいずれかを生成できます。暗号化された秘密鍵を使用している場合は、Experience Platformに対する認証の際に、秘密鍵のパスフレーズも指定する必要があります。詳しくは、秘密鍵の取得に関す Snowflake ガイドを参照してください。
秘密鍵のパスフレーズ	秘密鍵のパスフレーズは、暗号化された秘密鍵を使用して認証を行う場合に使用する必要がある、追加のセキュリティレイヤーです。暗号化されていない秘密鍵を使用している場合は、パスフレーズを指定する必要はありません。
データベース	Experience Platformに取り込むデータを含む Snowflake データベース。
ウェアハウス	Snowflake ウェアハウスは、アプリケーションのクエリ実行プロセスを管理します。各 Snowflake ウェアハウスは互いに独立しており、データを Platform に取り込む際は個別にアクセスする必要があります。

これらの値について詳しくは、このSnowflakeドキュメントを参照してください。

NOTE

Snowflake データベースからデータをExperience Platformにアンロードできるようにするには、PREVENT_UNLOAD_TO_INLINE_URL フラグを FALSE に設定する必要があります。

Snowflakeアカウントを接続

Platform の UI で、左側のナビゲーションから Sources を選択し、Sources ワークスペースにアクセスします。

画面の左側にあるカタログから適切なカテゴリを選択することができます。または、検索バーを使用して、利用したい特定のソースを見つけることもできます。

データベースカテゴリで、「Snowflake」を選択し 「データを追加」を選択します。

Snowflake がハイライト表示されているソースカタログ

Snowflakeに接続 ページが表示されます。このページでは、新しい資格情報または既存の資格情報を使用できます。

既存のアカウント

既存のアカウントを使用するには、接続する Snowflake アカウントを選択し、「次へ」を選択して続行します。

ソースワークフローの既存のアカウントインターフェイス。

新規アカウント

新しいアカウントを作成するには、「新しいアカウント」を選択し、新しい Snowflake アカウントの名前と説明（オプション）を入力します。

ソースワークフローの新しいアカウントインターフェイス

アカウントキー認証

アカウントキー認証を使用するには、入力フォームに接続文字列を入力し、「ソースに接続」を選択します。

アカウントキー認証インターフェイス

キーペア認証

キーペア認証を使用するには、アカウント、ユーザー名、秘密鍵、秘密鍵のパスフレーズ、データベースおよびウェアハウスの値を指定し、「ソースに接続」を選択します。

アカウントキーペア認証インターフェイス

サンプルデータのプレビューをスキップ skip-preview-of-sample-data

データ選択手順で、大きなテーブルまたはファイルのデータを取り込む際にタイムアウトが発生することがあります。データプレビューをスキップして、タイムアウトを回避し、サンプルデータがなくてもスキーマを表示できます。データのプレビューをスキップするには、「サンプルデータのプレビューをスキップ 切替スイッチを有効 します。

残りのワークフローは変わりません。唯一の注意点は、データのプレビューをスキップすると、マッピングステップ中に計算フィールドと必須フィールドが自動検証されない可能性があり、マッピング中にこれらのフィールドを手動で検証する必要があるということです。

次の手順

このチュートリアルでは、Snowflakeアカウントとの接続を確立しました。次のチュートリアルに進み、データをに取り込むためのデータフローの設定 Platform を行いましょう。

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089