Show Menu
TÓPICOS×

Configurações específicas por tipo de banco de dados

Dependendo dos bancos de dados externos que você deseja acessar do Adobe Campaign, você precisará realizar algumas configurações específicas. Essas configurações envolvem basicamente a instalação de drivers e a declaração de variáveis de ambiente pertencentes a cada RDBMS no servidor do Adobe Campaign.
Como regra geral, você precisa instalar a camada de cliente correspondente no banco de dados externo no servidor do Adobe Campaign.
Versões compatíveis são listadas na Matriz de Compatibilidade do Campaign .

Configure access to Snowflake

Snowflake está disponível para implantações locais e hospedadas. For more on this, refer to this article .

Floco de neve no CentOS

  1. Baixe os drivers ODBC para Snowflake. Clique aqui para fazer o download do start.
  2. Em seguida, é necessário instalar os drivers ODBC no CentOs com o seguinte comando:
    rpm -Uvh unixodbc
    rpm -Uvh snowflake-odbc-2.20.2.x86_64.rpm
    
    
  3. Após baixar e instalar os drivers ODBC, é necessário reiniciar o Campaign Classic. Para fazer isso, execute o seguinte comando:
    /etc/init.d/nlserver6 stop
    /etc/init.d/nlserver6 start
    
    
  4. Em Campaign Classic, você pode configurar sua Snowflake conta externa. Na página Explorer , clique em Administration / Platform / External accounts .
  5. Selecione a Snowflake conta externa integrada.
  6. Configure a Snowflake conta externa, você deve especificar:
    • Server : URL do Snowflake servidor
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Database : Nome da base de dados
  7. Clique na Parameters guia e no Deploy functions botão para criar funções.
O conector suporta as seguintes opções:
Opção
Descrição
esquema de trabalho
schema de banco de dados a ser usado para tabelas de trabalho
depósito
Nome do depósito padrão a ser usado. Isso substituirá o padrão do usuário.
TimeZoneName
Por padrão vazio, o que significa que o fuso horário do sistema do servidor de aplicativos Campaign Classic é usado. A opção pode ser usada para forçar o parâmetro de sessão TIMEZONE.
Para obter mais informações, consulte esta página .
WeekStart
Parâmetro de sessão WEEK_START. Por padrão, defina como 0.
Para obter mais informações, consulte esta página .
UseCachedResult
parâmetro de sessão USE_CACHED_RESULTS. Por padrão, defina como TRUE. Essa opção pode ser usada para desativar os resultados em cache do Floco de neve.
Para obter mais informações, consulte esta página .

Floco de neve em Debian

  1. Baixe os drivers ODBC para Snowflake. Clique aqui para fazer o download do start.
  2. Em seguida, é necessário instalar os drivers ODBC no Debian com o seguinte comando:
    apt-get install unixodbc
    apt-get install snowflake-odbc-x.xx.x.x86_64.deb
    
    
  3. Após baixar e instalar os drivers ODBC, é necessário reiniciar o Campaign Classic. Para fazer isso, execute o seguinte comando:
    systemctl stop nlserver.service
    systemctl start nlserver.service
    
    
  4. Em Campaign Classic, você pode configurar sua Snowflake conta externa. Na página Explorer , clique em Administration / Platform / External accounts .
  5. Selecione a Snowflake conta externa integrada.
  6. Para configurar a Snowflake conta externa, você deve especificar:
    • Server : URL do Snowflake servidor
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Database : Nome da base de dados
  7. Clique na Parameters guia e no Deploy functions botão para criar funções.
O conector suporta as seguintes opções:
Opção
Descrição
esquema de trabalho
schema de banco de dados a ser usado para tabelas de trabalho
depósito
Nome do depósito padrão a ser usado. Isso substituirá o padrão do usuário.
TimeZoneName
Por padrão vazio, o que significa que o fuso horário do sistema do servidor de aplicativos Campaign Classic é usado. A opção pode ser usada para forçar o parâmetro de sessão TIMEZONE.
Para obter mais informações, consulte esta página .
WeekStart
Parâmetro de sessão WEEK_START. Por padrão, defina como 0.
Para obter mais informações, consulte esta página .
UseCachedResult
parâmetro de sessão USE_CACHED_RESULTS. Por padrão, defina como TRUE. Essa opção pode ser usada para desativar os resultados em cache do Floco de neve.
Para obter mais informações, consulte esta página .

