Snowflake Cortexで説明を生成する

Snowsight で、Snowflake Cortexのパワーを使用して、列、テーブル、または表示の説明を自動的に生成することができます。Snowflake Cortexは、Snowflakeがホストする大容量言語モデル(LLMs)を活用して、オブジェクトのメタデータを評価し、必要であればサンプルデータを使用して記述を生成します。

生成された説明は、列、テーブル、またはビューの COMMENT プロパティに保存されます。説明文は、 COMMENT プロパティが表示されているところならどこでも表示できます。

  • Snowsight の Table Details タブと View Details タブ。

  • Snowsight のテーブルまたはビューの Columns タブ。

  • DESCRIBE TABLE コマンドの出力。

  • Account Usage TABLES ビューの出力。

テーブルやビューに対して なんらかの権限 を持つユーザーは、所有者が説明を生成した後、テーブル、ビュー、列の説明を表示することができます。

機能へのアクセス

Snowflake Cortexで説明を生成する機能を見るには、以下の両方がtrueである必要があります。

  • 必要なアクセス制御権限 を持っている必要があります。

  • リージョンは、Snowflake Cortex が記述を生成するために使用する LLM をサポートしている必要があります。必要な権限があるにもかかわらず、この機能が表示されない場合は、 COMPLETE 関数の可用性 を確認してください。COMPLETE 関数がリージョンでサポートされていない場合、この機能を使用するには クロスリージョン推論 を有効にする必要があります。

サポートされているオブジェクト

以下のオブジェクトの説明を生成できます。

  • テーブル

  • ビュー

  • マテリアライズドビュー

  • テーブルや表示内の列。

Snowflake Cortexによる説明文の作成と編集

列、テーブル、およびビューのSnowflake Cortex Powered Descriptionを生成および編集する手順は、以下のサブセクションにあります。

テーブルとビューの説明の作成

テーブルまたはビューの説明を生成するには、以下のようにします。

  1. 必要な権限を持つユーザーとして |sf-web-interface| にサインイン します。

  2. 説明を生成するテーブルまたは表示に移動します。

  3. プロンプトが表示されたら、ウェアハウスを選択します。

  4. Table Details タブまたは View Details タブで、 Generate with Cortex を選択します。

  5. 説明を編集したい場合は、鉛筆のアイコンを選択し、説明を編集します。

  6. Save を選択します。

すべての列の説明を一度に作成

Snowsight を使えば、一度に複数の列の説明を生成することができます。単一のアクションでテーブルまたはビューのすべての列の説明を生成するには、次のようにします。

  1. 必要な権限を持つユーザーとして |sf-web-interface| にサインイン します。

  2. 列を含むテーブルまたは表示に移動します。

  3. プロンプトが表示されたら、ウェアハウスを選択します。

  4. Columns タブを選択します。

  5. ツールバーの Generate Descriptions を選択します。

  6. プロンプトが表示されたら、 サンプルデータ を使用するかどうかを決定します。

  7. 説明を編集したい場合は、鉛筆のアイコンを選択します。

  8. 保存したい列を選択します。

  9. Save を選択します。

  10. テーブルまたは表示の列数が50を超え、残りの列の説明を生成したい場合は、このプロセスを繰り返します。

単一の列の説明を作成します。

単一の列の説明を生成するには、次のようにします。

  1. 必要な権限を持つユーザーとして |sf-web-interface| にサインイン します。

  2. 列を含むテーブルまたは表示に移動します。

  3. プロンプトが表示されたら、ウェアハウスを選択します。

  4. Columns タブを選択します。

  5. 列を見つけ、 Description 列のその行にカーソルを合わせ、 Generate with Cortex を選択します。

  6. プロンプトが表示されたら、 サンプルデータ を使用するかどうかを決定します。

  7. 説明を編集したい場合は、鉛筆のアイコンを選択します。

  8. Save を選択します。

既存の記述を上書きする

ユーザー指定の説明を生成された記述に置き換えるには、以下のようにします。

  1. 必要な権限を持つユーザーとして |sf-web-interface| にサインイン します。

  2. 説明を編集するテーブルまたは表示に移動します。

  3. まだ使用されていないウェアハウスを選択してください。

  4. テーブル、表示、列の説明を編集します。

    • 表と表示： Table Details タブで、鉛筆アイコンを選択して既存の説明を編集し、 Generate with Cortex を選択します。

    • 列： Columns タブで、既存の説明の鉛筆アイコンを選択し、 Generate with Cortex を選択します。

  5. Save を選択します。

アクセス制御の要件

ユーザーがSnowflake Cortexで説明を生成するには、以下のすべてが必要です。

例えば、 table_owner_role ロールを持つユーザーにテーブルの説明を生成させるために、アカウント管理者は以下を実行できます。

USE ROLE ACCOUNTADMIN;
GRANT USAGE ON WAREHOUSE ai_wh TO ROLE table_owner_role;
GRANT DATABASE ROLE SNOWFLAKE.CORTEX_USER TO ROLE table_owner_role;
Copy

サンプルデータ入力

列の説明を生成する際、メタデータのみに頼ることもできますが、Snowflake Cortex Powered Descriptionを改善するためにサンプルデータを使用することもできます。サンプルデータとは、Snowflake Cortexを使用して記述を生成する際に評価される特定の列内のデータのことです。サンプルデータの使用を選択した場合、Snowflakeはサンプルデータの一部を使用して説明を生成するため、より正確な説明につながります。サンプルデータは使用データとしてSnowflakeに保存されません。

サンプルデータを使用するかどうかは、個々のユーザーによって異なります。ブラウザセッションで初めて列の説明を生成するとき、サンプルデータを使用するかどうかを決定するプロンプトが表示されます。ポップアップボックスのデフォルトはyesで、先に進む前にサンプルデータを無効にするかどうかを選択できます。お客様のブラウザは、 Snowflake セッション の間、この質問に対するお客様の回答を保存し、次回のセッションまで再度質問されることはありません。また、 ユーザープロファイル を使用して、サンプルデータを使用するかどうかを設定することもできます。

注釈

リージョンがSnowflake Cortexをサポートしている場合、サンプルデータはリージョンの境界を越えることができます。詳細については、 機能へのアクセス をご参照ください。

コストの考慮事項

説明文の作成には以下のコストがかかります。

  • 使用中のウェアハウスで消費されたクレジット。

  • Mistral-7bやLlama 3.1-8bのような小型の LLMs、Snowflake Cortexを使用するためのクレジットチャージ。これらの請求は、Snowflake Cortex のすべての使用を含む AI-Services として請求書に表示されます。

言語: 日本語