SHOW ALERTS¶

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

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

こちらもご参照ください。: CREATE ALERT、 ALTER ALERT、 DROP ALERT、 DESCRIBE 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 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

例¶

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