SHOW STREAMLITS¶

注意

この機能は AWS およびMicrosoft Azure商用リージョンのアカウントで利用できます。 AWS PrivateLink はサポートされていません。

アクセス権限を持っているSteamlitオブジェクトをリストします。

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

CREATE STREAMLIT、 DESCRIBE STREAMLIT、 ALTER STREAMLIT、 DROP STREAMLIT もご参照ください。

構文¶

SHOW [ TERSE ] STREAMLITS [ LIKE '<pattern>' ]
                          [ IN
                                {
                                  ACCOUNT                   |

                                  DATABASE                  |
                                  DATABASE <db_name>        |

                                  SCHEMA
                                  SCHEMA <schema_name>      |
                                  <schema_name>             |
                                }
                          ]
                          [ LIMIT <rows> [ FROM '<name_string>' ]

Copy

パラメーター¶

TERSE

出力列のサブセットのみを返します。

created_on
name
database_name
schema_name
url_id

LIKE 'pattern'

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

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

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

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

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

[ IN ... ]

オプションで、コマンドのスコープを指定します。次のいずれかを指定します。

ACCOUNT

アカウント全体の記録を返します。

DATABASE、 . DATABASE db_name

現在使用中のデータベースまたは指定されたデータベース（db_name）の記録を返します。

db_name なしで DATABASE を指定し、かつデータベースが使用されていない場合、キーワードは出力に影響しません。

SCHEMA、 . SCHEMA schema_name、 . schema_name

現在使用中のスキーマまたは指定されたスキーマ（schema_name）の記録を返します。

データベースが使用中の場合、または完全修飾 schema_name （例: db.schema）を指定する場合、 SCHEMA はオプションです。

データベースが使用されていない場合は、 SCHEMA を指定しても出力には影響しません。

デフォルト: セッションで現在使用中のデータベースがあるかどうかによって異なります。

データベース: DATABASE がデフォルトです（つまり、コマンドはデータベースで表示する権限を持つオブジェクトを返します）。
データベースなし: ACCOUNT はデフォルトです（つまり、コマンドは、アカウントで表示する権限を持つオブジェクトを返します）。

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' は結果を返します（入力文字列に一致する行がある場合）。

使用上の注意¶

このコマンドは、ドロップされたStreamlitオブジェクトはリストしません。
このコマンドの実行は、稼働中のウェアハウスを必要としません。

出力¶

コマンド出力は、Streamlitオブジェクトに関する情報を以下の列で提供します。

列	説明
`created_on`	Steamlitオブジェクトが作成された日時。
`name`	Streamlitオブジェクトの名前。
`database_name`	Streamlitオブジェクトが格納されているデータベース。
`schema_name`	Streamlitオブジェクトが格納されているスキーマ。
`owner`	Steamlitオブジェクトを所有するロール。
`comment`	Steamlitオブジェクトのコメント。
`root_location`	Streamlitオブジェクトのアプリケーションファイルのルート位置。
`main_file`	StreamlitオブジェクトのPythonファイルの名前。
`query_warehouse`	Streamlitアプリケーションが発行したクエリが実行されるウェアハウス。
`url_id`	Streamlitオブジェクトに関連付けられた一意の ID。
`owner_role_type`	オブジェクトを所有するロールのタイプ、 `ROLE` または `DATABASE_ROLE` のいずれか。 . Snowflake Native App がオブジェクトを所有する場合、値は `APPLICATION` になります。 . 削除されたオブジェクトには所有者ロールがないため、オブジェクトを削除した場合、Snowflakeは NULL を返します。