DocumentaciónCampaignDocumentación de Campaign Classic v7

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

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Uso de Adobe Campaign Classic Acceso de datos federado (FDA) para procesar la información almacenada en una base de datos externa. Siga estos pasos para configurar el acceso a Google BigQuery.

  1. Configurar Google BigQuery el Windows o Linux
  2. Configure las variables Google BigQuery cuenta externa en Adobe Campaign Classic
  3. Configuración de Google BigQuery carga masiva del conector en Windows o Linux
NOTE
Google BigQuery El conector 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 la Controlador ODBC para Windows.

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

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

    • Project: cree o utilice 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 un Google BigQuery mediante 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, especificar una Dataset es obligatorio para Google BigQuery Conector de FDA en Adobe Campaign Classic.

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

  4. En Adobe Campaign Classic, puede configurar los Google BigQuery cuenta externa. Para obtener más información sobre cómo configurar la 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.
Recomendamos utilizar Python3, consulte esto 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 64 bits de Windows (x86_64) desde aquí página y extráigalo en el directorio correspondiente.

  2. Ejecute el google-cloud-sdk\install.sh script. 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á configurado. Si no es así, añádalo manualmente.

  4. En el ..\google-cloud-sdk\bin\bq.cmd , añada el CLOUDSDK_PYTHON variable local, que redireccionará 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.
Recomendamos utilizar Python3, consulte esto 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 un Google BigQuery cuenta externa para conectar la instancia de Adobe Campaign Classic a Google BigQuery base de datos externa.

  1. De 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 el uso de 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, esto 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 abstendrá de intentar volver a crear, 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 activa 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