SHOW APPLICATION ROLES¶

構文¶

SHOW APPLICATION ROLES IN APPLICATION <name>
  [ LIKE <pattern> ] [ LIMIT <rows> [ FROM '<name_string>' ] ]

必須パラメーター¶

name

表示するアプリケーションロールのアプリケーションを指定します。

オプションのパラメーター¶

LIKE 'pattern'

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

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

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

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

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

LIMIT rows [ FROM 'name_string' ]

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

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

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

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

デフォルト：値なし（出力に制限は適用されない）

注釈

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

さらに、オブジェクトは名前の辞書式順序で返されるため、 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' は結果を返します（入力文字列に一致する行がある場合）。

使用上の注意¶

• このコマンドの出力は、 SNOWFLAKE を owner 列に表示します。

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

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

例¶

SHOW APPLICATION ROLES IN APPLICATION hello_snowflake_app;

app_role2 という最初のアプリケーションロールの後に、 myapp という名前のアプリケーションにあるアプリケーションロールを最大10個返します。

SHOW APPLICATION ROLES IN APPLICATION myapp LIMIT 10 FROM 'app_role2';