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: 2.3.0
    
  • To display information about Snowflake CLI, run the following command:

    snow --info
    
    Copy
    [
        {
            "key": "version",
            "value": "2.3.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]          │
    │ --help         -h            Show this message and exit.                                                             │
    ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
    ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
    │ app          Manages a Snowflake Native App                                                                          │
    │ connection   Manages connections to Snowflake.                                                                       │
    │ git          Manages git repositories 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.                                                                                 │
    ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