Cortex Analyst 管理者モニタリング

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

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

  • 質問したユーザー

  • 質問

  • 生成された SQL

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

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

  • その他のメタデータ

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

ログへのアクセス

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

  • セマンティックビューに対する OWNERSHIP（セマンティックビュー使用時）

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

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 の表示には、同じデータがより読みやすい形式で含まれています。

言語: 日本語