SHOW DATABASES¶
アカウント全体でアクセス権限があるデータベースをリストします。これには、まだTime Travel保持期間内にあるため削除できないデータベースも含まれます。
出力は、データベース名で辞書順に並べられたデータベースのメタデータとプロパティを返します。これは、提供されたフィルターを使用して結果をフィルターする場合に注意することが重要です。
Tip
SQL 以外にも、 Snowflake REST APIs、 Snowflake Python APIs、 Snowflake CLI などのインターフェイスを使うことができます。 代替インターフェイス をご参照ください。
- こちらもご参照ください。
CREATE DATABASE、 ALTER DATABASE、 DESCRIBE DATABASE、 DROP DATABASE、 UNDROP DATABASE
DATABASES ビュー （情報スキーマ）
構文¶
SHOW [ TERSE ] DATABASES [ HISTORY ] [ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
[ WITH PRIVILEGES <object_privilege> [ , <object_privilege> [ , ... ] ] ]
パラメーター¶
TERSEオプションで、次の列のみを含む出力を返します。
created_onnamekinddatabase_nameschema_name
列はデータベースに適用されないため、
kind、database_name、 およびschema_nameは常にNULLを表示することに注意してください。デフォルト：値なし（出力にすべての列を含む）
HISTORYオプションで、まだパージされていない（つまり、それぞれのTime Travel保持期間内にある）ドロップされたデータベースが含まれます。ドロップされたデータベースの複数のバージョンが存在する場合、出力には各バージョンの行が表示されます。出力には、追加の
dropped_on列も含まれ、次を表示します：日付とタイムスタンプ（ドロップされたデータベースの場合）。
NULL（アクティブなデータベースの場合）。
デフォルト：値なし（ドロップされたデータベースは出力に 含まれない）
LIKE 'pattern'オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（
%および_）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%testing%' ...... LIKE '%TESTING%' .... デフォルト: 値なし（フィルタリングは出力に非適用）。
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'は結果を返します（入力文字列に一致する行がある場合）。
WITH PRIVILEGES object_privilege [ , object_privilege [ , ... ] ]オプションで、現在のユーザーの アクティブなロール が、オブジェクトのリストで指定されたすべての権限を付与されているオブジェクトに行を制限します。
CREATE <オブジェクト> 権限が権限リストに含まれている場合、コマンドはセカンダリ・ロールに権限が付与されているオブジェクトを除外します。これは、プライマリ・ロールだけがオブジェクトを作成する権限を持っているからです。詳細については、 施行モデル: プライマリロールおよびセカンダリロール をご参照ください。
使用上の注意¶
このコマンドは、稼働中のウェアハウスを必要としません。
LIMIT rowsの値は10000を超えることはできません。LIMIT rowsが省略され、結果セットが10K行より大きい場合、コマンドはエラーになります。10Kを超える記録が存在する結果を表示するには、
LIMIT rowsを含めるか、 Snowflake Information Schema の対応するビューをクエリします。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。
HISTORYとWITH PRIVILEGES句は相互に排他的です。同じステートメントで両方を使用することはできません。個人データベース の場合、
kind列の値はPERSONAL DATABASEです。
例¶
アカウントで表示する権限を持つすべてのデータベースを表示します。
SHOW DATABASES;
+---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+----------+----------+-----------------+
| created_on | name | is_default | is_current | origin | owner | comment | options | retention_time | kind | budget | owner_role_type |
|---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+----------+----------| |
| Tue, 17 Mar 2015 16:57:04 -0700 | MYTESTDB | N | Y | | PUBLIC | | | 1 | STANDARD | NULL | ROLE |
| Wed, 25 Feb 2015 17:30:04 -0800 | SALES1 | N | N | | PUBLIC | | | 1 | STANDARD | NULL | ROLE |
| Fri, 13 Feb 2015 19:21:49 -0800 | DEMO1 | N | N | | PUBLIC | | | 1 | STANDARD | MYBUDGET | ROLE |
+---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+----------+----------+-----------------+
ドロップされたデータベースを含む、システムで表示する権限を持つすべてのデータベースを表示します（この例は DROP DATABASE の例に基づいています）。
SHOW DATABASES HISTORY;
+---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+---------------------------------+----------+----------+-----------------+
| created_on | name | is_default | is_current | origin | owner | comment | options | retention_time | dropped_on | kind | budget | owner_role_type |
|---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+---------------------------------|----------+----------|-----------------|
| Tue, 17 Mar 2015 16:57:04 -0700 | MYTESTDB | N | Y | | PUBLIC | | | 1 | [NULL] | STANDARD | NULL | ROLE |
| Wed, 25 Feb 2015 17:30:04 -0800 | SALES1 | N | N | | PUBLIC | | | 1 | [NULL] | STANDARD | NULL | ROLE |
| Fri, 13 Feb 2015 19:21:49 -0800 | DEMO1 | N | N | | PUBLIC | | | 1 | [NULL] | STANDARD | MYBUDGET | ROLE |
| Wed, 25 Feb 2015 16:16:54 -0800 | MYTESTDB2 | N | N | | PUBLIC | | | 1 | Fri, 13 May 2016 17:35:09 -0700 | STANDARD | NULL | ROLE |
+---------------------------------+-----------+------------+------------+--------+--------+---------+---------+----------------+---------------------------------+----------+----------+-----------------+
USAGE、 MODIFY 権限を与えられているすべてのデータベースを表示します。
SHOW DATABASES WITH PRIVILEGES USAGE, MODIFY;
+-------------------------------+-----------------------------------------------------------+------------+------------+-----------------------------------------------------------+--------------+---------+---------+----------------+-------------------+--------------+-----------------+
| created_on | name | is_default | is_current | origin | owner | comment | options | retention_time | kind | budget | owner_role_type |
|-------------------------------+-----------------------------------------------------------+------------+------------+-----------------------------------------------------------+--------------+---------+---------+----------------+-------------------+--------------+-----------------|
| 2023-01-27 14:33:11.417 -0800 | BOOKS_DB | N | N | | DATA_ADMIN | | | 1 | STANDARD | NULL | ROLE |
| 2023-09-15 15:22:51.111 -0700 | TEST_DB | N | N | | ACCOUNTADMIN | | | 4 | STANDARD | TEST_BUDGET | ROLE |
| 2023-08-18 13:33:01.024 -0700 | SNOWFLAKE | N | N | SNOWFLAKE.ACCOUNT_USAGE | | | | 0 | APPLICATION | NULL | |
+-------------------------------+-----------------------------------------------------------+------------+------------+-----------------------------------------------------------+--------------+---------+---------+----------------+-------------------+--------------+-----------------+
代替インターフェイス¶
Snowflake REST APIs
データベースをリストする エンドポイント
Snowflake Python APIs
Snowflake CLI
snow object list コマンド