spcs compute-pool create

Note

You can use Snowpark Container Services from Snowflake CLI only if you have the necessary permissions to use Snowpark Container Services.

Creates a compute pool with a specified number of nodes.

Syntax

snow spcs compute-pool create
  <name>
  --min-nodes <min_nodes>
  --max-nodes <max_nodes>
  --family <instance_family>
  --auto-resume
  --init-suspend
  --auto-suspend-secs <auto_suspend_secs>
  --comment <comment>
  --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>
  --format <format>
  --verbose
  --debug
  --silent
Copy

Arguments

name NAME

Name of the compute pool.

Options

--min-nodes INTEGER RANGE

Minimum number of nodes for the compute pool.

--max-nodes INTEGER RANGE

Maximum number of nodes for the compute pool.

--family TEXT

Name of the instance family. For more information about instance families, refer to the SQL CREATE COMPUTE POOL command.

--auto-resume

The compute pool will automatically resume when a service or job is submitted to it.

--init-suspend

The compute pool will start in a suspended state.

--auto-suspend-secs INTEGER RANGE

Number of seconds of inactivity after which you want Snowflake to automatically suspend the compute pool.

--comment TEXT

Comment for the compute pool.

--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).

--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.

--help

Displays the help text for this command.

Usage notes

None.

Examples

The following example creates a compute pool named “pool_1” using the minimal CPU_X64_XS family, which comprises two CPUs with 4GB of memory.

snow spcs compute-pool create --name "pool_1" --min-nodes 2 --max-nodes 2 --family "CPU_X64_XS"
Copy