Cortex Analyst 管理者モニタリング

Cortex Analyst によって提供される回答の質を向上させるには、セマンティックモデルや表示を改良し続ける必要があります。モデルや表示を改良するために、 Cortex Analyst は、リクエストをSnowflakeデータベースのイベントテーブルにログします。

ログには以下が含まれます。

  • 質問したユーザー

  • 質問

  • 生成された SQL

  • エラーおよび/または警告

  • リクエスト本文と応答本文

  • その他のメタデータ

リクエストが行われてからビューに表示されるまでには、1～2分単位の小さなタイムラグがあります。

ログへのアクセス

これらのログは、Snowsightのセマンティックモデルの Monitoring タブで表示できます。ログを表示するには、ユーザーには以下の権限に加えて、参照テーブルに対する SELECT 権限が付与されている必要があります。

  • MONITOR or OWNERSHIP on the semantic view (when using semantic views)

  • ステージに対する WRITE 権限（ステージ上のファイルに格納されたセマンティックモデルの場合）

また、権限によっては、 SQL を使用してSnowflakeデータベースから直接ログをクエリすることもできます。

SQL によるログのクエリ

SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS テーブル関数を呼び出し、特定のセマンティックモデルやビューのログを取得します。このテーブル関数は、呼び出し元がリクエストデータにアクセスするために必要な 権限を持っていることを保証するために、アクセス制御チェックを実行します。

以下は関数の呼び出し方の例です。

SELECT * FROM TABLE(
  SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS(
    '<semantic_model_or_view_type>',
    '<semantic_model_or_view_name>'
  )
);
Copy

この関数を呼び出す際には、以下の引数を渡します。

  • semantic_model_or_view_type: リクエストで使用されるセマンティックモデルまたはビューのタイプを指定します。

    • ステージ上のファイルで定義されたセマンティックモデルには、 'FILE_ON_STAGE' を指定します。

    • セマンティック表示の場合は、 'SEMANTIC_VIEW' を指定します。

  • semantic_model_or_view_name: セマンティックモデルまたはビュー が定義されている場所を指定します。

    • ステージングされたファイルで定義されたセマンティックモデルについては、セマンティックモデル仕様ファイルへの完全修飾パスを指定します (例: @my_db.my_schema.my_stage/path/to/file.yaml)。

    • セマンティック・ビューの場合は、セマンティック・ビューの完全修飾名を指定します。

戻り値指定されたセマンティックモデルまたはビューに対する API リクエストをすべて含むテーブル。

インライン YAML（セマンティックビューまたはステージ上のファイルの代わりに）を使用してクエリが行われた場合、リクエストにはテーブル関数からはアクセスできませんが、以下で詳細を説明するビューとイベントテーブルに表示されます。

If you are using a role that has been granted the SNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN or SNOWFLAKE.CORTEX_ANALYST_REQUESTS_VIEWER application role, you can query the SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V view. This view includes all requests to Cortex Analyst across all semantic models and views.

You can also query the raw event data in the SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_RAW event table. The responses are in the OpenTelemetry format. The SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V view contains the same data, formatted and processed for human readability.

言語: 日本語