snow helpers v1-to-v2

将 Snowpark、Streamlit 和 Native App 项目定义文件从 V1 迁移到 V2。

语法

snow helpers v1-to-v2
  --accept-templates
  --migrate-local-overrides / --no-migrate-local-overrides
  --format <format>
  --verbose
  --debug
  --silent
Copy

实参

无

选项

-t, --accept-templates

允许迁移模板。默认值：False。

-l, --migrate-local-overrides / --no-migrate-local-overrides

将 snowflake.local.yml 中的值合并到主项目定义中。不会迁移 snowflake.local.yml 文件，而是将其值反映在输出的 snowflake.yml 文件中。如果未设置且存在 snowflake.local.yml，将会引发错误。

--format [TABLE|JSON]

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

--verbose, -v

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

--debug

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

--silent

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

--help

显示此命令的帮助文本。

使用说明

Snowflake CLI 3.0 引入了对 V2 项目定义文件的支持。如果您具有现有 V1.x 项目定义文件，则可以使用 snow helpers v1-to-v2 命令将文件转换为 V2 版本。该命令会将原始版本保存在 snowflake_V1.yml 文件中。

必须在与 snowflake.yml 文件相同的目录下运行此命令。

注意

由于 Snowflake CLI 3.0 处理项目定义模板的方式发生了变化，Snowflake 无法保证使用 模板 的项目定义文件在转换后能正常工作。默认情况下，如果尝试转换包含模板的 1.x 文件，此命令将会产生错误。您可以使用 --accept-templates 选项强制命令转换这些类型的文件。然后，您必须将所有模板手动更新为 V2 对应模板。

示例

  • 转换版本 1.x 的项目定义文件。

    cd <project-directory>
snow helpers v1-to-v2
    Copy
    Project definition migrated to version 2.

  • 转换版本 2 的项目定义文件。

    cd <project-directory>
snow helpers v1-to-v2
    Copy
    Project definition is already at version 2.

  • 在不使用 --accept-templates 选项的情况下，转换包含模板的版本 1 的项目定义。

    cd <project-directory>
snow helpers v1-to-v2
    Copy
    +- Error---------------------------------------------------------------------+
| Project definition contains templates. They may not be migrated correctly, |
| and require manual migration.You can try again with --accept-templates     |
| option, to attempt automatic migration.                                    |
+----------------------------------------------------------------------------+

  • 使用 --accept-templates 选项转换版本 1 的项目定义。

    cd <project-directory>
snow helpers v1-to-v2
    Copy
    WARNING  snowflake.cli._plugins.workspace.commands:commands.py:60 Your V1 definition contains templates. We cannot guarantee the correctness of the migration.
Project definition migrated to version 2
语言: 中文