snow dcm commands

备注

要使用 DCM 命令,必须先启用 SNOWFLAKE_CLI_FEATURES_ENABLE_SNOWFLAKE_PROJECTS 功能标志,可通过以下任一方式进行设置:

  • 在运行命令之前,将 SNOWFLAKE_CLI_FEATURES_ENABLE_SNOWFLAKE_PROJECTS 环境变量设置为 true

  • config.toml 文件中,将 enable_snowflake_projects 配置选项设置为 true,如下例所示:

    [cli.features]
    enable_snowflake_projects = true
    

Snowflake CLI 支持以下用于管理 Snowflake DCM project 对象的命令:

项目配置 (manifest.yml)

DCM 项目使用 manifest.yml 文件来定义项目配置。有关更多详细信息,请参阅 DCM Projects 文件和模板

对象标识符解析

大多数 DCM 命令接受可选的项目标识符实参和 --target 选项。项目名称解析如下:

  1. 如果将项目标识符作为实参提供,则直接使用该标识符。

  2. 如果指定了 --target,则使用 manifest.yml 中该目标的 project_name

  3. 如果两者都没有提供,则使用来自 manifest.ymldefault_target

示例:

# Use default_target from manifest.yml
snow dcm deploy

# Use target from manifest.yml
snow dcm deploy --target DEV

# Explicit project name with fully qualified identifier
snow dcm deploy MY_DB.MY_SCHEMA.MY_PROJECT

--from 选项指定包含 manifest.yml 和项目源文件的目录。如果省略,则使用当前目录。

备注

项目标识符可以指定为完全限定名称 (MY_DB.MY_SCHEMA.MY_PROJECT) 或简单名称 (MY_PROJECT)。使用简单名称时,数据库和架构派生自活动连接上下文。建议使用完全限定名称以避免歧义。