snow spcs service deploy

备注

只有当您拥有使用 Snowpark Container Services 的必要权限时,才能通过 Snowflake CLI 使用 Snowpark Container Services。

部署项目定义文件中定义的服务。

语法

snow spcs service deploy
  <entity_id>
  --upgrade
  --project <project_definition>
  --env <env_overrides>
  --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
Copy

实参

entity_id

服务实体的 ID。

选项

--upgrade

更新现有服务。可以更新 min_instances、max_instances、query_warehouse、auto_resume、external_access_integrations 和注释。默认值:False。

-p, --project TEXT

Snowflake 项目的存储路径。默认为当前工作目录。

--env TEXT

格式为 key=value 的字符串。替换用于模板的 env 部分的变量。默认值:[]。

--connection, -c, --environment TEXT

连接名称,如您在 config.toml 文件中所定义。默认值:default

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

是否生成连接诊断报告。默认值:False。

--diag-log-path TEXT

生成的报告的路径。默认为系统临时目录。默认:<system_temporary_directory>。

--diag-allowlist-path TEXT

包含允许列表参数的 JSON 文件的路径。

--format [TABLE|JSON]

指定输出格式。默认:TABLE。

--verbose, -v

显示日志级别 info 及更高级别的日志条目。默认值:False。

--debug

显示日志级别 debug 及更高级别的日志条目;调试日志包含其他信息。默认值:False。

--silent

关闭到控制台的中间输出。默认值:False。

--help

显示此命令的帮助文本。

使用说明

snow spcs service deploy 命令读取用于定义服务的 snowflake.yml 项目定义文件,然后创建计算池并将其部署到 snowflake.yml 文件中命名的暂存区。如果您的项目定义正好有一个服务实体,您可以忽略 <entity_id> 实参。但是,如果您的项目定义有多个服务实体,您必须在 <entity_id> 实参中指定服务名称。有关更多信息,请参阅 服务项目定义

您可以选择运行服务的多个实例。每个服务实例都是服务规范文件中定义的容器的集合,这些容器在计算池中的节点上一起运行。如果您选择运行服务的多个实例,负载平衡器将管理传入流量。

--upgrade 选项更新现有服务。您只能更新以下项目定义参数:

  • min_instances

  • max_instances

  • query_warehouse

  • auto_resume

  • external_access_integrations

  • comment

示例

以下示例创建并在当前目录中部署 snowflake.yml 文件中定义的服务。

snow spcs service deploy
Copy
+---------------------------------------------------------------------+
| key    | value                                                      |
|--------+------------------------------------------------------------|
| status | Service MY_SERVICE successfully created.                   |
+---------------------------------------------------------------------+
语言: 中文