配置对Azure synapse的访问

使用Campaign 联合数据访问 (FDA)选项，用于处理存储在外部数据库中的信息。 请按照以下步骤配置对 MicrosoftAzure synapse分析.

1. 配置Azure synapse CentOS, Windows 或 德比安
2. 配置Azure synapse 外部帐户 在Campaign中

azure synapseCentOS

要在CentOS上配置Azure synapse，请执行以下步骤：

1. 首先，安装ODBC驱动程序。 你可以在这里找到它 页面.

   注意

   这是ODBC驱动程序版本13所独有的。

   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. 如果需要，可以通过运行以下命令来安装unixODBC开发标头：

   sudo yum install unixODBC-devel
   

3. 安装驱动程序后，您可以测试和验证ODBC驱动程序，并根据需要查询数据库。 运行以下命令：

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

4. 然后，在Campaign中，您可以配置 Azure Synapse 外部帐户。 有关如何配置外部帐户的更多信息，请参阅 此部分.

5. 由于Azure synapse分析通过TCP 1433端口进行通信，因此您需要在防火墙上打开此端口。 使用以下命令：

   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
   

   注意

   要允许从Azure synapse分析端进行通信，您可能需要将公共IP添加到允许列表中。 为此，请参阅 Azure文档.

6. 对于iptables，请运行以下命令：

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

azure synapseWindows

要在Windows上配置Azure synapse，请执行以下操作：

1. 首先，安装Microsoft ODBC驱动程序。 您可以在 本页.

2. 选择要安装的以下文件：

   your_language\your_architecture\msodbcsql.msi (i.e: English\X64\msodbcsql.msi)
   

3. 安装ODBC驱动程序后，即可根据需要进行测试。 有关详细信息，请参见此 页面。

4. 在Campaign Classic中，您可以配置 Azure Synapse 外部帐户。 有关如何配置外部帐户的更多信息，请参阅 此部分.

5. 由于Azure synapse分析通过TCP 1433端口进行通信，因此您需要在Windows Defender防火墙上打开此端口。 有关更多信息，请参阅 Windows文档.

azure synapseDebian

先决条件:

• 安装ODBC驱动程序需要根权限。

• 安装msodbcsql包时需要curl。 如果尚未安装该命令，请运行以下命令：

  sudo apt-get install curl
  

要在Debian上配置Azure synapse，请执行以下操作：

1. 首先，安装用于SQL Server的Microsoft ODBC驱动程序。 使用以下命令安装SQL Server的ODBC驱动程序13.1:

   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. 如果您遇到以下错误 "找不到方法驱动程序/usr/lib/apt/methods/https" 调用 sudo apt-get更新，则应运行命令：

   sudo apt-get install apt-transport-https ca-certificates
   

3. 现在，您需要使用以下命令安装mssql-tools。 使用批量复制程序（或BCP）实用程序和运行查询时需要MSSQ-tools。

   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. 如果需要，可以通过运行以下命令来安装unixODBC开发标头：

   sudo yum install unixODBC-devel
   

5. 安装驱动程序后，您可以测试和验证ODBC驱动程序，并根据需要查询数据库。 运行以下命令：

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

6. 在Campaign Classic中，您现在可以配置 Azure Synapse 外部帐户。 有关如何配置外部帐户的更多信息，请参阅 此部分.

7. 要在Debian上配置iptables以确保与Azure synapse分析连接，请使用以下命令为主机名启用出站TCP 1433端口：

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

   注意

   要允许从Azure synapse分析端进行通信，您可能需要将公共IP添加到允许列表中。 为此，请参阅 Azure文档.

azure synapse外部帐户

的 Azure Synapse 外部帐户允许您将Campaign实例连接到Azure synapse外部数据库。

创建 Azure Synapse 外部帐户请按照以下步骤操作：

1. 从Campaign Explorer，单击 Administration '>' Platform '>' External accounts.

2. 单击 New。

3. 选择 External database 作为外部帐户的 Type.

   

4. 在 Configuration，选择 Azure Synapse Analytics 从 Type 下拉菜单。

   

5. 配置 Azure Synapse 外部帐户：

   • 对于标准身份验证，您必须指定：

     • Server:azure synapse服务器的URL

     • Account:用户的名称

     • Password:用户帐户密码

     • Database:数据库的名称

     

   • 对于系统分配的托管身份验证，您必须指定：

     • Server:azure synapse服务器的URL

     • Database:数据库的名称

     • Options:添加以下语法 Authentication=ActiveDirectoryMsi

     

6. 单击 Save。