Cortex Analyst 管理者モニタリング

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

この機能は現在、ステージに保存されたセマンティックモデル (リクエスト本文で semantic_model_file フィールドで指定) とセマンティックビュー (semantic_view フィールドで指定) に対してのみ利用可能です。

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

  • 質問したユーザー

  • 質問

  • 生成された SQL

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

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

  • その他のメタデータ

ログへのアクセス

これらのログは、Snowsightのセマンティックモデルの Monitoring タブで表示できます。ユーザーがログを表示するには、ステージ上での WRITE 権限、参照テーブル上での SELECT 権限が必要です。

また、権限によっては、 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 リクエストをすべて含むテーブル。

SNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN アプリケーション・ロールが付与されたロールを使用している場合、 SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V ビューをクエリできます。この表示には、すべてのセマンティックモデルとビューにわたる Cortex Analyst へのすべてのリクエストが含まれます。

SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_RAW イベントテーブルの生イベントデータをクエリすることもできます。応答はオープンテレメトリー形式です。なお、 SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V の表示には、同じデータがより読みやすい形式で含まれています。