Show Menu
TÓPICOS×

Configuração de conectores FDA

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.
Para obter mais informações sobre conectores herdados, como Teradata, Hadoop 2.1 ou Netezza, consulte esta página .
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 .

Configurar o acesso ao Azure Synapse

Conta externa do Azure Synapse

A conta externa do Azure permite conectar a instância do Campaign ao banco de dados externo do Azure Synapse. Para criar sua conta externa do Azure Synapse:
  1. No Campaign Classic, configure a conta externa do Azure Synapse. No Explorer , clique em Administration / Platform / External accounts .
  2. Clique em New .
  3. Selecione External database como sua conta externa Type .
  4. Para configurar a conta externa do Azure Synapse, você deve especificar:
    • Type : Azure Synapse Analytics
    • Server : o URL do servidor Azure Synapse
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Database : Nome do banco de dados

Azure Synapse no CentOS

Pré-requisitos:
  • Você precisará de privilégios raiz para instalar um driver ODBC.
  • Os drivers Red Hat Enterprise ODBC fornecidos pela Microsoft também podem ser usados com o CentOS para conexão com o SQL Server.
  • A versão 13.0 funcionará com o Red Hat 6 e 7.
Para configurar o Azure Synapse no CentOS:
  1. Primeiro, instale o driver ODBC. Você pode encontrá-lo nesta página .
    É uma exclusividade da versão 13 do driver ODBC.
    sudo su
    curl https://packages.microsoft.com/config/rhel/6/prod.repo > /etc/yum.repos.d/mssql-release.repo
    exit
    # Uninstall if already installed Unix ODBC driver
    sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
    
    sudo ACCEPT_EULA=Y yum install msodbcsql
    
    sudo ACCEPT_EULA=Y yum install mssql-tools
    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
    source ~/.bashrc
    
    # the Microsoft driver expects unixODBC to be here /usr/lib64/libodbc.so.1, so add soft links to the '.so.2' files
    cd /usr/lib64
    sudo ln -s libodbccr.so.2   libodbccr.so.1
    sudo ln -s libodbcinst.so.2 libodbcinst.so.1
    sudo ln -s libodbc.so.2     libodbc.so.1
    
    # Set the path for unixODBC
    export ODBCINI=/usr/local/etc/odbc.ini
    export ODBCSYSINI=/usr/local/etc
    source ~/.bashrc
    
    #Add a DSN information to /etc/odbc.ini
    sudo vi /etc/odbc.ini
    
    #Add the following:
    [Azure Synapse Analytics]
    Driver      = ODBC Driver 13 for SQL Server
    Description = Azure Synapse Analytics DSN
    Trace       = No
    Server      = [insert your server here]
    
    
  2. Se necessário, você pode instalar cabeçalhos de desenvolvimento unixODBC executando o seguinte comando:
    sudo yum install unixODBC-devel
    
    
  3. Depois de instalar os drivers, você pode testar e verificar o driver ODBC e consultar o banco de dados, se necessário. Execute o seguinte comando:
    /opt/mssql-tools/bin/sqlcmd -S yourServer -U yourUserName -P yourPassword -q "your query" # for example -q "select 1"
    
    
  4. No Campaign Classic, você pode configurar a conta externa do Azure Synapse. Para obter mais informações sobre como configurar a conta externa, consulte esta seção .
  5. Como o Azure Synapse Analytics se comunica por meio da porta TCP 1433, é necessário abrir essa porta no firewall. Use o seguinte comando:
    firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="[server_ip_here]/32" port port="1433" protocol="tcp" accept'
    # you can ping your hostname and the ping command will translate the hostname to IP address which you can use here
    
    
    Para permitir a comunicação do lado do Azure Synapse Analytics, talvez seja necessário adicionar seu IP público à lista de permissões. Para fazer isso, consulte a documentação do Azure .
  6. No caso de iptables, execute o seguinte comando:
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
    
    

Azure Synapse no Windows

