• 前提条件
  • CData IP をホワイトリストに登録
  • SQL Server が一般にアクセス可能であることを確認
• セットアップガイド
• Authentication Methods
  • Password
  • AzurePassword
  • AzureAD
  • AzureServicePrincipal
  • AzureServicePrincipalCert
• SSH Tunnel Instructions
• 詳細について

前提条件

CData IP をホワイトリストに登録

SQL Server への接続を確立するには、CData のIP 経由でSQL Server へのアクセスを許可する必要があります。SQL Server をファイアウォールの内側でホスティングする場合は、これらのIP アドレスをファイアウォールの許可リストに登録する必要があります。

• 範囲：52.224.0.160～52.224.0.175 および4.154.117.160～4.154.117.175

• CIDR 表記：52.224.0.160/28 および4.154.117.160/28

SQL Server が一般にアクセス可能であることを確認

パブリックフェイシングIP / ドメインを指定して、このデータソースに接続します。次のプライベートIP の範囲は機能しません。

• 10.0.0.0 to 10.255.255.255

• 172.16.0.0 to 172.31.255.255

• 192.168.0.0 to 192.168.255.255

• 127.0.0.1 (aka ‘localhost’)

セットアップガイド

以下の手順で、SQL Server をConnect AI アカウントに接続します。

1. Connect AI のダッシュボードからConnections ページを開きます。

2. 右上の+ Add Connection をクリックします。

3. 検索フィールドに SQL Server と入力し、データソース名をクリックします。

4. 新しいコネクションのBasic Settings タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。

5. Enter the host name or IP address of the Server running SQL Server.

6. Enter SQL Server サーバーに接続するためのポート in the Port field.

7. Enter the name of the Database to connect to.

8. Select an encryption method in Encrypt. You can select True (optional encryption), Strict (required encryption), or no encryption.

9. If your SQL Server connection is behind a firewall, enable the setting Use SSH and follow the instructions in SSH Tunnel Instructions. Then, continue with the authentication instructions. Otherwise, leave Use SSH off.

10. Select the Authentication method, then proceed to the relevant section and follow those instructions.

Authentication Methods

Password

1. In the User field, enter 認証用のSQL Server ユーザー名.

2. In the Password field, enter ユーザーパスワード.

3. Connect AI Add SQL Server Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。

   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。

   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。

AzurePassword

1. In the User field, enter 認証用のSQL Server ユーザー名.

2. In the Password field, enter ユーザーパスワード.

AzureAD

1. Enter the Azure Tenant Id. This value is the directory Id in Azure Portal > Azure Active Directory > Properties. If not specified, the default tenant is used.

2. OAuth でセキュアに接続するには、Sign in をクリックします。これにより、SQL Server のサインインページが新しいタブで開かれます。

3. SQL Server アカウントにログインし、リクエストされた権限を設定します（該当する場合）。

4. Connect AI Add SQL Server Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。

   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。

   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。

AzureServicePrincipal

1. Copy the client Id from SQL Server and paste it in the OAuth Client Id field in Connect AI.

2. Copy the client secret from SQL Server and paste it in the OAuth Client Secret field in Connect AI.

3. Enter the Azure Tenant Id. This value is the directory Id in Azure Portal > Azure Active Directory > Properties. If not specified, the default tenant is used.

4. Connect AI Add SQL Server Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。

   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。

   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。

AzureServicePrincipalCert

1. Copy the OAuth JWT certificate store contents and paste it in the OAuth JWT Cert field. This is a multi-line key with the format shown.

2. Enter the Azure Tenant Id. This value is the directory Id in Azure Portal > Azure Active Directory > Properties. If not specified, the default tenant is used.

3. Enter the OAuth JWT Cert Password for your SQL Server account, if required.

4. Enter the OAuth JWT Cert Subject for your SQL Server account. This is the subject of the OAuth JWT certificate. If omitted, the first certificate in the certificate store is used.

5. Enter your OAuth Client Id assigned when you registered your SQL Server account.

SSH Tunnel Instructions

If your SQL Server data source is behind a firewall, follow these instructions.

1. Enable the setting Use SSH.

2. Enter the following information:

   • SSH Server–enter the name of the SSH server.

   • SSH Port–enter the SSH port. The default value is 22.

   • SSH Server Fingerprint–enter the fingerprint of the SSH server, which is the server’s digital Id badge. The fingerprint looks similar to the following: SHA256:WzAxzZkQ2d5G9V45T2x4FQncpJjUEwEvRQpz+sy9TxY.

   • SSH Auth Mode–enter the authentication mode of Password or Public_Key.

     • If Password, enter the SSH User name and SSH Password.

     • If Public_Key, enter the following:

       • SSH Client Cert–enter a valid private key.
       • SSH Client Cert Type–select the certificate type.
       • SSH Client Cert Password–(optional) enter if the SSH client certificate has a password.
       • SSH Client Cert Subject–(optional) enter the subject. If the certificate subject is omitted, the first certificate in the certificate store is used.

3. Continue with the authentication instructions.

詳細について

Connect AI とSQL Server の連携の詳細動作については、こちらのページを参照してください。