SHOW CLASSES¶
利用可能なすべてのクラスをリストします。
- こちらもご参照ください。
構文¶
SHOW CLASSES [ LIKE '<pattern>' ]
[ IN DATABASE [ <db_name> ] ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
パラメーター¶
LIKE 'pattern'オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（
%および_）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%testing%' ...... LIKE '%TESTING%' .... デフォルト: 値なし（フィルタリングは出力に非適用）。
IN DATABASE db_nameコマンドのスコープを指定します。コマンドのスコープは、コマンドが現在/指定されたデータベースのレコードのみを一覧表示するか、アカウント全体について表示するかを決定します。
DATABASEキーワードは必須ではありません。データベース名のみを指定してスコープを設定できます。同様に、セッションで現在使用中のデータベースがある場合、データベース名は必要ありません。デフォルト: セッションで現在使用中のデータベースがあるかどうかによって異なります。
データベース:
DATABASEがデフォルトです（つまり、コマンドはデータベースで表示する権限を持つオブジェクトを返します）。データベースなし:
ACCOUNTはデフォルトです（つまり、コマンドは、アカウントで表示する権限を持つオブジェクトを返します）。
STARTS WITH 'name_string'オプションで、オブジェクト名の先頭に表示される文字に基づいてコマンド出力をフィルタリングします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。
たとえば、次の文字列は 異なる 結果を返します。
... STARTS WITH 'B' ...... STARTS WITH 'b' .... デフォルト: 値なし（フィルターは出力に適用されない）
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'は結果を返します（入力文字列に一致する行がある場合）。
使用上の注意¶
ownerとowner_role_type列は値を返しません。
このコマンドは、実行中のウェアハウスを必要としません。
LIMIT rowsの値は10000を超えることはできません。LIMIT rowsが省略され、結果セットが10K行より大きい場合、コマンドはエラーになります。10Kを超える記録が存在する結果を表示するには、
LIMIT rowsを含めるか、 Snowflake Information Schema の対応するビューをクエリします。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。
例¶
Snowflakeデータベースのすべてのクラスを表示します。
SHOW CLASSES IN DATABASE SNOWFLAKE;
+-------------------------------+-----------------------+---------------+-------------+---------+---------+-------+------------------+-----------------+
| created_on | name | database_name | schema_name | version | comment | owner | is_service_class | owner_role_type |
|-------------------------------+-----------------------+---------------+-------------+---------+---------+-------|------------------|-----------------+
| 2023-04-17 11:48:31.222 -0700 | ANOMALY_DETECTION | SNOWFLAKE | ML | NULL | NULL | | false | |
| 2023-05-26 10:01:24.852 -0700 | FORECAST | SNOWFLAKE | ML | NULL | NULL | | false | |
+-------------------------------+-----------------------+---------------+-------------+---------+---------+-------+------------------+-----------------+