CREATE MODEL¶
Crée un nouveau modèle de machine learning dans le schéma actuel/spécifié ou remplace un modèle existant. Cette commande est fournie pour être utilisée par l’API Python Registre des modèles de Snowpark et n’est pas destinée à vous permettre de créer des modèles en utilisant SQL.
Les modèles ont plusieurs versions. Tous les modèles doivent avoir au moins une version, et une version peut être désignée comme version par défaut. Pour ajouter une version à un modèle, utilisez ALTER MODEL … ADD VERSION.
Certaines propriétés d’un modèle peuvent être modifiées (voir ALTER MODEL), et un nombre quelconque de versions peut être ajouté, mais l’objet modèle lui-même est immuable.
- Voir aussi :
ALTER MODEL, ALTER MODEL … ADD VERSION, DROP MODEL , SHOW MODELS
Syntaxe¶
CREATE [ OR REPLACE ] MODEL [ IF NOT EXISTS ] <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
Chaîne qui indique l’identificateur (c’est-à-dire le nom) du nouveau modèle ; doit être unique pour le schéma dans lequel le modèle est créé.
De plus, l’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles (par exemple,
"My object"
). Les identificateurs entre guillemets doubles sont également sensibles à la casse.Pour plus d’informations, consultez Exigences relatives à l’identificateur.
internalStage
Spécifie la zone de préparation interne qui contient les fichiers du modèle. La présentation requise de ces fichiers n’est pas documentée à l’heure actuelle.
Exigences en matière de contrôle d’accès¶
Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :
Privilège |
Objet |
Remarques |
---|---|---|
CREATE MODEL |
Schéma |
Impliqué par USAGE sur le schéma |
OWNERSHIP |
Modèle |
Un rôle doit se voir accorder le privilège OWNERSHIP ou en hériter sur l’objet pour créer un objet temporaire portant le même nom que l’objet qui existe déjà dans le schéma. |
Notez que l’exploitation d’un objet dans un schéma requiert également le privilège USAGE sur la base de données et le schéma parents.
Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.
Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.