配置对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:创建或使用现有项目。

      有关详细信息,请参见此页面

    • Service account:创建服务帐户。

      有关详细信息,请参见此页面

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

      有关详细信息,请参见此页面

    • Dataset: Dataset 对于ODBC连接而言,它是可选项。由于每个查询都需要提供表所在的数据集,因此必须为Adobe Campaign Classic中的Google BigQuery FDA连接器指定​Dataset

      有关详细信息,请参见此页面

  4. 然后,在Adobe Campaign Classic中,您可以配置Google BigQuery外部帐户。 有关如何配置外部帐户的更多信息,请参阅此部分

在Windows上设置批量加载

注意

您需要安装Python才能使Google Cloud SDK正常工作。

我们建议使用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

在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. simba.googlebigqueryodbc.ini中将DriverManagerEncoding更改为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,请参阅此页面

批量加载实用程序允许更快地传输,这可通过Google Cloud SDK实现。

  1. 在此页面中下载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 Cloud文档

    • Project:您的名 Project​称。有关此内容的更多信息,请参阅Google Cloud文档

    • 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 Cloud文档

在此页面上