Google BigQueryへのアクセスを設定する

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

  1. WindowsまたはLinuxにGoogle BigQueryを設定します
  2. Adobe Campaign ClassicでGoogle BigQuery 外部アカウントを設定します
  3. Google BigQueryコネクタの一括読み込みをWindowsまたはLinuxにセットアップします
メモ

Google BigQuery コネクタは、ハイブリッドおよびオンプレミスのデプロイメントで使用できます。詳しくは、こちらのページを参照してください。

Windows上のGoogle BigQuery

Windowsでのドライバの設定

  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での一括読み込みの設定

メモ

Google Cloud SDKを動作させるには、Pythonがインストールされている必要があります。

Python3を使用することをお勧めします。ページを参照してください。

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

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

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

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

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

    例:

  5. Adobe Campaign Classicを再起動して、変更を反映します。

LinuxのGoogle BigQuery

Linuxでのドライバの設定

  1. ODBCドライバーをインストールする前に、システムを更新する必要があります。 LinuxまたはCentOSで、次のコマンドを実行します。

    yum update
    # install unixODBC driver manager
    yum install unixODBC
    
  2. その後、次のコマンドを使用してunixODBCドライバーマネージャーをインストールする必要があります。

    # switch to root user
    sudo su
    

    Debianの場合:

    apt-get update
    apt-get upgrade
    # install unixODBC driver manager
    apt-get install unixODBC
    
  3. Magnitude Simba Linux ODBCドライバ(.tar.gz)をダウンロードします。 次に、tarballファイルをマシン上の一時フォルダーに転送するか、wgetコマンドを使用します。

    # in this example driver version is 2.3.1.1001
    wget https://storage.googleapis.com/simba-bq-release/odbc/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux.tar.gz
    
  4. メインのtarballファイルを次のように抽出します。 TarballName​は、ドライバを含むtarballパッケージの名前です。

    tar --directory=/tmp -zxvf [TarballName]
    
  5. 抽出したフォルダーにアクセスし、ドライバーのバージョンに対応する内部tarballファイルを抽出します。 次の例のBigQueryDriverにある別の一時フォルダーにインストールします。

    mkdir /tmp/BigQueryDriver/
    cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
    tar --directory=/tmp/BigQueryDriver/ -zxvf SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version].tar.gz
    
  6. メインのtarballファイルが抽出された一時的な場所にアクセスし、GoogleBigQueryODBC.didファイルとsetup/simba.googlebigqueryodbc.iniファイルを、前の手順で作成した新しいフォルダーにコピーします。

    cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
    cp GoogleBigQueryODBC.did /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/lib/
    cp setup/simba.googlebigqueryodbc.ini /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/lib/
    
  7. 次のように、インストールディレクトリを作成します。

    mkdir -p /opt/simba/googlebigqueryodbc/
    
  8. ディレクトリの内容を新しいインストールディレクトリにコピーします。

    cp -r /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/* /opt/simba/googlebigqueryodbc/
    
  9. インストールディレクトリのsimba.googlebigqueryodbc.ini<INSTALLDIR>/opt/simba/googlebigqueryodbcに置き換えます。

    cd /opt/simba/googlebigqueryodbc/lib/
    sed -i 's/<INSTALLDIR>/\/opt\/simba\/googlebigqueryodbc/g' simba.googlebigqueryodbc.ini
    
  10. DriverManagerEncodingをUTF-16に変更し、simba.googlebigqueryodbc.iniSwapFilePathを変更します。 必要に応じて、ログ設定を変更することもできます。

    次に、更新されたドライバ全体の設定ファイルの例を示します。

    # /opt/simba/googlebigqueryodbc/lib/simba.googlebigqueryodbc.ini
    [Driver]
    DriverManagerEncoding=UTF-16
    ErrorMessagesPath=opt/simba/googlebigqueryodbc/ErrorMessages
    LogLevel=6
    LogPath=/tmp
    SwapFilePath=/tmp
    
  11. システムドライバファイルまたは現在のodbcinst.iniファイルを使用している場合は、/etc/odbcinst.iniを設定して、Google BigQueryドライバの場所/opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb[Bitness].soを指すようにします。

    例:

    # /etc/odbcinst.ini
    # Make sure to use Simba ODBC Driver for Google BigQuery as a driver name.
    
    [ODBC Drivers]
    Simba ODBC Driver for Google BigQuery=Installed
    
    [Simba ODBC Driver for Google BigQuery]
    Description=Simba ODBC Driver for Google BigQuery(64-bit)
    Driver=/opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb64.so
    
  12. unixODBCドライバーマネージャーライブラリの場所を探し、 unixODBCgooglebigqueryodbcライブラリパスをLD_LIBRARY_PATH environment変数に追加します。

    find / -name 'lib*odbc*.so*' -print
    #output:
    /usr/lib/x86_64-linux-gnu/libodbccr.so.2
    /usr/lib/x86_64-linux-gnu/libodbcinst.so.2.0.0
    /usr/lib/x86_64-linux-gnu/libodbccr.so.1
    .
    .
    /opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb64.so
    
    #the command would look like this
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/simba/googlebigqueryodbc:/usr/lib
    
  13. Adobe Campaign Classicでは、Google BigQuery外部アカウントを設定できます。 外部アカウントの設定方法について詳しくは、この節を参照してください。

Linuxでの一括読み込みの設定

メモ

Google Cloud SDKを動作させるには、Pythonがインストールされている必要があります。

Python3を使用することをお勧めします。ページを参照してください。

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

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

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

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

  4. PATH変数の使用を避けたい場合や、google-cloud-sdkディレクトリを別の場所に移動する場合は、外部アカウント​を設定する際にbqpathオプション値を使用して、システム上のbinディレクトリの正確なパスを指定します。

  5. Adobe Campaign Classicを再起動して、変更を反映します。

Google BigQuery外部アカウント

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のドキュメントを参照してください。

このページ