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
实参¶
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
+---------------------------------------------------------------------+
| key | value |
|--------+------------------------------------------------------------|
| status | Service MY_SERVICE successfully created. |
+---------------------------------------------------------------------+