ALTER MODEL … ADD VERSION¶
Fügt eine neue Version zu einem bestehenden Modell aus einer bestehenden Modellversion hinzu. Versionen sind der eigentliche Modellcode, der Methoden enthält, die zum Ausführen von Inferenz und anderen Funktionen aufgerufen werden können.
Bemerkung
Verwenden Sie die Snowflake Model Registry-Python-API, um Modellversionen von Grund auf zu erstellen. In SQL können Sie nur Modellversionen aus bestehenden Modellversionen erstellen.
Einige Eigenschaften der Version können geändert werden (siehe ALTER MODEL … MODIFY VERSION), aber die eigentliche Modellimplementierung, die in einer Version enthalten ist, ist unveränderlich.
Dieser Befehl unterstützt auch die folgende Variante:
ALTER MODEL .. ADD VERSION … FROM internalStage (erstellt ein Versionsmodell aus einem internen Stagingbereich)
Syntax¶
ALTER MODEL [ IF EXISTS ] <name> ADD VERSION <version_name>
FROM MODEL <source_model_name> [ VERSION <source_version_name> ]
Syntaxvariante¶
Diese Variante wird von der Snowflake Model Registry Python API verwendet. Es ist nicht möglich, Modellversionen von Grund auf in SQL zu erstellen.
ALTER MODEL [ IF EXISTS ] <name> ADD VERSION <version_name> FROM internalStage
Wobei:
internalStage ::=
@[<namespace>.]<int_stage_name>[/<path>]
| @[<namespace>.]%<table_name>[/<path>]
| @~[/<path>]
Weitere Informationen zu internen Stagingbereichen finden Sie unter Auswahl eines internen Stagingbereichs für lokale Dateien.
Parameter¶
name
Gibt den Bezeichner des Modells an. Wenn der Bezeichner Leerzeichen, Sonderzeichen oder Zeichen in Groß-/Kleinschreibung enthält, muss der gesamte Bezeichner in doppelte Anführungszeichen eingeschlossen werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten. Weitere Informationen zur Syntax von Bezeichnern finden Sie unter Anforderungen an Bezeichner.
ADD VERSION version_name
Gibt den Bezeichner der Version an, der innerhalb des Modells eindeutig sein muss. Wenn der Bezeichner Leerzeichen, Sonderzeichen oder Zeichen in Groß-/Kleinschreibung enthält, muss der gesamte Bezeichner in doppelte Anführungszeichen eingeschlossen werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten. Weitere Informationen zur Syntax von Bezeichnern finden Sie unter Anforderungen an Bezeichner.
FROM MODEL source_model_name [ VERSION source_version_or_alias_name ]
- Erforderlich, wenn Sie nicht die Variante FROM internalStage verwenden
Gibt den Namen des Modells an, von dem die Version bezogen wird.
Um eine bestimmte Version dieses Modells zu erhalten, geben Sie die Klausel
VERSION source_version_or_alias_name
an. Wenn Sie diese Klausel weglassen, erhält der Befehl die Standardversion des Quellmodells.
FROM internalStage
- Erforderlich bei Verwendung der Variante FROM internalStage
Gibt den internen Stagingbereich an, der die Dateien der Version enthält.