snow object list¶
指定された型の利用可能なすべてのSnowflakeオブジェクトを一覧表示します。サポートされている型: コンピューティングプール、データベース、外部アクセス統合、関数、gitリポジトリ、イメージリポジトリ、統合、ネットワークルール、プロシージャ、ロール、スキーマ、シークレット、サービス、ステージ、ストリーム、Streamlit、テーブル、タスク、ユーザー、ビュー、ウェアハウス
構文¶
snow object list
<object_type>
--like <like>
--in <scope>
--connection <connection>
--host <host>
--port <port>
--account <account>
--user <user>
--password <password>
--authenticator <authenticator>
--private-key-file <private_key_file>
--token-file-path <token_file_path>
--database <database>
--schema <schema>
--role <role>
--warehouse <warehouse>
--temporary-connection
--mfa-passcode <mfa_passcode>
--enable-diag
--diag-log-path <diag_log_path>
--diag-allowlist-path <diag_allowlist_path>
--format <format>
--verbose
--debug
--silent
引数¶
object_type
オブジェクトの型。例: テーブル、データベース、コンピューティングプール。
オプション¶
--like, -l TEXT
名前でオブジェクトをフィルタリングするための SQL LIKE パターン。たとえば、
list function --like "my%"
は「my」で始まるすべての関数を一覧表示します。デフォルト: %%--in <TEXT TEXT>...
'--in <scope> <name>' を使用してこのコマンドのスコープを指定します。例:
list table --in database my_db
。オブジェクト型によっては、特殊なスコープを持つものがあります(例: list service --in compute-pool my_pool)。デフォルト: (None, None)。--connection, -c, --environment TEXT
config.toml
ファイルで定義されている接続の名前。デフォルト:デフォルト
--host TEXT
接続用のホストアドレス。接続に指定された値を上書きします。
--port INTEGER
接続のポート。接続に指定された値を上書きします。
--account, --accountname TEXT
Snowflakeアカウントに割り当てられた名前。接続に指定された値を上書きします。
--user, --username TEXT
Snowflakeに接続するユーザー名。接続に指定された値を上書きします。
--password TEXT
Snowflakeのパスワード。接続に指定された値を上書きします。
--authenticator TEXT
Snowflakeの認証コード。接続に指定された値を上書きします。
--private-key-file, --private-key-path TEXT
Snowflake プライベートキーファイルへのパス。接続に指定された値を上書きします。
--token-file-path TEXT
Snowflake に接続する際に使用する OAuth トークンを含むファイルへのパス。
--database, --dbname TEXT
使用するデータベース。接続に指定された値を上書きします。
--schema, --schemaname TEXT
使用するデータベーススキーマ。接続に指定された値を上書きします。
--role, --rolename TEXT
使用するロール。接続に指定された値を上書きします。
--warehouse TEXT
使用するウェアハウス名。接続に指定された値を上書きします。
--temporary-connection, -x
構成で定義された接続ではなく、コマンドラインパラメーターで定義された接続を使用します。デフォルト: false。
--mfa-passcode TEXT
多要素認証(MFA)に使用するトークン。
--enable-diag
Pythonコネクター診断テストを実行します。デフォルト: false。
--diag-log-path TEXT
診断レポートパス。デフォルト: <temporary_directory>
--diag-allowlist-path TEXT
オプションの許可リストへの診断レポートパス。
--format [TABLE|JSON]
出力形式を指定します。デフォルト: TABLE
--verbose, -v
ログレベル
info
以上のログエントリを表示します。デフォルト: false。--debug
ログレベル
debug
以上のログ エントリを表示します。デバッグログには追加情報が含まれます。デフォルト: false。--silent
コンソールへの中間出力をオフにします。デフォルト: false。
--help
このコマンドのヘルプテキストを表示します。
使用上の注意¶
--like [-l] <pattern>
オプションを使用すると、、オブジェクトを名前でフィルタリングするための SQL LIKE パターンを指定できます。たとえば、 snow object list function --like "my%"
は my で始まるすべての関数を一覧表示します。SQL パターン構文の詳細については、 SQL LIKE キーワード をご参照ください。
例¶
以下の例では、 public で始まるすべてのロールを一覧表示しています。 --like
オプション
snow object list role --like public%
show roles like 'public%'
+-------------------------------------------------------------------------------
| created_on | name | is_default | is_current | ...
|----------------------------------+-------------+------------+------------+----
| 2023-02-01 15:25:04.105000-08:00 | PUBLIC | N | N | ...
| 2024-01-15 12:55:05.840000-08:00 | PUBLIC_TEST | N | N | ...
+-------------------------------------------------------------------------------