> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SQL Server

export const title_2 = "SQL Server";

export const title_1 = "SQL Server";

export const title_0 = "SQL Server";

## 前提条件

#### 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`～`10.255.255.255`
* `172.16.0.0`～`172.31.255.255`
* `192.168.0.0`～`192.168.255.255`
* `127.0.0.1`（別名 'localhost'）

## セットアップガイド

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

<Steps>
  <Step>
    Connect AI のナビゲーションメニューから**Sources** ページを開きます。
  </Step>

  <Step>
    右上の **+ Add Connection** をクリックします。
  </Step>

  <Step>
    検索フィールドに *SQL Server* と入力し、データソース名をクリックします。
  </Step>

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

  <Step>
    SQL Server を実行する **Server** のホスト名または IP アドレスを入力します。
  </Step>

  <Step>
    **Port** フィールドに SQL Server への接続用ポートを入力します。
  </Step>

  <Step>
    接続先の **Database** 名を入力します。
  </Step>

  <Step>
    **Encrypt** で暗号化方式を選択します。**True**（オプション暗号化）、**Strict**（必須暗号化）、または暗号化なしから選択できます。
  </Step>

  <Step>
    SQL Server コネクションがファイアウォール内にある場合は、**Use SSH** 設定を有効にし、[SSH トンネルの手順](#ssh-tunnel-instructions)に従います。その後、認証手順に進みます。それ以外の場合は **Use SSH** をオフのままにします。
  </Step>

  <Step>
    認証方法を選択し、該当するセクションに進んで手順に従います。
  </Step>
</Steps>

## 認証方法

<Tabs>
  <Tab title="Password">
    <Steps>
      <Step>
        **User** フィールドに、認証用の SQL Server ユーザー名を入力します。
      </Step>

      <Step>
        **Password** フィールドにユーザーパスワードを入力します。
      </Step>

      <Step>
        Connect AI **Add {title_0} Connection** ページ上部の、**Save & Test** をクリックします。

        * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
        * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
        * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="AzurePassword">
    <Steps>
      <Step>
        **User** フィールドに、認証用の SQL Server ユーザー名を入力します。
      </Step>

      <Step>
        **Password** フィールドにユーザーパスワードを入力します。
      </Step>
    </Steps>
  </Tab>

  <Tab title="AzureAD">
    <Steps>
      <Step>
        **Azure Tenant** Id を入力します。この値は **Azure Portal** > **Azure Active Directory** > **Properties** のディレクトリ Id です。指定しない場合はデフォルトテナントが使用されます。
      </Step>

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

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

      <Step>
        Connect AI **Add {title_1} Connection** ページ上部の、**Save & Test** をクリックします。

        * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
        * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
        * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="AzureServicePrincipal">
    <Steps>
      <Step>
        SQL Server からクライアント Id をコピーし、Connect AI の **OAuth Client Id** フィールドに貼り付けます。
      </Step>

      <Step>
        SQL Server からクライアントシークレットをコピーし、Connect AI の **OAuth Client Secret** フィールドに貼り付けます。
      </Step>

      <Step>
        **Azure Tenant** Id を入力します。この値は **Azure Portal** > **Azure Active Directory** > **Properties** のディレクトリ Id です。指定しない場合はデフォルトテナントが使用されます。
      </Step>

      <Step>
        Connect AI **Add {title_2} Connection** ページ上部の、**Save & Test** をクリックします。

        * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
        * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
        * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="AzureServicePrincipalCert">
    <Steps>
      <Step>
        OAuth JWT 証明書ストアの内容をコピーし、**OAuth JWT Cert** フィールドに貼り付けます。これは表示されている形式の複数行にわたるキーです。
      </Step>

      <Step>
        **Azure Tenant** Id を入力します。この値は **Azure Portal** > **Azure Active Directory** > **Properties** のディレクトリ Id です。指定しない場合はデフォルトテナントが使用されます。
      </Step>

      <Step>
        必要に応じて、SQL Server アカウントの **OAuth JWT Cert Password** を入力します。
      </Step>

      <Step>
        SQL Server アカウントの **OAuth JWT Cert Subject** を入力します。これは OAuth JWT 証明書のサブジェクトです。省略した場合、証明書ストアの最初の証明書が使用されます。
      </Step>

      <Step>
        SQL Server アカウントを登録した際に割り当てられた **OAuth Client Id** を入力します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## SSH トンネルの手順

SQL Server データソースがファイアウォール内にある場合は、以下の手順に従います。

<Steps>
  <Step>
    **Use SSH** 設定を有効にします。
  </Step>

  <Step>
    以下の情報を入力します：

    * **SSH Server**–SSH サーバー名を入力します。
    * **SSH Port**–SSH ポートを入力します。デフォルト値は 22 です。
    * **SSH Server Fingerprint**–SSH サーバーのフィンガープリント（サーバーのデジタル ID バッジ）を入力します。フィンガープリントは次のような形式です：`SHA256:WzAxzZkQ2d5G9V45T2x4FQncpJjUEwEvRQpz+sy9TxY`。
    * **SSH Auth Mode**–認証モードとして **Password** または **Public\_Key** を入力します。
      * **Password** の場合は、**SSH User** 名と **SSH Password** を入力します。
      * **Public\_Key** の場合は、以下を入力します：
        * **SSH Client Cert**–有効な秘密鍵を入力します。
        * **SSH Client Cert Type**–証明書タイプを選択します。
        * **SSH Client Cert Password**–（オプション）SSH クライアント証明書にパスワードが設定されている場合に入力します。
        * **SSH Client Cert Subject**–（オプション）サブジェクトを入力します。証明書サブジェクトを省略した場合、証明書ストアの最初の証明書が使用されます。
  </Step>

  <Step>
    認証手順を続けます。
  </Step>
</Steps>

## Connect Gateway の接続

SQL Server は、オンプレミスのデータと Connect AI の間を橋渡しする Connect Gateway でサポートされているコネクタです。詳細については、[Connect Gateway](/ja/Connect-Gateway) をご覧ください。ゲートウェイの設定が完了したら、**Connect Gateway** の**Connection Type** を選択します。その後、ゲートウェイの **Location Name** と SQL Server の認証情報を入力してください。

## 詳細について

Connect AI とSQL Server の連携の詳細動作については、[こちらのページ](https://cdn.cdata.com/help/RUM/jp/cloud/default.htm#default)を参照してください。
