Configuración del acceso a Teradata

Utilice la opción Campaña 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 Teradata.

  1. Instalar y configurar controladores de Teradata
  2. Configurar la cuenta externa de Teradata en Campaña
  3. Configure configuración adicional para Teradata y el servidor de Campaña

Configuración de teradata

Debe instalar controladores para Teradata para que la conexión a la Campaña esté implementada.

  1. Instale el controlador ODBC para Teradata.

    Se compone de tres paquetes que pueden instalarse en Red Hat (o CentOS)/Suse en el siguiente orden:

    • TeraGSS
    • tdicu1510 (instálelo con setup_wrapper.sh)
    • tdodbc1510 (install it using setup_wrapper.sh)
  2. Configure el controlador ODBC. La configuración se puede realizar en los archivos estándar: /etc/odbc.ini para obtener parámetros generales y /etc/odbcinst.ini para declarar controladores:

    • /etc/odbc.ini

      [ODBC]
      InstallDir=/etc/
      

      "InstallDir" corresponde a la ubicación del archivo odbcinst.ini.

    • /etc/odbcinst.ini

      [ODBC DRIVERS]
      teradata=Installed
      
      [teradata]
      Driver=/opt/teradata/client/15.10/lib64/tdata.so
      APILevel=CORE
      ConnectFunctions=YYY
      DriverODBCVer=3.51
      SQLLevel=1
      
  3. Especifique las variables de entorno del servidor de Adobe Campaign:

    • LD_LIBRARY_PATH: /opt/teradata/client/15.10/lib64 and /opt/teradata/client/15.10/odbc_64/lib.
    • ODBCINI: ubicación del archivo odbc.ini (por ejemplo, /etc/odbc.ini).
    • NLSPATH: ubicación del archivo opermsgs.cat (/opt/teradata/client/15.10/msg/opermsgs.cat?lang=es)
NOTA

La conexión a una base de datos externa de Teradata en FDA requiere pasos de configuración adicionales en el servidor Adobe Campaign. Más información.

Cuenta externa Teradata

La cuenta externa Teradata permite conectar la instancia de Campaign a la base de datos externa Teradata.

  1. En la Campaña Explorer, haga clic en Administration / Platform / External accounts.

  2. Haga clic en New y seleccione External database como Type.

  3. Para configurar la cuenta externa Teradata, debe especificar:

    • Type:: Elija el Teradata tipo.

    • Server: URL o nombre del servidor Teradata

    • Account: Nombre de la cuenta utilizada para acceder a la base de datos Teradata

    • Password: Contraseña utilizada para conectarse a la base de datos Teradata

    • Database:: Nombre de la base de datos (opcional)

    • Options: Opciones que pasan por Teradata. Utilice el siguiente formato: 'parameter=value'. Utilice una semicolumna como separador entre valores.

    • Timezone: Zona horaria definida en Teradata. Más información

Banda de consultas

Cuando varios usuarios de Adobe Campaign se conectan con la misma cuenta externa de Teradata FDA, la pestaña Query banding permite establecer una banda de consulta, es decir, un conjunto de pares de claves o valores en una sesión.

Cuando se configura esta opción, cada vez que un usuario de Campaña realiza una consulta en la base de datos de Teradata, Adobe Campaign envía metadatos, que consisten en una lista de claves, asociados a este usuario. Los administradores de Teradata pueden utilizar estos datos para fines de auditoría o para administrar los derechos de acceso.

NOTA

Para obtener más información sobre Query banding, consulte la Documentación oficial de Teradata.

Para configurar las bandas de Consulta, siga los pasos a continuación:

  1. Utilice Default para introducir una banda de consulta predeterminada que se utilizará si un usuario no tiene una banda de consulta asociada. Si este campo se deja vacío, los usuarios sin banda de consulta no podrán utilizar Teradata.

  2. Utilice el campo Users para especificar una banda de consulta para cada usuario. Puede agregar todos los pares clave/valor que necesite, por ejemplo, priority=1;workload=high. Si el usuario no tiene ninguna banda de consulta asignada, se aplica el campo Default.

  3. Marque la casilla Active para activar esta función.

Solución de problemas de cuentas externas

Si aparece el siguiente error al probar la conexión TIM-030008 Date '2': missing character(s) (iRc=-53) asegúrese de que el controlador ODBC esté correctamente instalado y de que LD_LIBRARY_PATH (Linux)/PATH (Windows) está configurado para el servidor de Campaign.

