SHOW ALERTS

アクセス権限を持っている アラート をリストします。このコマンドを使用して、現在の/指定されたデータベースまたはスキーマに対する、またはアカウント全体にわたって、アラートをリストできます。

出力は、データベース、スキーマ、およびアラート名によって辞書順に並べられたアラートメタデータとプロパティを返します(出力列の説明については、このトピックの 出力 を参照)。これは、提供されたフィルターを使用して結果をフィルターする場合に注意することが重要です。

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

CREATE ALERTALTER ALERTDROP ALERTDESCRIBE ALERT

構文

SHOW [ TERSE ] ALERTS [ LIKE '<pattern>' ]
                      [ IN { ACCOUNT |
                             DATABASE [ <db_name> ] |
                             [ SCHEMA ] [ <schema_name> ]
                           }
                      ]
                      [ STARTS WITH '<name_string>' ]
                      [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

パラメーター

TERSE

出力列のサブセットのみを返します。

  • created_on

  • name

  • kind (すべてのアラートで NULL を表示)

  • database_name

  • schema_name

  • schedule

  • state

LIKE 'pattern'

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

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

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
Copy
IN ACCOUNT | [ DATABASE ] {db_name} | [ SCHEMA ] {schema_name}

コマンドのスコープを指定します。これは、コマンドが現在/指定されたデータベースまたはスキーマのレコードのみを一覧表示するか、アカウント全体に表示するかを決定します。

DATABASE および SCHEMA キーワードは必須ではありません。データベースまたはスキーマ名のみを指定して、スコープを設定できます。同様に、セッションで現在使用中のデータベースがある場合、データベース名またはスキーマ名は必要ありません。

  • DATABASE または SCHEMA が名前なしで指定され、セッションで現在使用中のデータベースがない場合、パラメーターは出力に影響しません。

  • SCHEMA が名前で指定され、セッションで現在使用中のデータベースがない場合、スキーマ名はデータベース名で完全修飾する必要があります(例: testdb.testschema)。

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

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

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

STARTS WITH 'name_string'

オブジェクト名の先頭に表示される文字列に基づいてコマンド出力をフィルターします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。たとえば、次は異なる結果を返します。

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...
Copy
LIMIT rows [ FROM 'name_string' ]

オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。返される実際の行数は、指定された制限より少ない場合があります(例:既存のオブジェクトの数が指定された制限より少ない)。

オプションの FROM 'name_string' サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。

  • 文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します

  • 文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。

デフォルト:値なし(出力に制限は適用されない)

注釈

STARTS WITH 'name_string'FROM 'name_string' の両方は、同じステートメントで組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合は、相互にキャンセルされ、結果が返されません。

さらに、オブジェクトは名前の辞書式順序で返されるため、 FROM 'name_string' は、 STARTS WITH 'name_string' によって返される行よりも辞書式の値が大きい行のみを返します。

例:

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' は結果を返しません。

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' は結果を返しません。

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' は結果を返します(入力文字列に一致する行がある場合)。

出力

コマンド出力では、次の列にアラートのプロパティとメタデータが提供されます。

| created_on | name | database_name | schema_name | owner | comment | warehouse | schedule | state | condition | action |
Copy

説明

created_on

アラートが作成された日時。

name

アラートの名前。

database_name

アラートが格納されるデータベース。

schema_name

アラートが格納されるスキーマ。

owner

アラートを所有するロール(つまり、アラートに対する OWNERSHIP 権限を持つ)

comment

アラートのコメント。

warehouse

アラートを実行するために必要なリソースを提供するウェアハウス。

schedule

アラートの条件を評価するためのスケジュール。

state

アラートの状態を指定します。アラートには、次のいずれかの状態があります。

  • suspended

  • started

condition

アラートがトリガーされる条件として機能する SQL ステートメントのテキスト。

action

アラートがトリガーされたときに実行する必要がある SQL ステートメントのテキスト。

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、 最低 1 つ の次の 権限 が必要です。

権限

オブジェクト

メモ

OPERATE または OWNERSHIP

アラート

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • アラートの所有者(つまり、アラートに対する OWNERSHIP 権限を持つロール)またはアラートに対する OPERATE 権限を持つロールの行のみを返します。

  • このコマンドの実行には、稼働中のウェアハウスを必要としません。

  • LIMIT rows の値は 10000 を超えることはできません。 LIMIT rows が省略され、結果セットが10K行より大きい場合、コマンドはエラーになります。

  • このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

アラートに関する詳細の表示 をご参照ください。