azure synapseへのアクセスの設定 configure-access-to-azure-synapse

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

  1. CentOSWindows または Debian のAzure synapseを設定
  2. Campaign でのAzure synapse 外部アカウントの設定

CentOS のAzure synapse azure-centos

CAUTION
  • ODBC ドライバをインストールするには、root 権限が必要です。
  • 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 Synapse Analytics は 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 Synaps を設定するには、以下を実行します。

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

Debian のAzure synapse azure-debian

前提条件:

  • 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 をインストールする必要があります。一括コピープログラム(または 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. Azure Synapse Analytics と確実に接続できるように Debian で iptables を設定するには、次のコマンドを使用して、ホスト名に対してアウトバウンド 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. Campaign エクスプローラー で、「管理 「>」 プラットフォーム 「>」 外部アカウント をクリックします。

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

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

  4. Configuration の下で、{Type ドロップダウンから ​​ 2}Azure synapse分析 ​​ を選択します。

  5. Azure Synapse 外部アカウントを設定します。

    • 標準認証の場合、次を指定する必要があります。

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

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

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

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

    • システムが割り当てた管理 ID 認証の場合は、次を指定する必要があります。

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

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

      • オプション:次の構文 Authentication=ActiveDirectoryMsi を追加します

  6. 保存」をクリックします。

コネクタは、次のオプションをサポートしています。

オプション
説明
認証
コネクターでサポートされている認証のタイプ。 現在サポートされている値:ActiveDirectoryMSI。
詳しくは、SQL ドキュメント(接続文字列 n°8 の例)を参照してください。
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1