snow object stage list

Lists the stage contents.

Syntax

snow object stage list
  <stage_name>
  --pattern <pattern>
  --connection <connection>
  --account <account>
  --user <user>
  --password <password>
  --authenticator <authenticator>
  --private-key-path <private_key_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
Copy

Arguments

stage_name

Name of the stage.

Options

--pattern TEXT

Regex pattern for filtering files by name. For example –pattern “.*.txt” will filter only files with .txt extension.

--connection, -c, --environment TEXT

Name of the connection, as defined in your config.toml. Default: default.

--account, --accountname TEXT

Name assigned to your Snowflake account. Overrides the value specified for the connection.

--user, --username TEXT

Username to connect to Snowflake. Overrides the value specified for the connection.

--password TEXT

Snowflake password. Overrides the value specified for the connection.

--authenticator TEXT

Snowflake authenticator. Overrides the value specified for the connection.

--private-key-path TEXT

Snowflake private key path. Overrides the value specified for the connection.

--database, --dbname TEXT

Database to use. Overrides the value specified for the connection.

--schema, --schemaname TEXT

Database schema to use. Overrides the value specified for the connection.

--role, --rolename TEXT

Role to use. Overrides the value specified for the connection.

--warehouse TEXT

Warehouse to use. Overrides the value specified for the connection.

--temporary-connection, -x

Uses connection defined with command line parameters, instead of one defined in config.

--mfa-passcode TEXT

Token to use for multi-factor authentication (MFA).

--enable-diag

Run python connector diagnostic test.

--diag-log-path TEXT

Diagnostic report path.

--diag-allowlist-path TEXT

Diagnostic report path to optional allowlist.

--format [TABLE|JSON]

Specifies the output format.

--verbose, -v

Displays log entries for log levels info and higher.

--debug

Displays log entries for log levels debug and higher; debug logs contains additional information.

--silent

Turns off intermediate output to console.

Usage notes

None.

Examples

The following example lists the contents of the jdoe.public.test stage:

snow object stage list jdoe.public.test
Copy
ls @jdoe.public.test
+------------------------------------------------------------------------------+
| name            | size    | md5              | last_modified                 |
|-----------------+---------+------------------+-------------------------------|
| test/file.csv   | 195424  | 4fc596b5e00681d8 | Mon, 11 Mar 2024 17:09:01 GMT |
| test/data.csv   | 133248  | c0ddc25c1d3745d6 | Mon, 11 Mar 2024 17:08:57 GMT |
+------------------------------------------------------------------------------+
Language: English