Configuración del acceso a Google BigQuery

Utilice la opción Adobe Campaign Classic Federated Data Access (FDA) para procesar la información almacenada en una base de datos externa. Siga los pasos a continuación para configurar el acceso a Google BigQuery.

1. Configurar Google BigQuery en Windows o Linux
2. Configure la Google BigQuery cuenta externa en Adobe Campaign Classic
3. Configurar la carga masiva del conector Google BigQuery en Windows o Linux

Google BigQuery en Windows

Controlador configurado en Windows

1. Descargue el controlador ODBC para Windows.

2. Configure el controlador ODBC en Windows. Para obtener más información, consulte esta página.

3. Para que funcione el conector Google BigQuery, Adobe Campaign Classic requiere los siguientes parámetros para conectarse:

   • Project: cree o use un proyecto existente.

     Para obtener más información, consulte esta página.

   • Service account: cree una cuenta de servicio.

     Para obtener más información, consulte esta página.

   • Key File Path: el Service account requiere un Key File para una Google BigQuery conexión a través de ODBC.

     Para obtener más información, consulte esta página.

   • Dataset: Dataset es opcional para una conexión ODBC. Dado que cada consulta debe proporcionar el conjunto de datos donde se encuentra la tabla, la especificación de Dataset es obligatoria para el conector Google BigQuery FDA en Adobe Campaign Classic.

     Para obtener más información, consulte esta página.

4. En Adobe Campaign Classic, puede configurar la cuenta externa Google BigQuery . Para obtener más información sobre cómo configurar la cuenta externa, consulte esta sección.

Carga masiva configurada en Windows

La utilidad de carga masiva permite una transferencia más rápida, que se logra mediante el SDK de Google Cloud.

1. Descargue el archivo de 64 bits (x86_64) de Windows de esta página y extráigalo en el directorio correspondiente.

2. Ejecute el script google-cloud-sdk\install.sh. Debe aceptar la configuración de la variable de ruta.

3. Después de la instalación, compruebe que la variable de ruta ...\google-cloud-sdk\bin esté configurada. Si no es así, agréguelo manualmente.

4. En el archivo ..\google-cloud-sdk\bin\bq.cmd, añada la variable local CLOUDSDK_PYTHON , que redirigirá a la ubicación de la instalación de Python.

   Por ejemplo:

   

5. Reinicie Adobe Campaign Classic para que se tengan en cuenta los cambios.

Google BigQuery en Linux

Configuración del controlador en Linux

1. Antes de instalar el controlador ODBC, debe actualizar el sistema. En Linux o CentOS, ejecute el siguiente comando:

   yum update
   # install unixODBC driver manager
   yum install unixODBC
   

2. A continuación, debe instalar el administrador de controladores unixODBC con el siguiente comando:

   # switch to root user
   sudo su
   

   En Debian:

   apt-get update
   apt-get upgrade
   # install unixODBC driver manager
   apt-get install unixODBC
   

3. Descargue el Controlador ODBC de Simba Linux de Magnitude (.tar.gz). A continuación, transfiera el archivo tarball a una carpeta temporal de su equipo o utilice el comando 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. Extraiga el archivo tarball principal como se indica a continuación, donde TarballName es el nombre del paquete tarball que contiene el controlador:

   tar --directory=/tmp -zxvf [TarballName]
   

5. Acceda a la carpeta extraída y extraiga el archivo de tarball interno correspondiente a la versión del controlador. Instálelo en otra carpeta temporal, en el siguiente ejemplo BigQueryDriver:

   mkdir /tmp/BigQueryDriver/
   cd /tmp/SimbaODBCDriverforGoogleBigQuery_[Version]-Linux/
   tar --directory=/tmp/BigQueryDriver/ -zxvf SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version].tar.gz
   

6. Acceda a la ubicación temporal donde se extrajo el archivo .tarball principal y copie los archivos GoogleBigQueryODBC.did y setup/simba.googlebigqueryodbc.ini en la nueva carpeta creada en el paso anterior:

   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. Cree el directorio de instalación de la siguiente manera:

   mkdir -p /opt/simba/googlebigqueryodbc/
   

