ドキュメントExperience Platform 連合オーディエンス構成

連合データベースの設定 federated-db

Last update: Wed Nov 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Experience Platform 連合オーディエンス構成を使用すると、お客様はサードパーティのデータウェアハウスからオーディエンスを作成して強化し、このオーディエンスを Adobe Experience Platform に読み込むことができます。

外部データベースへの接続を作成、設定、テストおよび保存する方法について詳しくは、このページを参照してください。サポートされているデータベースのリストと、それぞれのデータベースに対して設定する詳細な設定を以下に示します。

サポートされているデータベース supported-db

連合オーディエンス構成を使用すると、次のデータベースに接続できます。各データベースの設定について詳しくは、以下を参照してください。

Amazon Redshift amazon-redshift

連合データベースを使用して、外部データベースに保存されている情報を処理します。Amazon Redshift へのアクセスを設定するには、次の手順に従います。

  1. 連合データ ​メニューで、「連合データベース」を選択します。

  2. 「連合データベースを追加」をクリックします。

  3. 連合データベースに​ 名前 ​を入力します。

  4. タイプ ​ドロップダウンから、「Amazon Redshift」を選択します。

  5. Amazon Redshift の認証設定を指定します。

    • サーバー：DNS の名前を追加します。

    • アカウント：ユーザー名を追加します。

    • パスワード：アカウントのパスワードを追加します。

    • データベース：DSN で指定されていない場合のデータベースの名前。DSN で指定した場合は、空のままにできます

    • 作業スキーマ：作業用テーブルに使用するデータベーススキーマの名前。詳しくは、Amazon ドキュメントを参照してください。

      note note
      NOTE
      このスキーマへの接続に必要な権限がある限り、一時的なデータ処理に使用するスキーマを含む、データベースの任意のスキーマを使用できます。
      複数のサンドボックスを同じデータベースに接続する際は、異なる作業スキーマ ​を使用する必要があります。

  6. 「接続をテスト」オプションを選択して、設定を検証します。

  7. 「関数をデプロイ」ボタンをクリックして、関数を作成します。

  8. 設定が完了したら、「追加」をクリックして、連合データベースを作成します。

Azure Synapse Analytics azure-synapse

連合データベースを使用して、外部データベースに保存されている情報を処理します。Azure Synapse Analytics へのアクセスを設定するには、次の手順に従います。

  1. 連合データ ​メニューで、「連合データベース」を選択します。

  2. 「連合データベースを追加」をクリックします。

  3. 連合データベースに​ 名前 ​を入力します。

  4. タイプ ​ドロップダウンから、「Azure Synapse Analytics」を選択します。

  5. Azure Synapse Analytics の認証設定を指定します。

    • サーバー：Azure Synapse サーバーの URL を入力します。

    • アカウント：ユーザー名を入力します。

    • パスワード：アカウントのパスワードを入力します。

    • データベース（オプション）：DSN で指定されていない場合は、データベースの名前を入力します。

    • オプション：コネクタは、以下の表で説明するオプションをサポートします。

  6. 「接続をテスト」オプションを選択して、設定を検証します。

  7. 「関数をデプロイ」ボタンをクリックして、関数を作成します。

  8. 設定が完了したら、「追加」をクリックして、連合データベースを作成します。

オプション
説明
認証
コネクタでサポートされている認証のタイプ。現在サポートされている値：ActiveDirectoryMSI。詳しくは、Microsoft SQL ドキュメント（接続文字列 n°8 の例）を参照してください

Google BigQuery google-big-query

連合データベースを使用して、外部データベースに保存されている情報を処理します。Google BigQuery へのアクセスを設定するには、次の手順に従います。

  1. 連合データ ​メニューで、「連合データベース」を選択します。

  2. 「連合データベースを追加」をクリックします。

  3. 連合データベースに​ 名前 ​を入力します。

  4. タイプ ​ドロップダウンから、「Google BigQuery」を選択します。

  5. Google BigQuery の認証設定を指定します。

    • サービスアカウント：サービスアカウント ​のメールアドレスを入力します。詳しくは、Google Cloud ドキュメントを参照してください。

    • プロジェクト：プロジェクト ​の ID を入力します。詳しくは、Google Cloud ドキュメントを参照してください。

    • データセット：データセット ​の名前を入力します。詳しくは、Google Cloud ドキュメントを参照してください。

    • キーファイルパス：キーファイルをサーバーにアップロードします。.json ファイルのみが使用できます。

    • オプション：コネクタは、以下の表で説明するオプションをサポートします。

  6. 「接続をテスト」オプションを選択して、設定を検証します。

  7. 「関数をデプロイ」ボタンをクリックして、関数を作成します。

  8. 設定が完了したら、「追加」をクリックして、連合データベースを作成します。

