- カテゴリ:
SHOW DATABASES¶
アカウント全体でアクセス権限があるデータベースをリストします。これには、まだTime Travel保持期間内にあるため削除できないデータベースも含まれます。
出力は、データベース名で辞書順に並べられたデータベースのメタデータとプロパティを返します。これは、提供されたフィルターを使用して結果をフィルターする場合に注意することが重要です。
- こちらもご参照ください。
CREATE DATABASE、 ALTER DATABASE、 DROP DATABASE、 UNDROP DATABASE
DATABASES ビュー (情報スキーマ)
構文¶
SHOW [ TERSE ] DATABASES [ HISTORY ] [ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
パラメーター¶
TERSE
オプションで、次の列のみを含む出力を返します。
created_on
name
kind
database_name
schema_name
列はデータベースに適用されないため、
kind
、database_name
、 およびschema_name
は常にNULL
を表示することに注意してください。デフォルト:値なし(出力にすべての列を含む)
HISTORY
オプションで、まだパージされていない(つまり、それぞれのTime Travel保持期間内にある)ドロップされたデータベースが含まれます。ドロップされたデータベースの複数のバージョンが存在する場合、出力には各バージョンの行が表示されます。出力には、追加の
dropped_on
列も含まれ、次を表示します:日付とタイムスタンプ(ドロップされたデータベースの場合)。
NULL
(アクティブなデータベースの場合)。
デフォルト:値なし(ドロップされたデータベースは出力に 含まれない)
LIKE 'パターン'
オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字(
%
および_
)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
デフォルト:値なし(フィルタリングは適用されない)
STARTS WITH '名前文字列'
オプションで、オブジェクト名の先頭に表示される文字に基づいてコマンド出力をフィルタリングします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。たとえば、次の結果は 異なる 結果を返します。
... STARTS WITH 'B' ...
... STARTS WITH 'b' ...
デフォルト:値なし(フィルタリングは適用されない)
LIMIT 行 [ FROM '名前文字列' ]
オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。返される実際の行数は、指定された制限より少ない場合があることに注意してください(例えば、既存のオブジェクトの数が指定された制限より少ない)。
オプションの
FROM '名前文字列'
副次句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。
文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。
デフォルト:値なし(出力に制限は適用されない)
注釈
FROM '名前文字列'
とSTARTS WITH '名前文字列'
の両方を同じステートメントで組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合は、互いにキャンセルされ、結果が返されません。さらに、オブジェクトは名前の辞書式順序で返されるため、
FROM '名前文字列'
は、STARTS WITH '名前文字列'
によって返される行よりも辞書式の値が大きい行のみを返します。例:
... STARTS WITH 'A' LIMIT ... FROM 'B'
は結果を返しません。... STARTS WITH 'B' LIMIT ... FROM 'A'
は結果を返しません。... STARTS WITH 'A' LIMIT ... FROM 'AB'
は結果を返します(入力文字列に一致する行がある場合)。
使用上の注意¶
このコマンドは、実行中のウェアハウスを必要としません。
LIMIT 行
の値は10000
を超えることはできません。LIMIT 行
が省略され、結果セットが10K行より大きい場合、コマンドはエラーになります。10Kを超えるレコードが存在する結果を表示するには、
LIMIT 行
を含めるか、 Snowflake Information Schema の対応するビューをクエリします。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。
例¶
アカウントで表示する権限があるすべてのデータベースを表示します。
SHOW DATABASES; +---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+ | created_on | name | is_default | is_current | origin | owner | comment | options | retention_time | |---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+ | Tue, 17 Mar 2015 16:57:04 -0700 | MYTESTDB | N | Y | | PUBLIC | | | 1 | | Wed, 25 Feb 2015 17:30:04 -0800 | SALES1 | N | N | | PUBLIC | | | 1 | | Fri, 13 Feb 2015 19:21:49 -0800 | DEMO1 | N | N | | PUBLIC | | | 1 | +---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+
ドロップされたデータベースを含む、システムで表示する権限があるすべてのデータベースを表示します(この例は DROP DATABASE の例に基づいています)。
SHOW DATABASES HISTORY; +---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+---------------------------------+ | created_on | name | is_default | is_current | origin | owner | comment | options | retention_time | dropped_on | |---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+---------------------------------| | Tue, 17 Mar 2015 16:57:04 -0700 | MYTESTDB | N | Y | | PUBLIC | | | 1 | [NULL] | | Wed, 25 Feb 2015 17:30:04 -0800 | SALES1 | N | N | | PUBLIC | | | 1 | [NULL] | | Fri, 13 Feb 2015 19:21:49 -0800 | DEMO1 | N | N | | PUBLIC | | | 1 | [NULL] | | Wed, 25 Feb 2015 16:16:54 -0800 | MYTESTDB2 | N | N | | PUBLIC | | | 1 | Fri, 13 May 2016 17:35:09 -0700 | +---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+---------------------------------+