snow helpers v1-to-v2¶
Migriert die Definitionsdateien der Snowpark-, Streamlit- und Native App-Projekte von V1 nach V2.
Syntax¶
snow helpers v1-to-v2
--accept-templates
--migrate-local-overrides / --no-migrate-local-overrides
--format <format>
--verbose
--debug
--silent
Argumente¶
Keine
Optionen¶
-t, --accept-templates
Ermöglicht die Migration von Vorlagen. Standard: false
-l, --migrate-local-overrides / --no-migrate-local-overrides
Führen Sie die Werte in snowflake.local.yml in die Definition des Hauptprojekts ein. Die Datei snowflake.local.yml wird nicht migriert, sondern ihre Werte werden in die Ausgabe der Datei snowflake.yml übernommen. Wenn nicht gesetzt und snowflake.local.yml vorhanden ist, wird ein Fehler ausgelöst.
--format [TABLE|JSON]
Gibt das Ausgabeformat an. Standard: TABLE.
--verbose, -v
Zeigt Protokolleinträge für die Protokolliergrade
info
und höher an. Standard: false--debug
Zeigt Protokolleinträge für die Protokollebenen
debug
und höher an; Debug-Protokolle enthalten zusätzliche Informationen. Standard: false--silent
Schaltet Zwischenausgaben auf der Konsole aus. Standard: false
--help
Zeigt den Hilfetext für diesen Befehl an.
Nutzungshinweise¶
Snowflake CLI 3.0 wurde die Unterstützung für V2-Projektdefinitionsdateien eingeführt. Wenn Sie über bestehende V1.x Projektdefinitionsdateien verfügen, können Sie den Befehl snow helpers v1-to-v2
verwenden, um die Dateien in die V2-Version zu konvertieren. Mit diesem Befehl bleibt die ursprüngliche Version in einer Datei snowflake_V1.yml
erhalten.
Sie müssen diesen Befehl in demselben Verzeichnis ausführen wie die Datei snowflake.yml
.
Achtung
Aufgrund der Änderung, wie Snowflake CLI 3.0 mit Projektdefinitionsvorlagen umgeht, kann Snowflake nicht garantieren, dass Projektdefinitionsdateien, die Vorlagen verwenden, nach der Konvertierung korrekt funktionieren. Standardmäßig erzeugt dieser Befehl einen Fehler, wenn Sie versuchen, eine 1.x- Datei zu konvertieren, die Vorlagen enthält. Sie können den Befehl zwingen, diese Arten von Dateien zu konvertieren, indem Sie die Option --accept-templates
verwenden. Dann müssen Sie alle Vorlagen manuell auf ihre V2-Entsprechung aktualisieren.
Beispiele¶
Konvertieren Sie eine Datei mit Projektdefinitionen der Version 1.x.
cd <project-directory> snow helpers v1-to-v2
Project definition migrated to version 2.
Konvertieren Sie eine Datei mit der Version 2 der Projektdefinition.
cd <project-directory> snow helpers v1-to-v2
Project definition is already at version 2.
Konvertieren Sie eine Projektdefinition der Version 1, die Vorlagen enthält, ohne die Option
--accept-templates
.cd <project-directory> snow helpers v1-to-v2
+- 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. | +----------------------------------------------------------------------------+
Konvertieren Sie eine Projektdefinition der Version 1 mit der Option
--accept-templates
.cd <project-directory> snow helpers v1-to-v2
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