Error de ODBC ODB-240000: [no se encontró el nombre del origen de datos de Microsoft][ODBC Driver Manager] y no se especificó ningún controlador predeterminado. se produce con Windows si se utiliza un controlador 16.X. Adobe Campaign espera que el nombre de Teradata sea '{teradata}' en odbcinst.ini.

  • A partir de la Campaña 18.10, puede agregar ODBCDRiverName="Teradata Database ODBC Driver 16.10" en las opciones de la cuenta externa. El número de versión puede cambiar, y se puede encontrar el nombre exacto ejecutando odbcad32.exe y accediendo a la pestaña Controladores.

  • Si utiliza una versión de Campaña anterior, deberá copiar la sección Teradata de odbcinst.ini creada por la instalación del controlador en una nueva sección denominada Teradata. Regedit se puede utilizar en este caso. Si su base está en latin1, deberá agregar APICharSize=1 en las opciones.

Configuraciones adicionales

Configuración del usuario

Se requieren los siguientes derechos en la base de datos externa: cree/suelte/ejecute procedimientos personalizados, cree/suelte/inserte/seleccione tablas. También es posible que tenga que crear funciones de modo de usuario si desea utilizar las funciones md5 y sha2 en la instancia de Adobe Campaign.

Asegúrese de configurar la zona horaria específica. Debe coincidir con el que se establecerá en la cuenta externa creada en la instancia de Adobe Campaign.

Adobe Campaign no establecerá ningún modo de protección (reserva) en los objetos que creará en la base de datos. Es posible que tenga que establecer un valor predeterminado en el usuario que Adobe Campaign utilizará para conectarse a la base de datos de Teradata mediante la siguiente consulta:

Disable default fallback
MODIFY USER $login$ AS NO FALLBACK;

Instalación de MD5

Si desea utilizar funciones md5 en la instancia de Adobe Campaign, deberá instalar la función de modo usuario en la base de datos de Teradata desde esta página (md5_20080530.zip).

El sha1 del archivo descargado es el siguiente: 65cc0bb6935f72fcd84fef1ebcd64c00115dfd1e.

Para instalar MD5:

  1. Descomprima el archivo md5_20080530.zip.

  2. Vaya al directorio md5/src.

  3. Conéctese a la base de datos de Teradata mediante bteq.

  4. Ejecute el siguiente comando bteq:

    .run file = hash_md5.btq
    

Instalación de SHA2

Si desea utilizar funciones sha2 en la instancia de Adobe Campaign, deberá instalar la función de modo usuario en la base de datos de Teradata desde esta página (teradata-udf-sha2-1.0.zip).

El sha1 del archivo descargado es el siguiente e87438d37424836358bd3902cf1adeb629349780.

Para instalar sha2:

  1. Descomprima el archivo teradata-udf-sha2-1.0.zip.

  2. Vaya al directorio teradata-udf-sha2-1.0/src.

  3. Conéctese a la base de datos de Teradata mediante bteq.

  4. Ejecute estos dos comandos bteq:

    .run file = hash_sha256.sql
    .run file = hash_sha512.sql
    

Instalación de UDF_UTF16TO8

Si desea utilizar las funciones udf_utf16to8 en la instancia de Adobe Campaign, deberá instalar la función de modo de usuario en la base de datos de Teradata desde el kit de herramientas Unicode de Teradata en esta página (utk_release1.7.0.0.zip).

El sha1 del archivo descargado es el siguiente e58235f434f52c71316a577cb48e20b97d24f470.

Para instalar udf_utf16to8:

  1. Descomprima el archivo utk_release1.7.0.0.zip.

  2. Busque udf_utf16to8.o en los archivos extraídos y vaya al directorio que contiene el archivo. Debe solicitarse utk_release1.7.0.0/utk_release1.7.0.0/04 TranslationUDFs/01 Teradata UDFs/suselinux-x8664/udf_installation/.

  3. Conéctese a la base de datos de Teradata mediante bteq.

  4. Escriba el siguiente comando bteq:

    REPLACE FUNCTION udf_utf16to8 (
    inputString VARCHAR(8000) CHARACTER SET UNICODE
    ) RETURNS VARCHAR(16000) CHARACTER SET LATIN
    LANGUAGE C
    NO SQL
    EXTERNAL NAME 'CO!i18n103!udf_utf16to8.o!F!udf_utf16to8'
    PARAMETER STYLE SQL;
    
    -- Test: should return 410042
    SELECT CAST(Char2HexInt(UDF_UTF16to8(_UNICODE'004100000042'XC)) AS VARCHAR(100));
    

