Configuración del acceso a Teradata configure-access-to-teradata

Utilice la opción Acceso de datos federado (FDA) de Campaign para procesar la información almacenada en bases de datos externas. Siga los pasos a continuación para configurar el acceso a la Teradata.

  1. Instalar y configurar controladores de Teradata
  2. Configuración de la Teradata cuenta externa en Campaign
  3. Configurar configuración adicional para el servidor de Teradata y Campaign

configuración de teradata teradata-config

Debe instalar controladores para Teradata para poder implementar la conexión a Campaign.

  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

      code language-none
      [ODBC]
      InstallDir=/etc/
      

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

    • /etc/odbcinst.ini

      code language-none
      [ODBC DRIVERS]
      teradata=Installed
      
      [teradata]
      Driver=/opt/teradata/client/17.10/lib64/tdataodbc_sb64.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 (https://experienceleague.adobe.com/opt/teradata/client/15.10/msg/opermsgs.cat?lang=es)
NOTE
La conexión a una base de datos externa de Teradata en FDA requiere pasos de configuración adicionales en el servidor de Adobe Campaign. Más información.

Cuenta externa Teradata teradata-external

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 tipo Teradata.

    • Server: URL o nombre de su servidor de Teradata

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

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

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

    • Options: opciones que se pasarán por la Teradata. Utilice el siguiente formato: 'parameter=value'. Utilice un punto y coma como separador entre valores.

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

El conector admite las siguientes opciones:

Opción
Descripción
TD_MAX_SESSIONS
Especifica el número máximo de sesiones de inicio de sesión que puede adquirir el Transportador paralelo de Teradata para un trabajo de operador.
TimeZoneName
Nombre de la zona horaria del servidor.
CharacterSet
Se utiliza para configurar el conjunto de caracteres de la Teradata.
Para obtener más información, consulte esta página.
IANAppCodePage
Página de códigos de la aplicación ODBC.
Para obtener más información, consulte esta página

Agregar cuentas externas ODBC adicionales add-external

NOTE
Esta opción no está disponible para compilaciones anteriores a la versión 7.3.1.

El controlador de Teradata proporciona su propia biblioteca ODBC, pero esta biblioteca puede no ser compatible con otras cuentas externas ODBC.

Si desea configurar otra cuenta externa que también utilice ODBC, por ejemplo, Snowflake, deberá agregar una opción ODBCLib establecida en la ruta de la biblioteca ODBC predeterminada (/usr/lib/x86_64-linux-gnu/libodbc.so en Debian y /usr/lib64/libodbc.so en RHEL/CentOS).

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 Campaign realiza una consulta en la base de datos de Teradata, Adobe Campaign envía metadatos que consisten en una lista de claves asociada a este usuario. Los administradores de Teradata pueden utilizar estos datos para fines de auditoría o para administrar los derechos de acceso.

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

Para configurar Query banding, siga los pasos a continuación:

  1. Use Default para especificar una banda de consulta predeterminada que se utilizará si un usuario no tiene ninguna 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 cuenta externa external-account-troubleshooting

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 la teradata se llame '{teradata}' en odbcinst.ini.

  • A partir de Campaign 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 Campaign anterior, tendrá que copiar la sección de Teradata de odbcinst.ini creada por la instalación del controlador en una nueva sección llamada Teradata. Regedit se puede utilizar en este caso. Si la base está en latin1, tendrá que agregar APICharSize=1 en las opciones.

Configuraciones adicionales teradata-additional-configurations

Configuración de usuario user-configuration

Se requieren los siguientes derechos en la base de datos externa: procedimientos personalizados create/drop/execute y tablas create/drop/insert/select. 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 md5-installation

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:

    code language-none
    .run file = hash_md5.btq
    

Instalación de SHA2 sha2-installation

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:

    code language-none
    .run file = hash_sha256.sql
    .run file = hash_sha512.sql
    

Instalación de UDF_UTF16TO8 UDF-UTF16TO8-installation

Si desea utilizar las funciones udf_utf16to8 en su instancia de Adobe Campaign, instale la función de modo usuario en su base de datos de Teradata desde el kit de herramientas Unicode de Teradata.

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:

    code language-none
    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 campaign-server-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 odbc-installation

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:

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

Instalación de herramientas y utilidades de teradata teradata-tools-installation

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 campaign-server-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 timezone

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';
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1