É uma exclusividade da versão 13 do driver ODBC, mas o Adobe Campaign Classic também pode usar os drivers do SQL Server Native Client 11.0 e 10.0.
Para configurar o Azure Synapse no Windows:
  1. Primeiro, instale o driver ODBC da Microsoft. Você pode encontrá-lo nesta página .
  2. Escolha os seguintes arquivos para instalar:
    your_language\your_architecture\msodbcsql.msi (i.e: English\X64\msodbcsql.msi)
    
    
  3. Depois que o driver ODBC estiver instalado, você poderá testá-lo se necessário. Para obter mais informações, consulte esta página .
  4. No Campaign Classic, você pode configurar a conta externa do Azure Synapse. Para obter mais informações sobre como configurar a conta externa, consulte esta seção .
  5. Como o Azure Synapse Analytics se comunica por meio da porta TCP 1433, é necessário abrir essa porta no Windows Defender Firewall. Para saber mais, consulte a documentação do Windows .

Azure Synapse no Debian

Pré-requisitos:
  • Você precisará de privilégios raiz para instalar um driver ODBC.
  • O Curl é necessário para instalar o pacote msodbcsql. Se ele não estiver instalado, execute o seguinte comando:
    sudo apt-get install curl
    
    
Para configurar o Azure Synapse no Debian:
  1. Primeiro, instale o driver ODBC da Microsoft para o SQL Server. Use os seguintes comandos para instalar o driver ODBC 13.1 para o SQL Server:
    sudo su
    curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
    curl https://packages.microsoft.com/config/debian/8/prod.list > /etc/apt/sources.list.d/mssql-release.list
    exit
    sudo apt-get update
    sudo ACCEPT_EULA=Y apt-get install msodbcsql
    
    
  2. Se você receber um erro "O driver do método /usr/lib/apt/methods/https não foi encontrado" ao chamar a atualização sudo apt-get , execute o comando:
    sudo apt-get install apt-transport-https ca-certificates
    
    
  3. Agora é necessário instalar as ferramentas do mssql com os seguintes comandos. As ferramentas do mssq são necessárias para usar o utilitário programa de cópia em massa (ou BCP) e para executar queries.
    sudo ACCEPT_EULA=Y apt-get install mssql-tools
    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
    echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
    source ~/.bashrc
    
    
  4. Se necessário, você pode instalar cabeçalhos de desenvolvimento unixODBC executando o seguinte comando:
    sudo yum install unixODBC-devel
    
    
  5. Depois de instalar os drivers, você pode testar e verificar o driver ODBC e consultar o banco de dados, se necessário. Execute o seguinte comando:
    /opt/mssql-tools/bin/sqlcmd -S yourServer -U yourUserName -P yourPassword -q "your query" # for example -q "select 1"
    
    
  6. No Campaign Classic, você pode configurar a conta externa do Azure Synapse. Para obter mais informações sobre como configurar a conta externa, consulte esta seção .
  7. Para configurar iptables no Debian para garantir a conexão com o Azure Synapse Analytics, habilite a porta TCP 1433 de saída para seu nome de host com o seguinte comando:
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
    
    
    Para permitir a comunicação do lado do Azure Synapse Analytics, talvez seja necessário adicionar seu IP público à lista de permissões. Para fazer isso, consulte a documentação do Azure .

Configuração do acesso ao Snowflake

SnowflakeO conector de está disponível para implantações locais e hospedadas. Para obter mais informações, consulte esta página .

Conta externa do Snowflake

A conta externa do Snowflake permite conectar a instância do Campaign ao banco de dados externo do Snowflake.
  1. No Campaign Classic, configure a conta externa do Snowflake. No Explorer , clique em Administration / Platform / External accounts .
  2. Clique em New .
  3. Selecione External database como sua conta externa Type .
  4. Para configurar a conta externa do Snowflake , você deve especificar:
    • Type : Snowflake
    • Server : URL do servidor Snowflake
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Database : Nome do banco de dados
  5. Clique na guia Parameters e depois no botão Deploy functions para criar as funções.
O conector é compatível com as seguintes opções:
Opção
Descrição
schema de trabalho
schema de banco de dados que deve ser usado para tabelas de trabalho
depósito
Nome do depósito padrão que deve ser usado. Ele substituirá o padrão do usuário.
TimeZoneName
É vazio por padrão, 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 da sessão TIMEZONE.
WeekStart
Parâmetro de sessão WEEK_START. Por padrão, defina como 0.
UseCachedResult
Parâmetro de sessão USE_CACHED_RESULTS. Por padrão, defina como TRUE. Esta opção pode ser usada para desativar os resultados em cache do Snowflake.
Para obter mais informações, consulte esta página .

