DocumentaciónCampaignDocumentación de Campaign Classic v7

Configuración del acceso a Google BigQuery configure-fda-google-big-query

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Utilice la opción Adobe Campaign Classic Acceso de datos federado (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. Configurar la Google BigQuery cuenta externa en Adobe Campaign Classic
  3. Configurar la carga masiva del conector Google BigQuery en Windows o Linux
NOTE
El conector Google BigQuery está disponible para implementaciones alojadas, híbridas y locales. Para obtener más información, consulte esta página.

Google BigQuery en Windows google-windows

Controlador configurado en Windows driver-window

  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 el conector Google BigQuery funcione, 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: Service account requiere Key File para una conexión de Google BigQuery 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, es obligatorio especificar un Dataset para el conector FDA Google BigQuery en Adobe Campaign Classic.

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

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

Configuración de carga masiva en Windows bulk-load-window

NOTE
Necesita instalar Python para que funcione el SDK de Google Cloud.
Se recomienda usar Python3, vea esta página.

La utilidad Carga masiva permite una transferencia más rápida, que se logra a través del SDK de Google Cloud.

  1. Descargue el archivo de Windows de 64 bits (x86_64) 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 de acceso ...\google-cloud-sdk\bin esté establecida. Si no es así, añádalo manualmente.

  4. En el archivo ..\google-cloud-sdk\bin\bq.cmd, agregue la variable local CLOUDSDK_PYTHON, la cual 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 google-linux

Controlador configurado en Linux driver-linux

Antes de configurar el controlador, tenga en cuenta que el usuario raíz debe ejecutar el script y los comandos. También se recomienda utilizar Google DNS 8.8.8.8, mientras se ejecuta la secuencia de comandos.

Para configurar Google BigQuery en Linux, siga los pasos a continuación:

  1. Antes de la instalación de ODBC, compruebe que los siguientes paquetes estén instalados en la distribución Linux:

    • Para Red Hat/CentOS:

      code language-none 
      yum update
yum upgrade
yum install -y grep sed tar wget perl curl

    • Para Debian:

      code language-none 
      apt-get update
apt-get upgrade
apt-get install -y grep sed tar wget perl curl

  2. Actualizar el sistema antes de la instalación:

    • Para Red Hat/CentOS:

      code language-none 
      # install unixODBC driver manager
yum install -y unixODBC

    • Para Debian:

      code language-none 
      # install unixODBC driver manager
apt-get install -y odbcinst1debian2 libodbc1 odbcinst unixodbc

  3. Antes de ejecutar el script, puede obtener más información especificando el argumento —help:

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh --help

  4. Acceda al directorio en el que se encuentra el script y ejecute el siguiente script como usuario raíz:

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_odbc-setup.sh

Configuración de carga masiva en Linux bulk-load-linux

NOTE
Necesita instalar Python para que funcione el SDK de Google Cloud.
Se recomienda usar Python3, vea esta página.

La utilidad Carga masiva permite una transferencia más rápida, que se logra a través del SDK de Google Cloud.

  1. Antes de la instalación de ODBC, compruebe que los siguientes paquetes estén instalados en la distribución Linux:

    • Para Red Hat/CentOS:

      code language-none 
      yum update
yum upgrade
yum install -y python3

    • Para Debian:

      code language-none 
      apt-get update
apt-get upgrade
apt-get install -y python3

  2. Acceda al directorio en el que se encuentra el script y ejecute el siguiente script:

    code language-none 
    cd /usr/local/neolane/nl6/bin/fda-setup-scripts
./bigquery_sdk-setup.sh

Cuenta externa de Google BigQuery google-external

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.

El conector admite las siguientes opciones:

Opción
Descripción
ProxyType
Tipo de proxy utilizado para conectarse a BigQuery mediante conectores ODBC y SDK.
HTTP (predeterminado), http_no_túnel, socks4 y socks5 son compatibles actualmente.
ProxyHost
Nombre de host o dirección IP donde se puede contactar con el proxy.
ProxyPort
Número de puerto en el que se ejecuta el proxy, p. ej. 8080
ProxyUid
Nombre de usuario utilizado para el proxy autenticado
ProxyPwd
Contraseña de ProxyUid
bqpath
Tenga en cuenta que esto solo es aplicable a la herramienta de carga masiva (Cloud SDK).
Para evitar usar la variable PATH o si el directorio google-cloud-sdk debe moverse a otra ubicación, puede especificar con esta opción la ruta exacta al directorio bin del sdk en la nube en el servidor.
GCloudConfigName
Tenga en cuenta que esto es aplicable a partir de la versión 7.3.4 y solo para la herramienta de carga masiva (Cloud SDK).
: el SDK de Google Cloud utiliza configuraciones para cargar datos en tablas de BigQuery. La configuración denominada accfda almacena los parámetros para cargar los datos. Sin embargo, esta opción permite a los usuarios especificar un nombre diferente para la configuración.
GCloudDefaultConfigName
Tenga en cuenta que esto es aplicable a partir de la versión 7.3.4 y solo para la herramienta de carga masiva (Cloud SDK).
: la configuración activa del SDK de Google Cloud no se puede eliminar sin transferir primero la etiqueta activa a una nueva configuración. Esta configuración temporal es necesaria para volver a crear la configuración principal para cargar datos. El nombre predeterminado para la configuración temporal es default, que se puede cambiar si es necesario.
GCloudRecreateConfig
Tenga en cuenta que esto es aplicable a partir de la versión 7.3.4 y solo para la herramienta de carga masiva (Cloud SDK).
Cuando se establece en false, el mecanismo de carga masiva se abstiene de intentar recrear, eliminar o modificar las configuraciones del SDK de Google Cloud. En su lugar, procede con la carga de datos utilizando la configuración existente en el equipo. Esta función es útil cuando otras operaciones dependen de las configuraciones del SDK de Google Cloud.
Si el usuario habilita esta opción de motor sin una configuración adecuada, el mecanismo de carga masiva emitirá un mensaje de advertencia: No active configuration found. Please either create it manually or remove the GCloudRecreateConfig option. Para evitar más errores, volverá a utilizar el mecanismo de carga masiva predeterminado de inserción de matriz ODBC.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1