ALTER MODEL … ADD VERSION¶
Ajoute une nouvelle version à un modèle existant à partir d’une version de modèle existante. Les versions sont le code de modèle réel qui contient les méthodes à appeler pour effectuer l’inférence et d’autres fonctions.
Note
Utilisez l’API Python du Registre de modèles Snowflake pour créer des versions de modèle à partir de zéro. Dans SQL, vous ne pouvez créer des versions de modèle qu’à partir de versions de modèle existantes.
Il est possible de modifier certaines propriétés de version (voir ALTER MODEL … MODIFY VERSION), mais l’implémentation de modèle réelle contenue dans une version est immuable.
Cette commande prend également en charge la variante suivante :
ALTER MODEL .. ADD VERSION. .. FROM internalStage (crée une version de modèle à partir d’une zone de préparation interne)
- Voir aussi :
Syntaxe¶
ALTER MODEL [ IF EXISTS ] <name> ADD VERSION <version_name>
FROM MODEL <source_model_name> [ VERSION <source_version_name> ]
Syntaxe des variantes¶
Cette variante est utilisée l’API Python Snowflake Model Registry. Il n’est pas possible de créer des versions de modèles à partir de zéro dans SQL.
ALTER MODEL [ IF EXISTS ] <name> ADD VERSION <version_name> FROM internalStage
Où :
internalStage ::=
@[<namespace>.]<int_stage_name>[/<path>]
| @[<namespace>.]%<table_name>[/<path>]
| @~[/<path>]
Pour plus de détails sur les zones de préparation internes, voir Sélection d’une zone de préparation interne pour les fichiers locaux.
Paramètres¶
name
Spécifie l’identificateur du modèle. Si l’identificateur contient des espaces, des caractères spéciaux ou des caractères majuscules et minuscules, tout l’identificateur doit être délimité par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse. Pour plus d’informations sur la syntaxe des identificateurs, voir Exigences relatives à l’identificateur.
ADD VERSION version_name
Spécifie l’identificateur de la version, qui doit être unique dans le modèle. Si l’identificateur contient des espaces, des caractères spéciaux ou des caractères majuscules et minuscules, tout l’identificateur doit être délimité par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse. Pour plus d’informations sur la syntaxe des identificateurs, voir Exigences relatives à l’identificateur.
FROM MODEL source_model_name [ VERSION source_version_or_alias_name ]
- Obligatoire si la variante internalStage FROM n’est pas utilisée
Spécifie le nom du modèle à partir duquel la version sera obtenue.
Pour obtenir une version spécifique de ce modèle, spécifiez la clause
VERSION source_version_or_alias_name
. Si vous omettez cette clause, la commande obtient la version par défaut du modèle source.
FROM internalStage
- Obligatoire si vous utilisez la variante internalStage FROM
Spécifie la zone de préparation interne qui contient les fichiers de la version.