Azure Synapse へのアクセスの設定

キャンペーンを使用 Federated Data Access (FDA) 外部データベースに保存されている情報を処理するオプション。 次の手順に従って、Microsoft Analytics へのアクセスをAzure synapseします。

  1. でAzure synapseを設定 CentOS, Windows または Debian
  2. azure synapse 外部アカウント キャンペーン内

CentOS での Azure Synapse

注意
  • ODBC ドライバーをインストールするには、ルート権限が必要です。
  • Microsoft が提供する Red Hat Enterprise ODBC ドライバーは、CentOS と組み合わせて SQL Server に接続することもできます。
  • バージョン 13.0 は Red Hat 6 および 7 で動作します。

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 Analytics は 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 Analytics 側からの通信を許可するには、パブリック IP を許可リストに追加する必要がある場合があります。その場合は、Azure のドキュメントを参照してください。

  6. iptables の場合は、次のコマンドを実行します。

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

Windows での Azure Synapse

メモ

これは ODBC ドライバーのバージョン 13 専用ですが、Adobe Campaign Classic では SQL Server Native Client ドライバー 11.0 および 10.0 も使用できます。

Windows で Azure Synaps を設定するには、以下を実行します。

  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 Analytics は TCP 1433 ポートを通じて通信するので、Windows Defender ファイアウォール上でこのポートを開く必要があります。詳しくは、Windows のドキュメントを参照してください。

Debian での Azure Synapse

前提条件:

  • 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. sudo apt-get update を呼び出すときに、「メソッドドライバー /usr/lib/apt/methods/https が見つかりません」というエラーが発生した場合は、以下のコマンドを実行してください。

    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. Azure Synapse Analytics と確実に接続できるように Debian で iptables を設定するには、次のコマンドを使用して、ホスト名に対してアウトバウンド TCP 1433 ポートを有効にします。

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

    Azure Synapse Analytics 側からの通信を許可するには、パブリック IP を許可リストに追加する必要がある場合があります。その場合は、Azure のドキュメントを参照してください。

azure synapse外部アカウント

Azure Synapse 外部アカウントを使用すれば、Campaign インスタンスを Azure Synapse 外部データベースに接続することができます。

次の手順で Azure Synapse 外部アカウントは、次の手順に従います。

  1. キャンペーンから エクスプローラ​をクリックし、 管理 '>' Platform '>' 外部アカウント.

  2. 新規」をクリックします。

  3. 外部アカウント​タイプ​として、「外部データベース」を選択します。

  4. Azure Synapse 外部アカウントを設定するには、次を指定する必要があります。

    • タイプ:Azure Synapse Analytics

    • サーバー:Azure Synapse サーバーの URL

    • アカウント:ユーザーの名前

    • パスワード:ユーザーアカウントのパスワード

    • データベース:データベースの名前

このページ