Floco de neve no Windows

  1. Baixe o driver ODBC para Windows . Observe que você precisa de privilégios de nível de administrador para instalar o driver. Para obter mais informações, consulte esta página
  2. Configure o driver ODBC. Para obter mais informações, consulte esta página
  3. Em Campaign Classic, você pode configurar sua Snowflake conta externa. Na página Explorer , clique em Administration / Platform / External accounts .
  4. Selecione a Snowflake conta externa integrada.
  5. Para configurar a Snowflake conta externa, você deve especificar:
    • Server : URL do Snowflake servidor
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Database : Nome da base de dados
  6. Clique na Parameters guia e no Deploy functions botão para criar funções.
O conector suporta as seguintes opções:
| Opção | Descrição | |---|---|---| | esquema de trabalho | schema de banco de dados a ser usado para tabelas de trabalho | | depósito | Nome do depósito padrão a ser usado. Isso substituirá o padrão do usuário. | | TimeZoneName | Por padrão vazio, o que significa que o fuso horário do sistema do servidor de aplicativos Campaign Classic é usado. A opção pode ser usada para forçar o parâmetro de sessão TIMEZONE.
Para obter mais informações, consulte esta página . | | WeekStart | Parâmetro de sessão WEEK_START. Por padrão, defina como 0.
Para obter mais informações, consulte esta página . | | UseCachedResult | Por padrão, defina como TRUE. Esta opção pode ser usada para desativar os resultados em cache do Floco de neve (parâmetro de sessão USE_CACHED_RESULTS)
Para obter mais informações, consulte esta página . |

Configure access to Hadoop 3.0

A conexão com um banco de dados externo do Hadoop em FDA requer as seguintes configurações no servidor Adobe Campaign. Observe que essa configuração está disponível para Windows e Linux.
  1. Baixe os drivers ODBC para o Hadoop, dependendo da versão do sistema operacional. Os drivers podem ser encontrados nesta página .
  2. Em seguida, é necessário instalar os drivers ODBC e criar um DSN para sua conexão Hive. As instruções podem ser encontradas nesta página
  3. Após baixar e instalar os drivers ODBC, é necessário reiniciar o Campaign Classic. Para fazer isso, execute o seguinte comando:
    systemctl stop nlserver.service
    systemctl start nlserver.service
    
    
  4. Em Campaign Classic, você pode configurar sua conta externa de floco de neve. Na página Explorer , clique em Administration / Platform / External accounts .
  5. Clique Create e selecione External database como Tipo de conta.
  6. Para configurar a Hadoop conta externa, é necessário especificar:
    • Type : ODBC (Sybase ASE, Sybase IQ)
    • Server : Nome do DNS
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Database : Nome do banco de dados, se não for especificado no DSN. Pode ser deixado em branco se especificado no DSN
    • Time zone : Fuso horário do servidor