8. Copie el contenido del directorio en el nuevo directorio de instalación:

   cp -r /tmp/BigQueryDriver/SimbaODBCDriverforGoogleBigQuery[Bitness]_[Version]/* /opt/simba/googlebigqueryodbc/
   

9. Sustituya <INSTALLDIR> por /opt/simba/googlebigqueryodbc en simba.googlebigqueryodbc.ini en el directorio de instalación:

   cd /opt/simba/googlebigqueryodbc/lib/
   sed -i 's/<INSTALLDIR>/\/opt\/simba\/googlebigqueryodbc/g' simba.googlebigqueryodbc.ini
   

10. Cambie DriverManagerEncoding a UTF-16 y SwapFilePath en simba.googlebigqueryodbc.ini. Si es necesario, también puede cambiar la configuración de registro.

    El siguiente es un ejemplo de archivo de configuración actualizado en todo el controlador:

    # /opt/simba/googlebigqueryodbc/lib/simba.googlebigqueryodbc.ini
    [Driver]
    DriverManagerEncoding=UTF-16
    ErrorMessagesPath=opt/simba/googlebigqueryodbc/ErrorMessages
    LogLevel=6
    LogPath=/tmp
    SwapFilePath=/tmp
    

11. Si está utilizando un archivo de controladores del sistema o cualquier archivo odbcinst.ini actual, configure /etc/odbcinst.ini para que apunte a la ubicación del controlador de Google BigQuery /opt/simba/googlebigqueryodbc/lib/libgooglebigqueryodbc_sb[Bitness].so.

    Por ejemplo:

    # /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. Busque la ubicación de las bibliotecas del administrador de controladores unixODBC y añada las rutas de biblioteca unixODBC y googlebigqueryodbc a la variable 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. En Adobe Campaign Classic, puede configurar la cuenta externa Google BigQuery . Para obtener más información sobre cómo configurar la cuenta externa, consulte esta sección.

Carga masiva configurada en Linux

La utilidad de carga masiva permite una transferencia más rápida, que se logra mediante el SDK de Google Cloud.

1. Descargue el archivo Linux de 64 bits (x86_64) en esta página y extraiga en el directorio correspondiente.

2. Ejecute el script google-cloud-sdk\install.sh. Debe aceptar la configuración de la variable de ruta.

3. Después de la instalación, compruebe que la variable de ruta ...\google-cloud-sdk\bin esté configurada. Si no es así, agréguelo manualmente.

4. Si desea evitar utilizar la variable PATH o si desea mover el directorio google-cloud-sdk a otra ubicación, utilice el valor de opción bqpath al configurar la External account para especificar la ruta exacta al directorio bin de su sistema.

5. Reinicie Adobe Campaign Classic para que se tengan en cuenta los cambios.

Cuenta externa de Google BigQuery

Debe crear una cuenta externa Google BigQuery para conectar la instancia de Adobe Campaign Classic a la base de datos externa Google BigQuery.

1. En Adobe Campaign Classic Explorer, haga clic en Administration '>' Platform '>' External accounts.

2. Haga clic en New.

3. Seleccione External database como Type de su cuenta externa.

4. Configure la cuenta externa Google BigQuery. Debe especificar:

   • Type: Google BigQuery

   • Service account: Correo electrónico de su Service account. Para obtener más información, consulte Documentación de Google Cloud.

   • Project: Nombre de su Project. Para obtener más información, consulte Documentación de Google Cloud.

   • Key file Path:

     • Upload key file to the server: seleccione Click here to upload si decide cargar la clave a través de Adobe Campaign Classic.

     • Enter manually the key file path: copie/pegue la ruta absoluta en este campo si elige utilizar una clave preexistente.

   • Dataset: Nombre de su Dataset. Para obtener más información, consulte Documentación de Google Cloud.