Google BigQueryへのアクセスを設定する configure-fda-google-big-query

Adobe Campaign Classic Federated Data Access (FDA) オプションを使用して、外部データベースに保存されている情報を処理します。 Google BigQueryへのアクセスを設定するには、次の手順に従います。

  1. WindowsまたはLinuxでGoogle BigQueryを設定します
  2. Adobe Campaign ClassicでGoogle BigQuery 外部アカウント ​を設定します
  3. WindowsまたはLinuxでGoogle BigQuery コネクタの一括読み込みを設定
NOTE
Google BigQuery コネクタは、ホスト型、ハイブリッド型、オンプレミス型のデプロイメントに使用できます。 詳しくは、このページを参照してください。

Windows上のGoogle BigQuery google-windows

Windowsでのドライバのセットアップ driver-window

  1. Windows 用の ODBC ドライバーをダウンロードします。

  2. WindowsでODBC ドライバを設定します。 詳しくは、このページを参照してください。

  3. Google BigQuery コネクタを機能させるには、Adobe Campaign Classicに接続する次のパラメーターが必要です。

    • プロジェクト:既存のプロジェクトを作成または使用します。

      詳しくは、このページを参照してください。

    • サービスアカウント: サービスアカウントを作成します。

      詳しくは、このページを参照してください。

    • キーファイルパス: サービスアカウント​には、ODBCを介したGoogle BigQuery接続に​ キーファイル ​が必要です。

      詳しくは、このページを参照してください。

    • データセット: データセット​は、ODBC接続ではオプションです。 すべてのクエリでは、テーブルが配置されているデータセットを指定する必要があるため、データセット​を指定することは、Adobe Campaign ClassicのGoogle BigQueryFDA コネクタに必須です。

      詳しくは、このページを参照してください。

  4. 次に、Adobe Campaign ClassicでGoogle BigQuery外部アカウントを設定できます。 外部アカウントの設定方法について詳しくは、この節を参照してください。

Windowsでの一括読み込みの設定 bulk-load-window

NOTE
Google Cloud SDKを使用するには、Pythonがインストールされている必要があります。
Python3を使用することをお勧めします。この​ ページ ​を参照してください。

一括読み込みユーティリティを使用すると、Google Cloud SDKを介してより高速な転送が可能になります。

  1. この​ ページ ​からWindows 64 ビット (x86_64) アーカイブをダウンロードし、対応するディレクトリに展開します。

  2. google-cloud-sdk\install.sh スクリプトを実行します。 パス変数の設定を受け入れる必要があります。

  3. インストール後、パス変数...\google-cloud-sdk\binが設定されていることを確認します。 そうでない場合は、手動で追加します。

  4. ..\google-cloud-sdk\bin\bq.cmd ファイルで、CLOUDSDK_PYTHON ローカル変数を追加します。この変数は、Python インストールの場所にリダイレクトされます。

    例:

  5. Adobe Campaign Classicを再起動して、変更内容を考慮します。

Linux版Google BigQuery google-linux

Linuxでのドライバのセットアップ driver-linux

ドライバーを設定する前に、スクリプトとコマンドはルートユーザーが実行する必要があることに注意してください。 スクリプトの実行中にGoogle DNS 8.8.8.8を使用することをお勧めします。

LinuxでGoogle BigQueryを設定するには、次の手順に従います。

  1. ODBC インストールの前に、Linux ディストリビューションに次のパッケージがインストールされていることを確認します。

    • Red Hat/CentOS:

      code language-none
      yum update
      yum upgrade
      yum install -y grep sed tar wget perl curl
      
    • Debianの場合:

      code language-none
      apt-get update
      apt-get upgrade
      apt-get install -y grep sed tar wget perl curl
      
  2. インストール前にシステムを更新します。

    • Red Hat/CentOS:

      code language-none
      # install unixODBC driver manager
      yum install -y unixODBC
      
    • Debianの場合:

      code language-none
      # install unixODBC driver manager
      apt-get install -y odbcinst1debian2 libodbc1 odbcinst unixodbc
      
  3. スクリプトを実行する前に、—help引数を指定して詳細情報を取得できます。

    code language-none
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
    ./bigquery_odbc-setup.sh --help
    
  4. スクリプトが存在するディレクトリにアクセスし、ルートユーザーとして次のスクリプトを実行します。

    code language-none
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
    ./bigquery_odbc-setup.sh
    

Linuxでの一括読み込みの設定 bulk-load-linux

NOTE
Google Cloud SDKを使用するには、Pythonがインストールされている必要があります。
Python3を使用することをお勧めします。この​ ページ ​を参照してください。

一括読み込みユーティリティを使用すると、Google Cloud SDKを介してより高速な転送が可能になります。

  1. ODBC インストールの前に、Linux ディストリビューションに次のパッケージがインストールされていることを確認します。

    • Red Hat/CentOS:

      code language-none
      yum update
      yum upgrade
      yum install -y python3
      
    • Debianの場合:

      code language-none
      apt-get update
      apt-get upgrade
      apt-get install -y python3
      
  2. スクリプトが存在するディレクトリにアクセスし、次のスクリプトを実行します。

    code language-none
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
    ./bigquery_sdk-setup.sh
    

Google BigQuery外部アカウント google-external

Adobe Campaign Classic インスタンスをGoogle BigQuery外部データベースに接続するには、Google BigQuery外部アカウントを作成する必要があります。

  1. Adobe Campaign Classic Explorer​から、管理 ‘>’ Platform ‘>’ 外部アカウント​をクリックします。

  2. 新規」をクリックします。

  3. 外部アカウント​ タイプ ​として、「外部データベース」を選択します。

  4. Google BigQuery 外部アカウントを設定するには、次を指定する必要があります。

    • タイプ:Google BigQuery

    • サービスアカウント: サービスアカウント​の電子メール。 詳しくは、Google Cloud ドキュメント ​を参照してください。

    • プロジェクト: プロジェクト​の名前。 詳しくは、Google Cloud ドキュメント ​を参照してください。

    • キーファイルのパス:

      • キーファイルをサーバーにアップロード:「ここをクリックしてアップロード」を選択すると、Adobe Campaign Classicからキーをアップロードできます。

      • キーファイルパスを手動で入力:既存のキーを使用する場合は、このフィールドに絶対パスをコピーまたは貼り付けます。

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

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

オプション
説明
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 Array Insert一括読み込みメカニズムの使用に戻ります。
recommendation-more-help
campaign-classic-help