DocumentaçãoCampaignDocumentação do Campaign Classic v7

Configuração do acesso ao Azure synapse configure-access-to-azure-synapse

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Use a opção Campaign Federated Data Access (FDA) para processar informações armazenadas em bancos de dados externos. Siga as etapas abaixo para configurar o acesso ao Microsoft Azure synapse Analytics.

  1. Configurar o Azure synapse no CentOS, Windows ou Debian
  2. Configurar o Azure synapse conta externa no Campaign

Azure synapse no CentOS azure-centos

CAUTION
  • 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, siga as etapas abaixo:

  1. Primeiro, instale o driver ODBC. Você pode encontrá-lo nesta página.

    note note
    NOTE
    É uma exclusividade da versão 13 do driver ODBC.
    code language-none 
    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:

    code language-none 
    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:

    code language-none 
    /opt/mssql-tools/bin/sqlcmd -S yourServer -U yourUserName -P yourPassword -q "your query" # for example -q "select 1"

  4. No Campaign, você pode configurar a conta externa do Azure Synapse. Para obter mais informações sobre como configurar sua 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:

    code language-none 
    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
    note note
    NOTE
    Para permitir a comunicação com o Azure Synapse Analytics, será 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:

    code language-none 
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT

Azure synapse no Windows azure-windows

NOTE
É 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 em esta página.

  2. Escolha os seguintes arquivos para instalar:

    code language-none 
    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 sua 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 azure-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:

    code language-none 
    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:

    code language-none 
    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:

    code language-none 
    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.

    code language-none 
    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:

    code language-none 
    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:

    code language-none 
    /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 sua 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:

    code language-none 
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
    note note
    NOTE
    Para permitir a comunicação com o Azure Synapse Analytics, será necessário adicionar seu IP público à lista de permissões. Para fazer isso, consulte a documentação do Azure.

Conta externa do Azure synapse azure-external

A conta externa Azure Synapse permite conectar a instância do Campaign ao banco de dados externo do Azure synapse.

Para criar sua conta externa do Azure Synapse, siga as etapas abaixo:

  1. Na Campanha Explorer, clique em Administration '>' Platform '>' External accounts.

  2. Clique em New.

  3. Selecione External database como sua conta externa Type.

  4. Em Configuration, selecione Azure Synapse Analytics no menu suspenso Type.

  5. Configure a conta externa do Azure Synapse:

    • Para autenticação padrão, você deve especificar:

      • 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

    • Para a autenticação de identidade gerenciada atribuída pelo sistema, você deve especificar:

      • Server: o URL do servidor Azure Synapse

      • Database: Nome do banco de dados

      • Options: Adicionar a seguinte sintaxe Authentication=ActiveDirectoryMsi

  6. Clique em Save.

O conector é compatível com as seguintes opções:

Opção
Descrição
Autenticação
Tipo de autenticação compatível com o conector. Valor com suporte atual: AtiveDirectoryMSI.
Para obter mais informações, consulte o documento SQL (Exemplo de cadeias de conexão n°8).
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1