> ## 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.

# Snowflake

export const title_4 = "Snowflake";

export const title_3 = "Snowflake";

export const title_2 = "Snowflake";

export const title_1 = "Snowflake";

export const title_0 = "Snowflake";

## 前提条件

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

Snowflake への接続を確立するには、CData のIP 経由でSnowflake へのアクセスを許可する必要があります。Snowflake をファイアウォールの内側でホスティングする場合は、これらの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`

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

パブリックフェイシング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'）

## セットアップガイド

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

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

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

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

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

  <Step>
    Snowflake の **Warehouse** を入力します。
  </Step>

  <Step>
    Snowflake データベースの **URL** を入力します。Snowflake は、アカウント名またはコネクション名のいずれかの形式の URL をサポートします。

    * アカウント名を使用するには、Snowflake ドキュメントの [アカウントの組織名およびアカウント名の確認](https://docs.snowflake.com/ja/user-guide/admin-account-identifier#label-account-name-find) を参照してください。
    * コネクション名を使用するには、[SHOW CONNECTIONS](https://docs.snowflake.com/ja/sql-reference/sql/show-connections) コマンドを使用します。
      URL の形式は接続方法によって異なります。URL を正しく入力するには、Snowflake ドキュメントの [URL を使用した接続](https://docs.snowflake.com/ja/user-guide/organizations-connect#connecting-with-a-url) を参照してください。
      URL の形式の例をいくつか以下に示します：
    * アカウント名を含む標準 URL：`https://<orgname>-<account_name>.snowflakecomputing.com`
    * コネクション名を含む標準 URL：`https://<orgname>-<connectionname>.snowflakecomputing.com`
    * Okta SSO：`https://<orgname>-<account-name>.snowflakecomputing.com`（アカウント名にアンダースコアが含まれている場合は、アンダースコアをハイフンに変更してください）。
  </Step>

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

  <Step>
    **Authentication Model** で、共有認証を許可するか、ユーザーに各自の認証情報を使用させるか（ユーザーごとの認証）を決定します。
  </Step>
</Steps>

## 認証方法

<Tabs>
  <Tab title="OAuth">
    <Steps>
      <Step>
        **User** フィールドに、Snowflake のユーザー名を入力します。
      </Step>

      <Step>
        **Callback URL**（リダイレクト URL）は、OAuth アプリのセットアップ時に必要となる URL（`https://oauth.cdata.com/oauth/`）です。この URL をコピーして、OAuth アプリに貼り付けます。
      </Step>

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

      <Step>
        OAuth 用の Snowflake アカウントの **OAuth Client Secret** を入力します。
      </Step>

      <Step>
        OAuth アプリケーションが Snowflake にリクエストする **OAuth Authenticator** を選択します。認証子がない場合は、デフォルトの **None** を使用します。
      </Step>

      <Step>
        （オプション）Snowflake の **Database** および **Schema** を入力します。スキーマを選択すると、一部のアプリケーションでパフォーマンスが向上することがあります。
      </Step>

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

      <Step>
        Snowflake アカウントにログインし、リクエストされた権限を設定します（該当する場合）。
      </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="Password">
    <Info>
      **重要：** "2024\_08" バンドル以降の新しい Snowflake アカウントは、Password 認証をサポートしなくなりました。OAuth または Private Key などの他の認証方法を使用してください。
    </Info>

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

      <Step>
        **Database** セクションに、接続する Snowflake データベースの名前を入力します。
      </Step>

      <Step>
        （オプション）接続する Snowflake データベースのスキーマを入力します。空白のままにすると、コネクタはデータベース内のすべてのスキーマにアクセスできます。
      </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>

      <Step>
        Snowflake で、Connect AI 静的IP アドレスを接続のホワイトリストに追加します。
      </Step>
    </Steps>
  </Tab>

  <Tab title="Private Key">
    プライベートキー認証を設定するには、以下の手順に従います：

    <Steps>
      <Step>
        Snowflake のキーファイル（.p8 で終わるファイル）をテキストエディタで開きます。
      </Step>

      <Step>
        ファイルの内容全体をコピーします。
      </Step>

      <Step>
        コピーしたプライベートキーの内容を **Private Key** フィールドに入力します。
      </Step>

      <Step>
        プライベートキーにパスワードが設定されている場合は、**Private Key Password** フィールドに入力します。
      </Step>

      <Step>
        ドロップダウンから正しい **Private Key Type** を選択します。
      </Step>

      <Step>
        **Database** セクションに、接続する Snowflake データベースの名前を入力します。
      </Step>

      <Step>
        （オプション）接続する Snowflake データベースのスキーマを入力します。空白のままにすると、コネクタはデータベース内のすべてのスキーマにアクセスできます。
      </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>

      <Step>
        Snowflake で、Connect AI 静的IP アドレスを接続のホワイトリストに追加します。
      </Step>
    </Steps>
  </Tab>

  <Tab title="Okta">
    <Steps>
      <Step>
        以下の情報を入力します：

        * **User**— Okta のユーザーアカウント。
        * **Password**— Okta アカウントに関連付けられたパスワード。
        * **MFA Passcode**— デバイスに送信された OTP コードを設定します。このプロパティは、Okta サインインで多要素認証が必要な場合にのみ使用してください。
        * **SSO Properties**— Okta への認証に必要です：
          * Domain：OKTA 組織のドメイン名を設定します。
          * MFAType（オプション）：多要素認証のタイプを設定します。このプロパティは、Okta サインインで MFA が必要な場合にのみ使用してください。このプロパティでは、以下のいずれかの値を指定できます：
            * OKTAVerify
            * Email
            * SMS
          * APIToken（オプション）：Okta によって作成された API トークンを設定します。これは、Okta クライアントのリクエストコンテキストを上書きする信頼できるアプリケーションまたはプロキシ経由でユーザーを認証する際に使用されます。
      </Step>

      <Step>
        **Database** セクションに、接続する Snowflake データベースの名前を入力します。
      </Step>

      <Step>
        （オプション）接続する Snowflake データベースのスキーマを入力します。空白のままにすると、コネクタはデータベース内のすべてのスキーマにアクセスできます。
      </Step>

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

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

      <Step>
        Snowflake で、Connect AI 静的IP アドレスを接続のホワイトリストに追加します。
      </Step>
    </Steps>
  </Tab>

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

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

      <Step>
        （オプション）**Proof Key** を入力します。ブラウザを使用せずに PingFederate に接続する場合は、これを指定する必要があります。
      </Step>

      <Step>
        （オプション）**External Token** を入力します。ブラウザを使用せずに PingFederate に接続する場合は、これを指定する必要があります。Proof Key と External Token の詳細については、[こちら](https://cdn.cdata.com/help/OWJ/jp/cloud/default.htm#RSBSnowflake_p_AuthScheme) の手順を参照してください。
      </Step>

      <Step>
        （オプション）**Database** と **Schema** を入力します。スキーマを選択すると、一部のアプリケーションでパフォーマンスが向上することがあります。
      </Step>

      <Step>
        Connect AI **Add {title_4} 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>
</Tabs>

## Connect Gateway の接続

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

## 詳細について

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