DokumentationCampaignCampaign Classic v7 – Dokumentation

Zugriff auf Azure synapse konfigurieren configure-access-to-azure-synapse

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Verwenden von Campaign Federated Data Access (FDA), um in externen Datenbanken gespeicherte Informationen zu verarbeiten. Gehen Sie wie folgt vor, um den Zugriff auf Microsoft Azure synapse Analytics.

  1. Konfigurieren von Azure synapse on CentOS, Windows oder Debian
  2. Azure synapse konfigurieren externes Konto in Campaign

Azure synapse unter CentOS azure-centos

CAUTION
  • Sie benötigen Root-Berechtigungen, um einen ODBC-Treiber zu installieren.
  • Red Hat Enterprise ODBC-Treiber von Microsoft können auch mit CentOS verwendet werden, um eine Verbindung zum SQL-Server herzustellen.
  • Version 13.0 funktioniert mit Red Hat 6 und 7.

Gehen Sie wie folgt vor, um Azure synapse unter CentOS zu konfigurieren:

  1. Installieren Sie zunächst den ODBC-Treiber. Sie finden ihn auf dieser Seite.

    note note
    NOTE
    Dies gilt ausschließlich für Version 13 des ODBC-Treibers.
    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. Bei Bedarf können Sie unixODBC-Entwicklungskopfzeilen installieren, indem Sie den folgenden Befehl ausführen:

    code language-none 
    sudo yum install unixODBC-devel

  3. Nach der Installation der Treiber können Sie Ihren ODBC-Treiber testen und überprüfen und Ihre Datenbank bei Bedarf abfragen. Führen Sie den folgenden Befehl aus:

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

  4. In Campaign können Sie dann Ihre Azure Synapse externes Konto. Weitere Informationen zur Konfiguration Ihres externen Kontos finden Sie unter diesem Abschnitt.

  5. Da Azure Synapse Analytics über den TCP-Port 1433 kommuniziert, müssen Sie diesen Port in Ihrer Firewall öffnen. Verwenden Sie den folgenden Befehl:

    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
    Um Kommunikation von Azure Synapse Analytics aus zu ermöglichen, müssen Sie eventuell Ihre öffentliche IP zur Zulassungsliste hinzufügen. Lesen Sie dazu die Azure-Dokumentation.

  6. Führen Sie bei "iptables" den folgenden Befehl aus:

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

Azure synapse unter Windows azure-windows

NOTE
Dies gilt ausschließlich für Version 13 des ODBC-Treibers; Adobe Campaign Classic kann aber auch SQL Server Native Client-Treiber 11.0 und 10.0 verwenden.

So konfigurieren Sie Azure Synapse unter Windows:

  1. Installieren Sie zunächst den Microsoft ODBC-Treiber. Sie finden sie unter diese Seite.

  2. Wählen Sie die folgenden zu installierenden Dateien aus:

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

  3. Sobald der ODBC-Treiber installiert ist, können Sie ihn bei Bedarf testen. Weiterführende Informationen hierzu finden Sie auf dieser Seite.

  4. In Campaign Classic können Sie dann Ihr externes Azure Synapse-Konto konfigurieren. Weitere Informationen zur Konfiguration Ihres externen Kontos finden Sie unter diesem Abschnitt.

  5. Da Azure Synapse Analytics über den TCP-Port 1433 kommuniziert, müssen Sie diesen Port in der Windows Defender Firewall öffnen. Weitere Informationen hierzu finden Sie in der Windows-Dokumentation.

Azure synapse unter Debian azure-debian

Voraussetzungen:

  • Sie benötigen Stammberechtigungen, um einen ODBC-Treiber zu installieren.

  • Zur Installation des msodbcsql-Packages ist curl erforderlich. Führen Sie den folgenden Befehl aus, wenn Sie curl nicht installiert haben:

    code language-none 
    sudo apt-get install curl

So konfigurieren Sie Azure Synapse unter Debian:

  1. Installieren Sie zunächst den Microsoft ODBC-Treiber für SQL Server. Verwenden Sie folgende Befehle, um den ODBC-Treiber 13.1 für SQL Server zu installieren:

    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. Wenn Sie den Fehler "Der Methodentreiber /usr/lib/apt/methods/https konnte nicht gefunden werden" beim Aufruf von sudo apt-get update erhalten, müssen Sie diesen Befehl ausführen:

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

  3. Installieren Sie jetzt "mssql-tools" mit den folgenden Befehlen. "mssql-tools" sind erforderlich, um das Dienstprogramm Bulk Copy Program (BCP) zu nutzen und Abfragen auszuführen.

    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. Bei Bedarf können Sie unixODBC-Entwicklungskopfzeilen installieren, indem Sie den folgenden Befehl ausführen:

    code language-none 
    sudo yum install unixODBC-devel

  5. Nach der Installation der Treiber können Sie Ihren ODBC-Treiber testen und überprüfen und Ihre Datenbank bei Bedarf abfragen. Führen Sie den folgenden Befehl aus:

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

  6. In Campaign Classic können Sie nun Ihr externes Azure Synapse-Konto konfigurieren. Weitere Informationen zur Konfiguration Ihres externen Kontos finden Sie unter diesem Abschnitt.

  7. Um "iptables" unter Debian zu konfigurieren und die Verbindung mit Azure Synapse Analytics sicherzustellen, aktivieren Sie mit dem folgenden Befehl den ausgehenden TCP-Port 1433 für Ihren Hostname:

    code language-none 
    iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
    note note
    NOTE
    Um Kommunikation von Azure Synapse Analytics aus zu ermöglichen, müssen Sie eventuell Ihre öffentliche IP zur Zulassungsliste hinzufügen. Lesen Sie dazu die Azure-Dokumentation.

Externes azure synapse-Konto azure-external

Die Azure Synapse Mit dem externen Konto können Sie Ihre Campaign-Instanz mit Ihrer externen Azure synapse-Datenbank verbinden.

So erstellen Sie Ihre Azure Synapse Gehen Sie wie folgt vor:

  1. Von Campaign Explorer klicken Administration '>' Plattform '>' Externe Konten.

  2. Wählen Sie Neu aus.

  3. Wählen Sie Externe Datenbank als Typ Ihres externen Kontos aus.

  4. under Konfiguration auswählen Azure synapse Analytics aus dem Typ angezeigt.

  5. Konfigurieren Sie die Azure Synapse externes Konto:

    • Für die Standardauthentifizierung müssen Sie Folgendes angeben:

      • Server: URL des Azure Synapse-Servers

      • Konto: Name des Benutzers

      • Passwort: Passwort des Benutzerkontos

      • Datenbank: Name der Datenbank

    • Für die systemzugeordnete verwaltete Identitätsauthentifizierung müssen Sie Folgendes angeben:

      • Server: URL des Azure Synapse-Servers

      • Datenbank: Name der Datenbank

      • Optionen: Fügen Sie die folgende Syntax hinzu: Authentication=ActiveDirectoryMsi

  6. Klicken Sie auf Speichern.

Der Connector unterstützt die folgenden Optionen:

Option
Beschreibung
Authentifizierung
Vom Connector unterstützte Authentifizierungstyp. Aktuell unterstützter Wert: ActiveDirectoryMSI.
Weitere Informationen finden Sie unter SQL doc (Beispiel für Verbindungszeichenfolgen n°8).
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1