文档CampaignCampaign Classic v7 文档

配置对Azure synapse的访问权限 configure-access-to-azure-synapse

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

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

  1. 在CentOS、Windows或Debian上配置Azure synapse
  2. 在Campaign中配置Azure synapse外部帐户

在CentOS上Azure synapse azure-centos

CAUTION
  • 您需要具有root权限才能安装ODBC驱动程序。
  • Microsoft提供的Red Hat Enterprise ODBC驱动程序也可以与CentOS一起用于连接到SQL Server。
  • 版本13.0可以与Red Hat 6和7一起使用。

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

  1. 首先，安装ODBC驱动程序。 您可以在此页面中找到它。

    note note
    NOTE
    这是ODBC驱动程序版本13独有的。
    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. 如果需要，可以通过运行以下命令来安装unixODBC开发标头：

    code language-none 
    sudo yum install unixODBC-devel

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

    code language-none 
    /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 synapseAnalytics通过TCP 1433端口进行通信，因此需要在防火墙上打开此端口。 使用以下命令：

    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
    要允许来自Azure synapse列入允许列表 Analytics端的通信，您可能需要将公共IP添加到。 为此，请参阅Azure文档。

  6. 如果是iptables，请运行以下命令：

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

在Windows上Azure synapse azure-windows

NOTE
这是ODBC驱动程序版本13所独有的，但Adobe Campaign Classic也可以使用SQL Server Native Client驱动程序11.0和10.0。

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

  1. 首先，安装Microsoft ODBC驱动程序。 您可以在此页面中找到它。

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

    code language-none 
    your_language\your_architecture\msodbcsql.msi (i.e: English\X64\msodbcsql.msi)

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

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

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

DebianAzure synapse azure-debian

先决条件：

  • 您需要具有root权限才能安装ODBC驱动程序。

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

    code language-none 
    sudo apt-get install curl

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

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

    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. 如果您收到以下错误​ “在调用 sudo apt-get update 时找不到方法驱动程序/usr/lib/apt/methods/https”，您应该运行该命令：

    code language-none 
    sudo apt-get install apt-transport-https ca-certificates

  3. 现在，您需要使用以下命令安装mssql-tools。 要使用Bulk Copy程序（或BCP）实用程序并运行查询，需要Mssq-tools。

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

    code language-none 
    sudo yum install unixODBC-devel

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

    code language-none 
    /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 synapseAnalytics的连接，请使用以下命令为主机名启用出站TCP 1433端口：

    code language-none 
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
    note note
    NOTE
    要允许来自Azure synapse列入允许列表 Analytics端的通信，您可能需要将公共IP添加到。 为此，请参阅Azure文档。

azure synapse外部帐户 azure-external

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

要创建您的Azure Synapse外部帐户，请执行以下步骤：

  1. 在营销活动​ Explorer ​中，单击​ Administration“>”Platform“>”External accounts。

  2. 单击 New。

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

  4. 在​ Configuration ​下，从​ Type ​下拉列表中选择​ Azure Synapse Analytics。

  5. 配置Azure Synapse外部帐户：

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

      • Server：Azure synapse服务器的URL

      • Account：用户的名称

      • Password：用户帐户密码

      • Database：数据库的名称

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

      • Server：Azure synapse服务器的URL

      • Database：数据库的名称

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

  6. 单击 Save。

连接器支持以下选项：

选项
说明
身份验证
连接器支持的身份验证类型。 当前支持的值： ActiveDirectoryMSI。
有关详细信息，请参阅SQL doc（连接字符串n°8示例）。
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1