Snowflake Cortexで説明を生成する

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

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

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

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

  • DESCRIBE TABLE コマンドの出力。

  • Account Usage TABLES ビューの出力。

テーブル、ビュー、列の いずれかの権限 を持つユーザーは、保存後に説明を表示することができます。

注釈

Snowflake Cortexを使用し、ストアドプロシージャを呼び出してオブジェクト記述をプログラムで生成することもできます。詳細については、 SQLを使用してオブジェクトの説明を自動的に生成する をご参照ください。

機能へのアクセス

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

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

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

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

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

  • すべてのテーブルタイプ

  • ビュー

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

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

Snowflake Cortexによる説明文の作成、編集、保存

Snowflake Cortex Powered Descriptionsを生成および編集する手順は以下のとおりです。

説明の生成と保存

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

  1. |sf-web-interface-link|必要な権限を持つユーザーとして :ref:` にサインイン <label-cortex_descriptions_access_control>` します。

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

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

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

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

  6. Save を選択します。

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

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

  1. |sf-web-interface-link|必要な権限を持つユーザーとして :ref:` にサインイン <label-cortex_descriptions_access_control>` します。

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

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

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

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

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

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

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

  9. Save を選択します。

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

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

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

  1. |sf-web-interface-link|必要な権限を持つユーザーとして :ref:` にサインイン <label-cortex_descriptions_access_control>` します。

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

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

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

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

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

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

  8. Save を選択します。

既存の記述を上書きする

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

  1. |sf-web-interface-link|必要な権限を持つユーザーとして :ref:` にサインイン <label-cortex_descriptions_access_control>` します。

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

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

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

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

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

  5. Save を選択します。

保存せずに説明を生成

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

  1. |sf-web-interface-link|必要な権限を持つユーザーとして :ref:` にサインイン <label-cortex_descriptions_access_control>` します。

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

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

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

注釈

Describe Table ボタンを選択すると、テーブルの所有者は生成された説明を保存できません。テーブルの所有者として説明を編集して保存したい場合は、ページの Description セクションで Generate with Cortex を選択します。

アクセス制御の要件

ユーザーがCortex Powered Object Descriptions機能を使用するには、以下のすべてが必要です。

  • ウェアハウスの USAGE 権限。

  • SNOWFLAKE.CORTEX_USER データベースのロール でSnowflake Cortex を使用します。

  • 次のいずれかを使用します。

    • オブジェクトレベルの説明を生成するが保存しない場合は、オブジェクトに対する SELECT 権限。

    • オブジェクトと列の説明を生成し、*かつ*保存する場合は、オブジェクトに対する OWNERSHIP 権限。

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

USE ROLE ACCOUNTADMIN;
GRANT USAGE ON WAREHOUSE ai_wh TO ROLE my_role;
GRANT DATABASE ROLE SNOWFLAKE.CORTEX_USER TO ROLE my_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 として請求書に表示されます。

言語: 日本語