設定Google BigQuery的存取權

使用Adobe Campaign Classic 同盟資料存取(FDA)選項來處理儲存在外部資料庫中的資訊。 請依照以下步驟配置Google BigQuery的訪問。

  1. WindowsLinux上配置Google BigQuery
  2. 在Adobe Campaign Classic中設定Google BigQuery 外部帳戶
  3. WindowsLinux上設定Google BigQuery連接器大量負載
注意

Google BigQuery 連接器適用於混合部署和內部部署。如需詳細資訊,請參閱此頁面

在Windows上使用Google BigQuery

在Windows上設定的驅動程式

  1. 下載Windows🔗的ODBC驅動程式。

  2. 在Windows中配置ODBC驅動程式。 如需詳細資訊,請參閱此頁面

  3. 為了讓Google BigQuery連接器正常運作,Adobe Campaign Classic需要下列參數才能連線:

    • Project:建立或使用現有專案。

      如需詳細資訊,請參閱此page

    • Service account:建立服務帳戶。

      如需詳細資訊,請參閱此page

    • Key File Path:需 Service account 要通過 Key File ODBC連 Google BigQuery 接的。

      如需詳細資訊,請參閱此page

    • Dataset: Dataset 對於ODBC連接是可選的。由於每個查詢都必須提供表格所在的資料集,因此在Adobe Campaign Classic中,指定​Dataset​是Google BigQuery FDA Connector的必要項目。

      如需詳細資訊,請參閱此page

  4. 在Adobe Campaign Classic中,您接著可以設定Google BigQuery外部帳戶。 有關如何配置外部帳戶的詳細資訊,請參閱此部分

在Windows上設定大量載入

注意

您需要安裝Python才能使Google Cloud SDK正常運作。

建議使用Python3,請參見此page

大量載入公用程式可讓傳輸更快,這是透過Google Cloud SDK達成。

  1. 從此page下載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

在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)。 然後,將目標檔案傳輸到電腦上的臨時資料夾,或使用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. 按如下方式提取主目標檔案,其中​TarballName​是包含驅動程式的目標包的名稱:

    tar --directory=/tmp -zxvf [TarballName]
    
  5. 訪問您提取的資料夾並提取與驅動程式版本對應的內部目標檔案。 在以下示例BigQueryDriver中,將其安裝到另一個臨時資料夾中:

    mkdir /tmp/BigQueryDriver/
    cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
    tar --directory=/tmp/BigQueryDriver/ -zxvf SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version].tar.gz
    
  6. 訪問提取主目標檔案的臨時位置,並將GoogleBigQueryODBC.didsetup/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變更為simba.googlebigqueryodbc.ini中的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檔案,請配置/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上設定的大量載入

注意

您需要安裝Python才能使Google Cloud SDK正常運作。

建議使用Python3,請參見此page

大量載入公用程式可讓傳輸更快,這是透過Google Cloud SDK達成。

  1. 下載此page中的Linux 64位(x86_64)歸檔檔案,並在相應目錄中提取。

  2. 運行google-cloud-sdk\install.sh指令碼。 您必須接受路徑變數的設定。

  3. 安裝後,請檢查路徑變數...\google-cloud-sdk\bin是否已設定。 否則請手動新增。

  4. 如果您不想使用PATH變數,或想要將google-cloud-sdk目錄移至其他位置,請在配置​External account​時使用bqpath選項值,指定系統上bin目錄的確切路徑。

  5. 重新啟動Adobe Campaign Classic,以便考慮變更。

Google BigQuery外部帳戶

您需要建立Google BigQuery外部帳戶,將您的Adobe Campaign Classic執行個體連接至Google BigQuery外部資料庫。

  1. 在Adobe Campaign Classic Explorer​中,按一下「Administration 」>「 Platform 」>「 External accounts」。

  2. 按一下​New

  3. 選擇​External database​作為外部帳戶的​Type

  4. 配置Google BigQuery外部帳戶,必須指定:

    • Type: Google BigQuery

    • Service account:您的電子郵件 Service account。如需詳細資訊,請參閱Google雲端檔案

    • Project:您的名 Project​稱。如需詳細資訊,請參閱Google雲端檔案

    • Key file Path:

      • Upload key file to the server:如果 Click here to upload 您選擇透過Adobe Campaign Classic上傳金鑰,請選取「 」。

      • Enter manually the key file path:如果您選擇使用預先存在的索引鍵,請在此欄位中複製/貼上絕對路徑。

    • Dataset:您的名 Dataset​稱。如需詳細資訊,請參閱Google雲端檔案

本頁內容