SHOW MODEL MONITORS

現在のスキーマまたは指定したスキーマでアクセスできるすべての モデルモニター をリストし、それぞれの情報を表示します。

こちらもご参照ください。

CREATE MODEL MONITOR、 ALTER MODEL MONITOR、 DESCRIBE MODEL MONITOR、 DROP MODEL MONITOR

構文

SHOW MODEL MONITORS
[ LIKE <pattern> ]
[ IN
    {
      ACCOUNT                  |

      DATABASE                 |
      DATABASE <database_name> |

      SCHEMA                   |
      SCHEMA <schema_name>     |
      <schema_name>
    }
 ]
Copy

パラメーター

LIKE 'pattern'

オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（% および _）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは 同じ 結果を返します。

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. デフォルト: 値なし（フィルタリングは出力に非適用）。

[ IN ... ]

オプションで、コマンドのスコープを指定します。次のいずれかを指定します。

ACCOUNT

アカウント全体の記録を返します。

DATABASE、 . DATABASE db_name

現在使用中のデータベースまたは指定されたデータベース（db_name）の記録を返します。

db_name なしで DATABASE を指定し、かつデータベースが使用されていない場合、キーワードは出力に影響しません。

SCHEMA、 . SCHEMA schema_name、 . schema_name

現在使用中のスキーマまたは指定されたスキーマ（schema_name）の記録を返します。

データベースが使用中の場合、または完全修飾 schema_name （例: db.schema） を指定する場合、 SCHEMA はオプションです。

データベースが使用されていない場合は、 SCHEMA を指定しても出力には影響しません。

デフォルト: セッションで現在使用中のデータベースがあるかどうかによって異なります。

  • データベース: DATABASE がデフォルトです（つまり、コマンドはデータベースで表示する権限を持つオブジェクトを返します）。

  • データベースなし: ACCOUNT はデフォルトです（つまり、コマンドは、アカウントで表示する権限を持つオブジェクトを返します）。

出力

コマンド出力では、モデルモニターのプロパティとメタデータが以下の列で提供されます。

列

説明

created_on

モデルモニターが作成された日時。

name

モデルモニターの名前。

database_name

モデルモニターが格納されているデータベース。

schema_name

モデルモニターが格納されているスキーマ。

warehouse_name

モデルをモニターするために使用されるウェアハウス。

refresh_interval

モデルモニターのリフレッシュをトリガーするリフレッシュ間隔（ターゲットラグ）。

aggregation_window

メトリックを計算するための集計ウィンドウ。

model_task

モニター対象モデルのタスク。 TABULAR_BINARY_CLASSIFICATION または TABULAR_REGRESSION のいずれか。

monitor_state

モデルモニターの状態。

  • ACTIVE: モデルモニターはアクティブで、正しく動作しています。

  • SUSPENDED: モデルのモニタリングを中断します。

  • PARTIALLY_SUSPENDED: 基になるテーブルの1つが期待される間隔でリフレッシュを停止したエラー状態。詳細については、 DESCRIBE をご参照ください。

  • UNKNOWN: 基になるテーブルの状態を識別できないエラー状態。

source

集計の基になる、ソーステーブルまたはビューの詳細を示す JSON オブジェクトの文字列表現。テーブルが存在しないかアクセスできない場合、値は空文字列となります。 テーブル JSON オブジェクトの指定 をご参照ください。

baseline

JSON オブジェクトの文字列表現で、モニタリングに使用されるベースラインテーブルの詳細。このオブジェクトのクローンがモデルモニターのオブジェクトに組み込まれています。 テーブル JSON オブジェクトの指定 をご参照ください。

model

JSON オブジェクトの文字列表現で、モニター対象のモデル固有の情報を含みます。 モデル JSON オブジェクトの指定 をご参照ください。

comment

モデルモニターについてのコメント。

テーブル JSON オブジェクトの指定

以下は、コマンド出力にある source と baseline 列で使用される、テーブル、ビュー、または他のテーブルのようなオブジェクトの JSON 表現の例です。

name

ソースまたはベースラインのテーブルまたはビューの名前。

database_name

テーブルまたはビューが格納されているデータベース。

schema_name

テーブルまたはビューが格納されているスキーマ。

status

テーブルのステータス。

  • ACTIVE: ユーザーがアクセスできるテーブルまたはビュー。

  • MASKED: 現在のユーザーは、テーブルまたはビューにアクセスできません。他のフィールドの値はマスキングされて表示されます（つまり、一連のアスタリスクとして）。

  • DELETED: テーブルまたはビューが削除されました。

  • NOT_SET: プロパティは設定されていません。ベースラインデータにのみ適用されます。

モデル JSON オブジェクトの指定

以下は、コマンド出力の model 列で使用される、モデルの JSON 表現の例です。

フィールド

説明

model_name

モニター対象のモデル名。

version_name

モニター対象のモデルバージョンのバージョン名。

function_name

指定されたモデルバージョンでモニターされている特定の関数の名前。

database_name

モデルが格納されているデータベース。

schema_name

モデルが格納されているスキーマ。

model_status

モデルのステータス。ACTIVE、 MASKED、 DELETED のいずれか。MASKED は、ユーザーがそのモデルにアクセスできないことを示します。他のフィールドはアスタリスクで表示されます。

version_status

モデルバージョンのステータス。ACTIVE または DELETED。（MASKED はアクセス制御ができないため、モデルバージョンとしては有効なステータスではありません。）

アクセス制御の要件

権限

ターゲット

指定なし

モデルモニター
言語: 日本語