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の FDA コネクタでは データセット の指定 Google BigQuery 必須です。

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

  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 ファイルに、Python インストールの場所にリダイレクトする CLOUDSDK_PYTHON ローカル変数を追加します。

    例:

  5. 変更内容を反映するには、Adobe Campaign Classicを再起動します。

Linux 上のGoogle BigQuery google-linux

Linux で設定されたドライバ driver-linux

ドライバを設定する前に、スクリプトとコマンドは root ユーザーが実行する必要があることに注意してください。 スクリプトの実行中に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 エクスプローラー で、管理 '>' プラットフォーム '>' 外部アカウント をクリックします。

  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 配列の挿入バルクロードメカニズムを使用して、に戻ります。
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1