snow¶

Snowflake CLI tool for developers.

Syntax¶

snow [<resource-commands>]
  --version
  --info
  --config-file <configuration_file>
  --help
Copy

Arguments¶

[resource-commands]

Optional commands for managing Snowflake CLI resources.

Options¶

--version

Displays the version of Snowflake CLI.

--info

Displays information about Snowflake CLI.

--config-file configuration_file

Specifies an alternate Snowflake CLI configuration file to use.

--help

Displays the help text for this command.

Usage notes¶

The snow command supports the following commands to manage Snowflake resources:

Examples¶

  • To display the Snowflake CLI version, run the following command:

    snow --version
    
    Copy
    Snowflake CLI version: 3.0.0
    
  • To display information about Snowflake CLI, run the following command:

    snow --info
    
    Copy
    [
        {
            "key": "version",
            "value": "3.0.0"
        },
        {
            "key": "default_config_file_path",
            "value": "<user-home>/.snowflake/config.toml"
        },
        {
            "key": "python_version",
            "value": "3.11.6 (v3.11.6:8b6ee5ba3b, Oct  2 2023, 11:18:21) [Clang 13.0.0 (clang-1300.0.29.30)]"
        },
        {
            "key": "system_info",
            "value": "macOS-14.4.1-x86_64-i386-64bit"
        },
        {
            "key": "feature_flags",
            "value": {}
        }
    ]
    
  • To display command-line help for the snow command, run the following command:

    snow --help
    
    Copy
    Usage: snow [OPTIONS] COMMAND [ARGS]...
    
    Snowflake CLI tool for developers.
    
    ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
    │ --version                           Shows version of the Snowflake CLI                                                                   │
    │ --info                              Shows information about the Snowflake CLI                                                            │
    │ --config-file                 FILE  Specifies Snowflake CLI configuration file that should be used [default: None]                       │
    │ --install-completion                Install completion for the current shell.                                                            │
    │ --show-completion                   Show completion for the current shell, to copy it or customize the installation.                     │
    │ --help                -h            Show this message and exit.                                                                          │
    ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
    ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
    │ app          Manages a Snowflake Native App                                                                                              │
    │ connection   Manages connections to Snowflake.                                                                                           │
    │ cortex       Provides access to Snowflake Cortex.                                                                                        │
    │ git          Manages git repositories in Snowflake.                                                                                      │
    │ notebook     Manages notebooks in Snowflake.                                                                                             │
    │ object       Manages Snowflake objects like warehouses and stages                                                                        │
    │ snowpark     Manages procedures and functions.                                                                                           │
    │ spcs         Manages Snowpark Container Services compute pools, services, image registries, and image repositories.                      │
    │ sql          Executes Snowflake query.                                                                                                   │
    │ stage        Manages stages.                                                                                                             │
    │ streamlit    Manages a Streamlit app in Snowflake.                                                                                       │
    ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
    
  • To display command-line help resource commands, run a command similar to the following that displays help for the snow spcs commands:

    snow spcs --help
    
    Copy
    Usage: snow spcs [OPTIONS] COMMAND [ARGS]...
    
    Manages Snowpark Container Services compute pools, services, image registries, and image repositories.
    
    ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
    │ --help  -h        Show this message and exit.                                                                        │
    ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
    ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
    │ compute-pool       Manages compute pools.                                                                            │
    │ image-registry     Manages image registries.                                                                         │
    │ image-repository   Manages image repositories.                                                                       │
    │ service            Manages services.                                                                                 │
    ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