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)

Siehe auch:

ALTER MODEL … MODIFY VERSION, ALTER MODEL … DROP VERSION

Syntax

ALTER MODEL [ IF EXISTS ] <name> ADD VERSION <version_name>
  FROM MODEL <source_model_name> [ VERSION <source_version_name> ]
Copy

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
Copy

Wobei:

internalStage ::=
    @[<namespace>.]<int_stage_name>[/<path>]
| @[<namespace>.]%<table_name>[/<path>]
| @~[/<path>]
Copy

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.