オプション
説明
ProxyType
ODBC および SDK コネクタ経由で BigQuery への接続に使用されるプロキシのタイプです。
HTTP（デフォルト）、http_no_tunnel、socks4 および socks5 が現在サポートされています。
ProxyHost
プロキシにアクセスできるホスト名または IP アドレスです。
ProxyPort
プロキシが実行されているポート番号（例：8080）です
ProxyUid
認証済みプロキシに使用するユーザー名
ProxyPwd
ProxyUid パスワード
bqpath
これは、一括読み込みツール（Cloud SDK）にのみ適用されます。
PATH 変数の使用を避ける場合や、google-cloud-sdk ディレクトリを別の場所に移動する必要がある場合は、このオプションを使用して、サーバー上の cloud sdk bin ディレクトリへの正確なパスを指定できます。
GCloudConfigName
これは、リリース 7.3.4 以降に適用され、一括読み込みツール（Cloud SDK）にのみ適用されます。
Google Cloud SDK は、設定を使用して、データを BigQuery テーブルに読み込みます。accfda という名前の設定は、データを読み込むパラメーターを格納します。ただし、このオプションを使用すると、ユーザーは設定に別の名前を指定できます。
GCloudDefaultConfigName
これは、リリース 7.3.4 以降に適用され、一括読み込みツール（Cloud SDK）にのみ適用されます。
アクティブな Google Cloud SDK 設定は、最初にアクティブなタグを新しい設定に転送しないと、削除できません。データを読み込む主な設定を再作成するには、この一時的な設定が必要です。一時設定のデフォルト名は default です。これは必要に応じて変更できます。
GCloudRecreateConfig
これは、リリース 7.3.4 以降に適用され、一括読み込みツール（Cloud SDK）にのみ適用されます。
false に設定すると、一括読み込みメカニズムは、Google Cloud SDK 設定の再作成、削除、変更を試みません。代わりに、マシン上の既存の設定を使用してデータの読み込みを続行します。この機能は、他の操作が Google Cloud SDK 設定に依存している場合に役立ちます。
適切な設定を行わないで、このエンジンオプションを有効にすると、一括読み込みメカニズムは警告メッセージ No active configuration found. Please either create it manually or remove the GCloudRecreateConfig option を表示します。これ以上のエラーを防ぐには、デフォルトの ODBC 配列の挿入一括読み込みメカニズムの使用に戻ります。

Snowflake snowflake

NOTE
プライベートリンクを介した外部 Snowflake データウェアハウスへの安全なアクセスがサポートされています。Snowflake アカウントは、Amazon Web Services（AWS）でホストされ、連合オーディエンス構成環境と同じ地域に配置されている必要があります。Snowflake アカウントへの安全なアクセスの設定について詳しくは、アドビ担当者にお問い合わせください。

連合データベースを使用して、外部データベースに保存されている情報を処理します。Snowflake へのアクセスを設定するには、次の手順に従います。

  1. 連合データ ​メニューで、「連合データベース」を選択します。

  2. 「連合データベースを追加」をクリックします。

  3. 連合データベースに​ 名前 ​を入力します。

  4. タイプ ​ドロップダウンから、「Snowflake」を選択します。

  5. Snowflake の認証設定を指定します。

    • サーバー：サーバー名を入力します。

    • ユーザー：ユーザー名を入力します。

    • パスワード：アカウントのパスワードを入力します。

    • データベース（オプション）：DSN で指定されていない場合は、データベースの名前を入力します。

    • 作業スキーマ（オプション）：作業用テーブルに使用するデータベーススキーマの名前を入力します。

      note note
      NOTE
      このスキーマへの接続に必要な権限がある限り、一時的なデータ処理に使用するスキーマを含む、データベースの任意のスキーマを使用できます。
      複数のサンドボックスを同じデータベースに接続する際は、異なる作業スキーマ ​を使用する必要があります。

    • 秘密鍵：「秘密鍵」フィールドをクリックして、ロケールフォルダーから .pem ファイルを選択します。

    • オプション：コネクタは、以下の表で説明するオプションをサポートします。

  6. 「接続をテスト」オプションを選択して、設定を検証します。

  7. 「関数をデプロイ」ボタンをクリックして、関数を作成します。

  8. 設定が完了したら、「追加」をクリックして、連合データベースを作成します。

コネクタは、次のオプションをサポートしています。

