snow helpers v1-to-v2

Migre les fichiers de définition de projet Snowpark, Streamlit et Native App de V1 vers V2.

Syntaxe

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

Arguments

Aucun

Options

-t, --accept-templates

Permet la migration de modèles. Par défaut : false.

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

Fusionner les valeurs de snowflake.local.yml dans la définition du projet principal. Le fichier snowflake.local.yml ne sera pas migré, mais ses valeurs seront reflétées dans le fichier snowflake.yml de sortie. Si unset et snowflake.local.yml est présent, une erreur sera générée.

--format [TABLE|JSON]

Spécifie le format de sortie. Par défaut : TABLE.

--verbose, -v

Affiche les entrées de journal pour les niveaux de journalisation info et supérieurs. Par défaut : false.

--debug

Affiche les entrées de journal pour les niveaux de journalisation debug et supérieurs ; les journaux de débogage contiennent des informations supplémentaires. Par défaut : false.

--silent

Désactive la sortie intermédiaire vers la console. Par défaut : false.

--help

Affiche le texte d’aide de cette commande.

Notes sur l’utilisation

Snowflake CLI 3.0 a introduit la prise en charge des fichiers de définition de projet V2. Si vous disposez de fichiers de définition de projet V1.x existants, vous pouvez utiliser la commande snow helpers v1-to-v2 pour convertir les fichiers vers la version V2. La commande conserve la version originale dans un fichier snowflake_V1.yml.

Vous devez exécuter cette commande dans le même répertoire que le fichier snowflake.yml.

Attention

Avec le changement dans la façon dont Snowflake CLI 3.0 gère les modèles de définition de projet, Snowflake ne peut pas garantir que les fichiers de définition de projet utilisant des modèles fonctionnera correctement après la conversion. Par défaut, cette commande génère une erreur si vous essayez de convertir un fichier 1.x contenant des modèles. Vous pouvez forcer la commande à convertir ces types de fichiers en utilisant l’option --accept-templates. Vous devez ensuite mettre à jour manuellement tous les modèles vers leurs équivalents V2.

Exemples

  • Convertissez un fichier de définition de projet version 1.x.

    cd <project-directory>
    snow helpers v1-to-v2
    
    Copy
    Project definition migrated to version 2.
    
  • Convertissez un fichier de définition de projet version 2.

    cd <project-directory>
    snow helpers v1-to-v2
    
    Copy
    Project definition is already at version 2.
    
  • Convertissez une définition de projet de version 1 qui contient des modèles sans l’option --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.                                    |
    +----------------------------------------------------------------------------+
    
  • Convertissez une définition de projet version 1 avec l’option --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