CREATE MODEL

Erstellt ein neues Machine Learning-Modell im aktuellen/angegebenen Schema oder ersetzt ein vorhandenes Modell.

Bemerkung

Verwenden Sie die Snowflake Model Registry-Python-API, um Modelle von Grund auf zu erstellen. In SQL können Sie nur Modelle aus anderen Modellen erstellen.

Modelle sind versioniert. Alle Modelle müssen mindestens eine Version haben, und eine Version muss als Standardversion festgelegt werden. Um eine Version zu einem Modell hinzuzufügen, verwenden Sie ALTER MODEL … ADD VERSION.

Einige Eigenschaften eines Modells können geändert werden (siehe ALTER MODEL), und es können mehrere Versionen hinzugefügt werden.

Dieser Befehl unterstützt auch die folgende Variante:

  • CREATE MODEL … FROM internalStage (erstellt ein Modell aus Dateien in einem externen Stagingbereich)

Siehe auch:

ALTER MODEL , ALTER MODEL … ADD VERSION , DROP MODEL , SHOW MODELS

Syntax

CREATE [ OR REPLACE ] MODEL [ IF NOT EXISTS ] <name> [ WITH VERSION <version_name> ]
    FROM MODEL <source_model_name> [ VERSION <source_version_or_alias_name> ]
Copy

Syntaxvariante

Diese Variante wird von der Snowflake Model Registry Python API verwendet. In SQL ist es nicht möglich, Modelle von Grund auf zu erstellen.

CREATE [ OR REPLACE ] MODEL [ IF NOT EXISTS ] <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.

Erforderliche Parameter

name

Zeichenfolge, die den Bezeichner (d. h. den Namen) für das neue Modell angibt. Der Wert muss für das Schema, in dem das Modell erstellt wird, eindeutig sein.

Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

FROM MODEL source_model_name
Erforderlich, wenn Sie nicht die Variante FROM internalStage verwenden

Gibt den Namen des Modells an, aus dem das neue Modell erstellt werden soll.

FROM internalStage
Erforderlich bei Verwendung der Variante FROM internalStage

Gibt den internen Stagingbereich an, der die Dateien des Modells enthält. Das erforderliche Layout dieser Dateien ist derzeit nicht dokumentiert.

Optionale Parameter

WITH VERSION version_name
Zur Verwendung mit der Variante FROM MODEL

Gibt den Namen der Version an, die im neuen Modell erstellt werden soll.

VERSION source_version_or_alias_name
Zur Verwendung mit der Variante FROM MODEL

Gibt den Namen oder Alias der Version an, die aus dem Quellmodell kopiert werden soll. Wenn nicht angegeben, wird die Standardversion aus dem Quellmodell verwendet.

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung

Objekt

Anmerkungen

CREATE MODEL

Schema

Impliziert durch USAGE für Schema

OWNERSHIP

Modell

Um ein temporäres Objekt zu erstellen, das denselben Namen hat wie das bereits im Schema vorhandene Objekt, muss der verwendeten Rolle die Berechtigung OWNERSHIP für das Objekt erteilt worden sein oder die Rolle muss diese Berechtigung geerbt haben.

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.