オプション
説明
workschema
ワークテーブルに使用するデータベーススキーマ
warehouse
使用するデフォルトのウェアハウスの名前。ユーザーのデフォルト値より優先されます。
TimeZoneName
デフォルトでは空で、アプリサーバーのシステムのタイムゾーンが使用されます。このオプションは、TIMEZONE セッションパラメーターを強制的に指定するために使用できます。
詳しくは、このページを参照してください{target=“_blank”}。
WeekStart
WEEK_START セッションパラメーター。デフォルトでは 0 に設定されています。
詳しくは、このページを参照してください{target=“_blank”}。
UseCachedResult
USE_CACHED_RESULTS セッションパラメーター。デフォルトでは TRUE に設定されています。このオプションは、Snowflake がキャッシュした結果を無効にする際に使用できます。
詳しくは、このページを参照してください{target=“_blank”}。
bulkThreads
Snowflake バルクローダーに使用するスレッドの数。スレッドが多いほど、大きな一括読み込みのパフォーマンスが向上します。デフォルトでは 1 に設定されています。この数は、マシンスレッド数に応じて調整できます。
chunkSize
バルクローダーチャンクのファイルサイズを決定します。デフォルトでは 128 MB に設定されています。bulkThreads と共に使用する場合は、より最適なパフォーマンスが得られるように変更できます。同時にアクティブなスレッドが多いほど、パフォーマンスが向上します。
詳しくは、Snowflake ドキュメントを参照してください{target=“_blank”}。
StageName
事前プロビジョニングされた内部ステージの名前です。新しい一時ステージを作成する代わりに、一括読み込みで使用されます。

Vertica Analytics vertica-analytics

連合データベースを使用して、外部データベースに保存されている情報を処理します。Vertica Analytics へのアクセスを設定するには、次の手順に従います。

  1. 連合データ ​メニューで、「連合データベース」を選択します。

  2. 「連合データベースを追加」をクリックします。

  3. 連合データベースに​ 名前 ​を入力します。

  4. タイプ ​ドロップダウンから、「Vertica Analytics」を選択します。

  5. Vertica Analytics の認証設定を指定します。

    • サーバー：Vertica Analytics サーバーの URL を追加します。

    • アカウント：ユーザー名を追加します。

    • パスワード：アカウントのパスワードを追加します。

    • データベース（オプション）：DSN で指定されていない場合は、データベースの名前を入力します。

    • 作業スキーマ（オプション）：作業用テーブルに使用するデータベーススキーマの名前を入力します。

      note note
      NOTE
      このスキーマへの接続に必要な権限がある限り、一時的なデータ処理に使用するスキーマを含む、データベースの任意のスキーマを使用できます。
      複数のサンドボックスを同じデータベースに接続する際は、異なる作業スキーマ ​を使用する必要があります。

    • オプション：コネクタは、以下の表で説明するオプションをサポートします。

  6. 「接続をテスト」オプションを選択して、設定を検証します。

  7. 「関数をデプロイ」ボタンをクリックして、関数を作成します。

  8. 設定が完了したら、「追加」をクリックして、連合データベースを作成します。

コネクターは、次のオプションをサポートしています。

オプション
説明
TimeZoneName
デフォルトでは空で、アプリサーバーのシステムのタイムゾーンが使用されます。このオプションは、TIMEZONE セッションパラメーターを強制的に指定するために使用できます。

Databricks databricks

連合データベースを使用して、外部データベースに保存されている情報を処理します。Databricks へのアクセスを設定するには、次の手順に従います。

  1. 連合データ ​メニューで、「連合データベース」を選択します。

  2. 「連合データベースを追加」をクリックします。

  3. 連合データベースに​ 名前 ​を入力します。

  4. タイプ ​ドロップダウンから、「Databricks」を選択します。

  5. Databricks の認証設定を指定します。

    • サーバー：Databricks サーバーの名前を追加します。

    • HTTP パス：クラスターまたはウェアハウスへのパスを追加します。詳細情報

    • パスワード：アカウントのアクセストークンを追加します。詳細情報

    • カタログ：Databricks カタログのフィールドを追加します。

    • 作業スキーマ：作業用テーブルに使用するデータベーススキーマの名前。

      note note
      NOTE
      このスキーマへの接続に必要な権限がある限り、一時的なデータ処理に使用するスキーマを含む、データベースの任意のスキーマを使用できます。
      複数のサンドボックスを同じデータベースに接続する際は、異なる作業スキーマ ​を使用する必要があります。

    • オプション：コネクタは、以下の表で説明するオプションをサポートします。

  6. 「接続をテスト」オプションを選択して、設定を検証します。

  7. 「関数をデプロイ」ボタンをクリックして、関数を作成します。

  8. 設定が完了したら、「追加」をクリックして、連合データベースを作成します。

コネクタは、次のオプションをサポートしています。

オプション
説明
TimeZoneName
デフォルトでは空で、アプリサーバーのシステムのタイムゾーンが使用されます。このオプションは、TIMEZONE セッションパラメーターを強制的に指定するために使用できます。
recommendation-more-help
fadff0d9-29d0-4d44-99a6-2499b0b7778b