Google BigQuery へのアクセスの設定

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 コネクタの一括読み込みを設定します
メモ

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

Google BigQuery(Windows 版)

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を再起動して、変更を反映します。

Google BigQuery(Linux)

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 Driver (.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. simba.googlebigqueryodbc.iniDriverManagerEncoding を UTF-16 に、SwapFilePath を に変更します。 必要に応じて、ログ設定を変更することもできます。

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

    # /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 ファイルを使用している場合は、Google BigQuery ドライバの場所 /opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb[Bitness].so を指すように /etc/odbcinst.ini を設定します。

    例:

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

このページ