Snowflake no CentOS

  1. Baixe os drivers ODBC para o Snowflake. Clique aqui para iniciar o download.
  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. No Campaign Classic, você pode configurar a conta externa do Snowflake. Para obter mais informações sobre como configurar a conta externa, consulte esta seção .

Snowflake no Debian

  1. Baixe os drivers ODBC para o Snowflake. Clique aqui para iniciar o download.
  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. No Campaign Classic, você pode configurar a conta externa do Snowflake. Para obter mais informações sobre como configurar a conta externa, consulte esta seção .

Snowflake no Windows

  1. Instale o driver ODBC para Windows . Observe que é necessário ter os 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. No Campaign Classic, você pode configurar a conta externa do Snowflake. Para obter mais informações sobre como configurar a conta externa, consulte esta seção .

Configuração do acesso ao Hadoop 3.0

Conta externa do Hadoop

A conta externa do Hadoop permite conectar a instância do Campaign ao banco de dados externo do Hadoop.
  1. No Campaign Classic, configure a conta externa do Hadoop. No Explorer , clique em Administration / Platform / External accounts .
  2. Clique em New .
  3. Selecione External database como sua conta externa Type .
  4. Para configurar a conta externa do Hadoop , você deve 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 estiver especificado no DSN. Pode ficar em branco, se estiver especificado no DSN
    • Time zone : Fuso horário do servidor
O conector é compatível com as seguintes opções ODBC:
Nome
Valor
ODBCMgr
iODBC
depósito
1/2/4
O conector também é compatível com as seguintes opções de Hive:
Nome
Valor
Descrição
bulkKey
Azure blob ou chave de acesso do DataLake
Para wasb:// ou wasbs:// carregadores em massa (isto é, se a ferramenta de carregamento em massa inicia 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 inicia com webhdfs:// ou webhdfss://).
bucketsNumber
20
Número de buckets ao criar uma tabela agregada.
fileFormat
PARQUET
Formato de arquivo padrão para tabelas de trabalho.

Configuração do Hadoop 3.0

A conexão com um banco de dados externo do Hadoop no FDA exige as seguintes configurações no servidor do Adobe Campaign. Observe que essa configuração está disponível para Windows e Linux.
  1. Baixe os drivers ODBC para Hadoop de acordo com a 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 a 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. No Campaign Classic, você pode configurar a conta externa do Hadoop. Para obter mais informações sobre como configurar a conta externa, consulte esta seção .

Configuração do acesso ao Oracle

Conta externa do Oracle

A conta externa do Oracle permite conectar a instância do Campaign ao banco de dados externo do Hadoop.
  1. No Campaign Classic, configure a conta externa do oracle. No Explorer , clique em Administration / Platform / External accounts .
  2. Clique em New .
  3. Selecione External database como sua conta externa Type .
  4. Para configurar a conta externa do Oracle , você deve especificar:
    • Type : Oracle
    • Server : Nome do DNS
    • Account : Nome do usuário
    • Password : Senha da conta do usuário
    • Time zone : Fuso horário do servidor

Oracle no Linux

A conexão com um banco de dados externo Oracle no FDA exige as seguintes configurações adicionais no servidor do Adobe Campaign:
  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
      
      
  5. No Campaign Classic, você pode configurar a conta externa do Oracle. Para obter mais informações sobre como configurar a conta externa, consulte esta seção .

Oracle no Windows

A conexão com um banco de dados externo Oracle no FDA exige as seguintes configurações adicionais no servidor do Adobe Campaign:
  1. Instale o software cliente Oracle.
  2. Na pasta C:\Oracle, crie um arquivo tnsnames.ora contendo sua definição TNS.
  3. Adicione uma variável de ambiente TNS_ADMIN com C:\Oracle como valor e reinicie o computador.
  4. No Campaign Classic, você pode configurar a conta externa do Oracle. Para obter mais informações sobre como configurar a conta externa, consulte esta seção .