O conector suporta as seguintes opções ODBC:
Nome
Valor
ODBCMgr
iODBC
depósito
1/2/4
O conector também suporta as seguintes opções de Colmeia:
Nome
Valor
Descrição
globalKey
Blob do Azure ou chave de acesso do DataLake
Para wasb:// ou wasbs:// carregadores em massa (isto é, se a ferramenta de carregamento em massa start com wasb:// ou wasbs://).
É a chave de acesso para blob ou bucket DataLake para carregamento em massa.
hdfsPort
número da porta
definido por padrão como 8020
Para carregamento em massa de HDFS (isto é, se a ferramenta de carregamento em massa start com webhdfs:// ou webhdfss://).
bucketsNumber
20
Número de compartimentos ao criar uma tabela clusterizada.
fileFormat
PARQUET
Formato de arquivo padrão para tabelas de trabalho.

Configure access to Hadoop 2.1

Para Windows

  1. Instale os drivers ODBC e Azure HD Insight para Windows.
  2. Crie o DSN (Nome da Fonte de Dados) executando a ferramenta DataSource Administrador ODBC. Um exemplo de DSN de Sistema para Hive é fornecido para você modificar.
    Description: vorac (or any name you like)
    Host: vorac.azurehdinsight.net
    Port: 443
    Database: sm_tst611 (or your database name)
    Mechanism: Azure HDInsight Service
    User/Password: admin/<your password here>
    
    
  3. Create the Hadoop external account, as detailed in this page section.

Para Linux

  1. Instale o unixodbc para Linux.
    apt-get install unixodbc
    
    
  2. Baixe e instale os drivers ODBC para Apache Hive a partir do HortonWorks: https://www.hortonworks.com/downloads/ .
    dpkg -i hive-odbc-native_2.1.10.1014-2_amd64.deb
    
    
  3. Verifique o local dos arquivos ODBC.
    root@campadpac71:/tmp# odbcinst -j
    unixODBC 2.3.1
    DRIVERS............: /etc/odbcinst.ini
    SYSTEM DATA SOURCES: /etc/odbc.ini
    FILE DATA SOURCES..: /etc/ODBCDataSources
    USER DATA SOURCES..: /root/.odbc.ini
    SQLULEN Size.......: 8
    SQLLEN Size........: 8
    SQLSETPOSIROW Size.: 8
    
    
  4. Crie o DSN (Data Source Name) e edite o arquivo odbc.ini. Em seguida, crie um DSN para a conexão do Hive.
    Veja um exemplo do HDInsight para configurar uma conexão chamada "viral":
    [ODBC Data Sources]
    vorac 
    
    [vorac]
    Driver=/usr/lib/hive/lib/native/Linux-amd64-64/libhortonworkshiveodbc64.so
    HOST=vorac.azurehdinsight.net
    PORT=443
    Schema=sm_tst611
    HiveServerType=2
    AuthMech=6
    UID=admin
    PWD=<your password here>
    HTTPPath=
    UseNativeQuery=1
    
    
    O parâmetro UseNativeQuery é muito importante. O Campaign tem reconhecimento de Hive e não funcionará corretamente, a menos que UseNativeQuery esteja definida. Normalmente, o driver ou o Hive SQL Connector irá reescrever queries e alterar a ordem da coluna.
    A configuração de autenticação depende da configuração Hive/Hadoop. Por exemplo, para o HD Insight, use AuthMech=6 para autenticação de usuário/senha, conforme descrito aqui .
  5. Exporte as variáveis.
    export ODBCINI=/etc/myodbc.ini
    export ODBCSYSINI=/etc/myodbcinst.ini
    
    
  6. Instalação de drivers Hortonworks via /usr/lib/hive/lib/native/Linux-amd64-64/hortonworks.hiveodbc.ini.
    Você precisa usar UTF-16 para poder se conectar com o Campaign e unix-odbc (libodbcinst).
    [Driver]
    
    DriverManagerEncoding=UTF-16
    ErrorMessagesPath=/usr/lib/hive/lib/native/hiveodbc/ErrorMessages/
    LogLevel=0
    LogPath=/tmp/hive
    SwapFilePath=/tmp
    
    ODBCInstLib=libodbcinst.so
    
    
  7. Agora você pode testar sua conexão usando isql.
    isql vorac
    isql vorac -v
    
    
  8. Create the Hadoop external account, as detailed in this page section.

Configuração do acesso ao Netezza

A conexão com um banco de dados externo Netezza no FDA exige as seguintes configurações adicionais no servidor do Adobe Campaign.
  1. Instale os drivers ODBC do Netezza, de acordo com o sistema operacional que você utiliza:
    • nz-linuxclient-v7.2.0.0.tar.gz para Linux. Selecione a pasta que corresponde ao seu sistema operacional (linux ou linux64) e inicie o comando unpack. Você pode deixar a instalação ser executada no repositório sugerido por padrão: "/usr/local/nz".
    • nz-winclient-v7.2.0.0.zip para Windows. Descompacte o arquivo e inicie o script executável que corresponde ao seu sistema operacional: nzodbcsetup.exe ou nzodbcsetup64.exe. Siga as instruções do assistente para concluir a instalação dos drivers.
  2. Configure o driver ODBC. A configuração pode ser realizada nos arquivos padrão: /etc/odbc.ini para parâmetros gerais e /etc/odbcinst.ini para declaração de drivers.
    • /etc/odbc.ini
      [ODBC]
      InstallDir=/etc/
      
      
      "InstallDir" corresponde ao local do arquivo odbcinst.ini.
    • /etc/odbcinst.ini
      [ODBC Drivers]
      NetezzaSQL = Installed
      
      [NetezzaSQL]
      Driver           = /usr/local/nz/lib/libnzsqlodbc3.so
      Setup            = /usr/local/nz/lib/libnzsqlodbc3.so
      APILevel         = 1
      ConnectFunctions = YYN
      Description      = Netezza ODBC driver
      DriverODBCVer    = 03.51
      DebugLogging     = false
      LogPath          = /tmp
      UnicodeTranslationOption = utf8
      CharacterTranslationOption = all
      PreFetch         = 256
      Socket           = 16384
      
      
  3. Especifique as variáveis de ambiente do servidor do Adobe Campaign:
    • LD_LIBRARY_PATH : /usr/local/nz/lib e /usr/local/nz/lib64. "/usr/local/nz" corresponde ao repositório de instalação oferecido por padrão ao instalar os drivers. Aqui você precisa especificar o repositório selecionado para a instalação.
    • ODBCINI : local do arquivo odbc.ini (por exemplo /etc/odbc.ini).
    • NZ_ODBC_INI_PATH : local do arquivo odbc.ini. Netezza também exige essa segunda variável para utilizar o arquivo odbc.ini.
  4. No Campaign Classic, você pode configurar sua conta externa Netezza. Na página Explorer , clique em Administration / Platform / External accounts .
  5. Clique New e selecione External database como Type .
  6. Para configurar a Netezza conta externa, você deve especificar:
    • Type : Netezza
    • Server : URL do servidor Netezza
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Database : Nome da base de dados
As operações em schemas que contêm chaves primárias geradas automaticamente não são consideradas.
A tabela utilizará a cláusula Organizar em no primeiro índice definido no schema. Como esta cláusula é limitada de 1 até 4 colunas com Netezza, este índice não pode conter mais de 4 colunas.

Configuração do acesso ao Oracle

A conexão com um banco de dados externo Oracle no FDA exige as seguintes configurações adicionais no servidor do Adobe Campaign:

Para Linux

  1. Instale o cliente completo do Oracle correspondente à sua versão do Oracle.
  2. Adicione suas definições de TNS à instalação. Para fazer isso, especifique em um arquivo tnsnames.ora no repositório /etc/oracle. Crie o repositório, caso ele não exista.
    Em seguida, crie uma nova variável de ambiente TNS_ADMIN: exporte TNS_ADMIN=/etc/oracle e reinicie a máquina.
  3. Integre o Oracle ao seu servidor do Adobe Campaign (nlserver). Para fazer isso, verifique se o arquivo customer.sh está na pasta "nl6" da estrutura da árvore do servidor do Adobe Campaign e se inclui os links para as bibliotecas Oracle.
    Por exemplo, para um cliente em 11.2:
    export ORACLE_HOME=/usr/lib/oracle/11.2
    export TNS_ADMIN=/etc/oracle
    export LD_LIBRARY_PATH=$ORACLE_HOME/client64/lib:$LD_LIBRARY_PATH
    
    
    Esses valores (particularmente ORACLE_HOME) dependem dos repositórios de instalação. Verifique sua estrutura de árvore antes de fazer referência a esses valores.
  4. Instale as bibliotecas necessárias para Oracle:
    • libclntsh.so
      cd /usr/lib/oracle/<version>/client<architecture>/lib
      ln -s libclntsh.so.<version> libclntsh.so
      
      
    • libaio1
      aptitude install libaio1
      or
      yum install libaio1
      
      

Para Windows

  1. Instale o software cliente Oracle.
  2. Na pasta C:\Oracle, crie um arquivo tnsnames.ora contendo sua definição TNS.
    Adicione uma variável de ambiente TNS_ADMIN com C:\Oracle como valor e reinicie o computador.

Configuração do acesso ao Sybase IQ

A conexão com um banco de dados externo Sybase IQ no FDA exige as seguintes configurações adicionais no servidor do Adobe Campaign:
  1. Verifique se o pacote unixodbc está no servidor.
  2. Instale o iq_odbc . Um erro pode ocorrer no final da instalação. Esse erro pode ser ignorado.
  3. Instale o iq_client_common . Um erro Java pode ocorrer no final da instalação. Esse erro pode ser ignorado.
  4. Configure o driver ODBC. A configuração pode ser realizada nos arquivos padrão: /etc/odbc.ini para parâmetros gerais e /etc/odbcinst.ini para declaração de drivers:
    • /etc/odbc.ini (substitua os valores como caracteres <server_alias> pelos seus próprios):
      [ODBC Data Sources]
      <server_alias>=libdbodbc.so
      
      [<server_alias>]
      Driver=/opt/sybase/IQ-16_0/lib64/libdbodbc16.so
      Description=<description>
      Username=<username>
      Password=<password>
      ServerName=<server_name>
      CommLinks=tcpip(host=<host>)
      
      
    • /etc/odbcinst.ini
      [ODBC DRIVERS]
      SAP SybaseIQ=Installed
      
      [SAP SybaseIQ]
      Driver=/opt/sybase/IQ-16_0/lib64/libdbodbc16.so
      
      
  5. Adicione o caminho para a nova biblioteca libodbc16.so na variável LD_LIBRARY_PATH. Para fazer isso:
    • Se você estiver usando um arquivo customer.sh para declarar seu caminho: adicione o caminho /opt/sybase/IQ-16_0/lib64 para a variável LD_LIBRARY_PATH.
    • Caso contrário, use um comando Unix.
  6. No Campaign Classic, você pode configurar sua conta externa de QI do Sybase. Na página Explorer , clique em Administration / Platform / External accounts .
  7. Clique New e selecione External database como Type .
  8. Para configurar a Sybase IQ conta externa, você deve especificar:
    • Type : ODBC (Sybase ASE, Sybase IQ)
    • Server : Corresponde à conexão ODBC ( <server_alias> ) definida na etapa 5. Não necessariamente o nome do próprio servidor.
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Database : Nome da base de dados
Para o Windows, você deve instalar o cliente Sybase IQ no servidor do Adobe Campaign e criar uma conexão ODBC. Certifique-se de criar uma fonte de dados do sistema quando o servidor Adobe Campaign (nlserver) estiver sendo executado como um serviço no Windows.

Configuração do acesso ao Teradata

A conexão com um banco de dados externo Teradata no FDA exige determinadas configurações adicionais no servidor do Adobe Campaign. Para obter mais informações sobre como configurar o banco de dados Teradata, consulte este artigo .
  1. Instale o driver ODBC para Teradata .
    É composto de três pacotes que podem ser instalados no Red Hat (ou no CentOS)/Suse na seguinte ordem:
    • TeraGSS
    • tdicu1510 (instale-o usando setup_wrapper.sh)
    • tdodbc1510 (instale-o usando setup_wrapper.sh)
  2. Configure o driver ODBC. A configuração pode ser realizada nos arquivos padrão: /etc/odbc.ini para parâmetros gerais e /etc/odbcinst.ini para declaração de drivers:
    • /etc/odbc.ini
      [ODBC]
      InstallDir=/etc/
      
      
      "InstallDir" corresponde ao local do arquivo 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 as variáveis de ambiente do servidor do Adobe Campaign:
    • LD_LIBRARY_PATH : opt/teradata/client/15.10/lib64 e /opt/teradata/client/15.10/odbc_64/lib.
    • ODBCINI : local do arquivo odbc.ini (por exemplo /etc/odbc.ini).
    • NLSPATH : local do arquivo opermsgs.cat (/opt/teradata/client/15.10/msg/opermsgs.cat)
  4. Em Campaign Classic, você pode configurar sua conta externa Teradata. Na página Explorer , clique em Administration / Platform / External accounts .
  5. Clique New e selecione External database como Type .
  6. Para configurar a Teradata conta externa, você deve especificar:
    • Type : Teradata
    • Server : URL do servidor Teradata
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Database : Nome da base de dados

Configuração do acesso ao SAP HANA

A conexão com um banco de dados externo SAP HANA no FDA exige determinadas configurações adicionais no servidor do Adobe Campaign:
  1. Instale os drivers ODBC para SAP HANA, de acordo com o sistema operacional que você usa:
    • hdb_client_linux.tgz para Linux. Após descompactado, inicie o comando hdbinst e siga as instruções para finalizar a instalação dos drivers.
    • hdb_client_windows.zip para Windows. Descompacte o arquivo e inicie o executável: hdbinst.exe . Siga as instruções do assistente para concluir a instalação dos drivers.
  2. Configure o driver ODBC. A configuração pode ser realizada nos arquivos padrão: /etc/odbc.ini para parâmetros gerais e /etc/odbcinst.ini para declaração de drivers.
    • /etc/odbc.ini
      [ODBC]
      InstallDir=/etc/
      
      [HDB]
      Driver=HDBODBC
      servernode=localhost:39013 (this value depend of your server)
      User:SYSTEM
      
      
      "InstallDir" corresponde ao local do arquivo odbcinst.ini .
    • /etc/odbcinst.ini
      [HDBODBC]
      Description = "SmartCloudPT HANA"
      Driver = /usr/sap/hdbclient/libodbcHDB.so
      
      
  3. Especifique as variáveis de ambiente do servidor do Adobe Campaign:
    • LD_LIBRARY_PATH : Ele deve incluir o link para seu cliente SAP Hana (/usr/sap/hdbclient/libodbcHDB.so) por padrão.
    • ODBCINI : local do arquivo odbc.ini (por exemplo /etc/odbc.ini).
  4. No Campaign Classic, você pode configurar sua conta externa SAP Hana. Na página Explorer , clique em Administration / Platform / External accounts .
  5. Clique New e selecione External database como Type .
  6. Para configurar a SAP Hana conta externa, você deve especificar:
    • Type : SAP Hana
    • Server : URL do servidor SAP Hana
    • Account : Nome do usuário
    • Password : Senha da conta do usuário