Azure Synapseへのアクセス権の設定 configure-access-to-azure-synapse
外部データベースに保存されている情報を処理するには、Campaign Federated Data Access (FDA)オプションを使用します。 Microsoft Azure Synapse Analyticsへのアクセスを設定するには、次の手順に従います。
CentOS上のAzure Synapse azure-centos
- ODBC ドライバをインストールするには、root権限が必要です。
- Microsoft が提供する Red Hat Enterprise ODBC ドライバーは、CentOS と組み合わせて SQL Server に接続することもできます。
- バージョン 13.0 は Red Hat 6 および 7 で動作します。
CentOSでAzure Synapseを設定するには、次の手順に従います。
-
まず、ODBC ドライバーをインストールします。 こちらのページにあります。
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] -
必要に応じて、次のコマンドを実行して unixODBC 開発ヘッダーをインストールできます。
code language-none sudo yum install unixODBC-devel -
ドライバーをインストールした後、必要に応じて、ODBC ドライバーをテストおよび検証し、データベースにクエリをおこなうことができます。 次のコマンドを実行します。
code language-none /opt/mssql-tools/bin/sqlcmd -S yourServer -U yourUserName -P yourPassword -q "your query" # for example -q "select 1" -
Campaignで、Azure Synapse外部アカウントを設定できます。 外部アカウントの設定方法について詳しくは、この節を参照してください。
-
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 herenote NOTE Azure Synapse Analytics 側からの通信を許可するには、パブリック IP を許可リストに追加する必要がある場合があります。 その場合は、Azure のドキュメントを参照してください。 -
iptables の場合は、次のコマンドを実行します。
code language-none iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPT
Windows版Azure Synapse azure-windows
Windows で Azure Synaps を設定するには、以下を実行します。
-
まず、Microsoft ODBC ドライバーをインストールします。 このページ で見つけることができます。
-
次のファイルを選択してインストールします。
code language-none your_language\your_architecture\msodbcsql.msi (i.e: English\X64\msodbcsql.msi) -
ODBC ドライバーをインストールした後、必要に応じてテストできます。 詳しくは、このページを参照してください。
-
Campaign Classic では、Azure Synapse 外部アカウントを設定できます。 外部アカウントの設定方法について詳しくは、この節を参照してください。
-
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 を設定するには、以下を実行します。
-
まず、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 -
sudo apt-get update を呼び出すときに、「メソッドドライバー /usr/lib/apt/methods/https が見つかりません」というエラーが発生した場合は、以下のコマンドを実行してください。
code language-none sudo apt-get install apt-transport-https ca-certificates -
次のコマンドを使用して、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 -
必要に応じて、次のコマンドを実行して unixODBC 開発ヘッダーをインストールできます。
code language-none sudo yum install unixODBC-devel -
ドライバーをインストールした後、必要に応じて、ODBC ドライバーをテストおよび検証し、データベースにクエリをおこなうことができます。 次のコマンドを実行します。
code language-none /opt/mssql-tools/bin/sqlcmd -S yourServer -U yourUserName -P yourPassword -q "your query" # for example -q "select 1" -
Campaign Classic では、Azure Synapse 外部アカウントを設定できます。 外部アカウントの設定方法について詳しくは、この節を参照してください。
-
Azure Synapse Analytics と確実に接続できるように Debian で iptables を設定するには、次のコマンドを使用して、ホスト名に対してアウトバウンド TCP 1433 ポートを有効にします。
code language-none iptables -A OUTPUT -p tcp -d [server_hostname_here] --dport 1433 -j ACCEPTnote NOTE Azure Synapse Analytics 側からの通信を許可するには、パブリック IP を許可リストに追加する必要がある場合があります。 その場合は、Azure のドキュメントを参照してください。
Azure Synapse外部アカウント azure-external
Azure Synapse外部アカウントを使用すると、Campaign インスタンスをAzure Synapse外部データベースに接続できます。
Azure Synapse外部アカウントを作成するには、次の手順に従います。
-
キャンペーン エクスプローラーから、管理 ‘>’ プラットフォーム ‘>’ 外部アカウントをクリックします。
-
「新規」をクリックします。
-
外部アカウント タイプ として、「外部データベース」を選択します。
-
Configurationで、Type ドロップダウンから Azure Synapse Analytics を選択します。
-
Azure Synapse外部アカウントを設定します。
-
標準認証の場合は、次を指定する必要があります。
-
サーバー:Azure Synapse サーバーの URL
-
アカウント:ユーザーの名前
-
パスワード:ユーザーアカウントのパスワード
-
データベース:データベースの名前
-
-
システム割り当てマネージド ID認証の場合は、次を指定する必要があります。
-
サーバー:Azure Synapse サーバーの URL
-
データベース:データベースの名前
-
オプション:次の構文
Authentication=ActiveDirectoryMsiを追加します
-
-
-
「保存」をクリックします。
コネクタは、次のオプションをサポートしています。
詳細については、SQL ドキュメント (接続文字列の例n°8)を参照してください。