snow helpers v1-to-v2

Migra os arquivos de definição de projeto do Snowpark, Streamlit e Native App da V1 para a V2.

Sintaxe

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

Argumentos

Nenhum

Opções

-t, --accept-templates

Permite a migração de modelos. Padrão: falso.

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

Mesclar valores em snowflake.local.yml na definição do projeto principal. O arquivo snowflake.local.yml não será migrado; em vez disso, seus valores serão refletidos no arquivo de saída snowflake.yml. Se unset e snowflake.local.yml estiverem presentes, um erro será gerado.

--format [TABLE|JSON]

Especifica o formato de saída. Padrão: TABLE.

--verbose, -v

Exibe entradas de log para níveis de log info e superior. Padrão: falso.

--debug

Exibe entradas de log para níveis de log de depuração e superiores; os logs de depuração contêm informações adicionais. Padrão: falso.

--silent

Desliga a saída intermediária para o console. Padrão: falso.

--help

Exibe o texto de ajuda para este comando.

Notas de uso

Snowflake CLI 3.0 introduziu suporte para arquivos de definição de projeto V2. Se você tiver arquivos de definição de projeto V1.x existentes, poderá usar o comando snow helpers v1-to-v2 para converter os arquivos para a V2. O comando preserva a versão original em um arquivo snowflake_V1.yml.

É necessário executar este comando no mesmo diretório do arquivo snowflake.yml.

Atenção

Com a mudança na forma como Snowflake CLI 3.0 manipula modelos de definição de projeto, a Snowflake não pode garantir que os arquivos de definição de projeto que usam modelos funcionarão corretamente após a conversão. Por padrão, este comando gera um erro se você tentar converter um arquivo 1.x com modelos. É possível forçar o comando a converter esses tipos de arquivos usando a opção --accept-templates. Então é necessário atualizar manualmente todos os modelos para seus equivalentes da V2.

Exemplos

  • Converta um arquivo de definição de projeto da versão 1.x.

    cd <project-directory>
    snow helpers v1-to-v2
    
    Copy
    Project definition migrated to version 2.
    
  • Converta um arquivo de definição de projeto da versão 2.

    cd <project-directory>
    snow helpers v1-to-v2
    
    Copy
    Project definition is already at version 2.
    
  • Converta uma definição de projeto da versão 1 com modelos sem a opção --accept-templates.

    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.                                    |
    +----------------------------------------------------------------------------+
    
  • Converta uma definição de projeto da versão 1 com a opção --accept-templates.

    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