Configuración del servidor de Campaign para Linux

Se requiere lo siguiente para la instalación del controlador:

  • Controlador ODBC Teradata, que se puede encontrar en esta página

  • Herramientas y utilidades de Teradata (utilizadas para la carga masiva), que se pueden encontrar en esta página

Nombres de archivos y sha1:

  • tdodbc1620__linux_indep.16.20.00.00-1.tar.gz 121fdd978b56fe1304fc5cb7819741b0847f44fd

  • TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz b 29d0af5ffd8dcf68a9dbbaa6f8639387b19c563

Si no hay ningún paquete para su distribución Linux, puede instalarlos según se explica en CentOS 7 (por ejemplo, usando docker) y luego copiar el contenido de /opt/teradata en su servidor de Adobe Campaign.

Instalación del controlador ODBC

Para instalar el controlador ODBC:

  1. Extraiga el archivo tdodbc1620__linux_indep.16.20.00.00-1.tar.gz.

  2. Vaya al directorio tdodbc1620.

  3. Es posible que tenga que corregir la secuencia de comandos de configuración:

    "sed -i s/16.10/16.20/ setup_wrapper.sh".
    
  4. Ejecute setup_wrapper.sh.

Instalación de herramientas y utilidades de Teradata

Para instalar las herramientas:

  1. Extraiga el archivo TeradataToolsAndUtilitiesBase__linux_indep.16.20.01.00.tar.gz.

  2. Vaya al directorio TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tdicu.

  3. Ejecute setup_wrapper.sh.

  4. Vaya al directorio TeradataToolsAndUtilitiesBase/Linux/i386-x8664/cliv2.

  5. Ejecute setup_wrapper.sh.

  6. Vaya al directorio TeradataToolsAndUtilitiesBase/Linux/i386-x8664/tptbase.

  7. Ejecute setup_wrapper.sh.

  8. Debe haber un archivo libtelapi.so disponible en /opt/teradata/client/16.20/lib64.

Configuración del servidor de Campaign para Windows

Primero debe descargar las herramientas y utilidades de Teradata para Windows. Puede descargarlas desde esta página

Asegúrese de instalar el controlador ODBC y la base del transportador paralelo de Teradata. Instalará telapi.dll, que se utiliza para realizar cargas masivas en la base de datos de Teradata.

Asegúrese de que la ruta del controlador y las utilidades se encuentra en la variable PATH de nlserver durante la ejecución. De forma predeterminada, la ruta es C:\Program Files (x86)\Teradata\Client\15.10\bin para Windows de 32 bits o C:\Programa Files\Teradata\Client\15.10\bin para 64 bits.

Zona horaria

Teradata utiliza nombres de la zona horaria que no son estándar y puede encontrar la lista en el sitio Teradata. Adobe Campaign intentará convertir la zona horaria proporcionada en la configuración externa a algo que Teradata entienda. Si no se encuentra ninguna correspondencia, se encontrará la zona horaria GMT+X (o GMT-X) más cercana para la sesión, con una advertencia en el registro.

La conversión se realiza leyendo un archivo llamado teradata_timezones.txt que debe estar en el siguiente directorio de datos: /usr/local/neolane/nl6/datakit en Linux. Si edita este archivo, asegúrese de ponerse en contacto con el equipo de Adobe Campaign para realizar el cambio en el código fuente. De lo contrario, este archivo se sobrescribirá durante la próxima actualización de Campaign.

La zona horaria usada para conectarse se indicará cuando se ejecuta nlserver con el conmutador -verbose, por ejemplo:

15:04:04 >   ODB-240007 Teradata: will use 'Europe Central' as session time zone.

Si la zona horaria utilizada no es la correcta, se puede agregar una opción denominada "TimeZoneName" en la cuenta externa. En ese caso, utilice el valor Teradata, por ejemplo "TimeZoneName=Europe Central".

Cuando se utiliza carga masiva o "carga rápida" en documentos Teradata, Campaign no puede indicar la zona horaria. Por lo tanto, se recomienda establecer la zona horaria predeterminada del usuario que la Campaign utilizará para conectarse:

MODIFY USER $login$ AS TIME ZONE = 'Europe Central';

En esta página