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

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

  1. 配置Azure synapse CentOSWindowsDebian
  2. 配置Azure synapse 外部帐户 在Campaign中

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

    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,选择 Azure Synapse AnalyticsType 下拉菜单。

  5. 配置 Azure Synapse 外部帐户:

    • 对于标准身份验证,您必须指定:

      • Server:Azure synapse服务器的URL

      • Account:用户名称

      • Password:用户帐户密码

      • Database:数据库的名称

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

      • Server:Azure synapse服务器的URL

      • Database:数据库的名称

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

  6. 单击 Save

连接器支持以下选项:

选项
说明
身份验证
连接器支持的身份验证类型。 当前支持的值: ActiveDirectoryMSI。
有关更多信息,请参阅 SQL文档 (连接字符串n°8示例)。
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1