CREATE MODEL MONITOR¶

Erstellen oder ersetzen Sie einen Modellmonitor im aktuellen oder angegebenen Schema.

Siehe auch:: ALTER MODEL MONITOR, SHOW MODEL MONITORS, DESCRIBE MODEL MONITOR, DROP MODEL MONITOR

Syntax¶

CREATE [ OR REPLACE ] MODEL MONITOR [ IF NOT EXISTS ] <monitor_name> WITH
    MODEL = <model_name>
    VERSION = '<version_name>'
    FUNCTION = '<function_name>'
    SOURCE = <source_name>
    WAREHOUSE = <warehouse_name>
    REFRESH_INTERVAL = '<refresh_interval>'
    AGGREGATION_WINDOW = '<aggregation_window>'
    TIMESTAMP_COLUMN = <timestamp_name>
    [ BASELINE = <baseline_name> ]
    [ ID_COLUMNS = <id_column_name_array> ]
    [ PREDICTION_CLASS_COLUMNS = <prediction_class_column_name_array> ]
    [ PREDICTION_SCORE_COLUMNS = <prediction_column-name_array> ]
    [ ACTUAL_CLASS_COLUMNS = <actual_class_column_name_array> ]
    [ ACTUAL_SCORE_COLUMNS = <actual_column_name_array> ]

Copy

Erforderliche Parameter¶

monitor_name

Gibt den Bezeichner für den Modellmonitor an. Er muss in dem Schema, in dem der Monitor erstellt wird, eindeutig sein und muss sich im selben Schema wie das überwachte Modell befinden.

Wenn der Bezeichner für den Monitor nicht vollqualifiziert ist (in Form von db_name.schema_name.name oder schema_name.name), erstellt der Befehl das Modell im aktuellen Schema für die Sitzung.

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.

MODEL = model_name

Der Name des zu überwachenden Modells. Muss sich im selben Schema befinden, in dem der Monitor erstellt wird.

VERSION = 'version_name'

Name der zu überwachenden Modellversion.

FUNCTION = function_name

Name der spezifischen Funktion in der zu überwachenden Modellversion.

SOURCE = source_name

Name der Quelltabelle oder -ansicht, die das Feature, die Inferenzen und die Ground Truth-Labels enthält.

WAREHOUSE = warehouse_name

Name des Snowflake-Warehouses, das für die internen Rechenoperationen des Monitors verwendet werden soll.

REFRESH_INTERVAL = 'refresh_interval'

Das Intervall, in dem der Monitor seinen internen Status aktualisiert. Der Wert muss eine Zeichenfolge sein, die einen Zeitraum angibt, z. B. '1 day'. Zu den unterstützten Einheiten gehören Sekunden, Minuten, Stunden, Tage, Wochen, Monate, Quartale und Jahre. Sie können den Intervallnamen im Singular („Stunde“) oder im Plural („Stunden“) verwenden, dürfen ihn aber nicht abkürzen.

AGGREGATION_WINDOW = 'aggregation_window'

Das Fenster, über das der Monitor die Daten aggregiert. Der Wert muss eine Zeichenfolge sein, die einen Zeitraum angibt, z. B. '1 day'. Es werden nur Tage unterstützt. Sie können den Intervallnamen im Singular („Tag“) oder im Plural („Tage“) verwenden, dürfen ihn aber nicht abkürzen.

TIMESTAMP_COLUMN = timestamp_name

Name der Spalte in den Quelldaten, die die Zeitstempel enthält. Muss vom Typ TIMESTAMP_NTZ oder DATE sein.

Optionale Parameter¶

BASELINE = baseline_name: Name der Basistabelle oder -ansicht, die einen Snapshot der Daten enthält, ähnlich wie SOURCE, der zur Berechnung der Abweichung verwendet wird. Ein Snapshot dieser Daten ist in das Monitorobjekt eingebettet. Dieser Parameter ist zwar optional, aber wenn er nicht gesetzt ist, kann der Monitor keine Abweichung erkennen.
ID_COLUMNS = id_column_name_array: Ein Array von Zeichenfolgen-Spaltennamen, die zusammen jede Zeile in den Quelldaten eindeutig identifizieren. Siehe ARRAY-Konstanten.

Bemerkung

Mindestens eine Vorhersagespalte (entweder ein Vorhersagewert oder eine Vorhersageklasse) ist obligatorisch.

Für Klassifizierungsmodelle: Vorhersagen können entweder Werte oder Klassen sein; tatsächliche Werte müssen Klassen sein.
Für Regressionsmodelle: Sowohl Vorhersagen als auch tatsächliche Werte

PREDICTION_CLASS_COLUMNS = prediction_class_column_name_array: Ein Array von Zeichenfolgen, die alle Spalten der Vorhersageklasse in der Datenquelle benennen. Siehe ARRAY-Konstanten. Die Spalten müssen vom Typ NUMBER sein.
PREDICTION_SCORE_COLUMNS = prediction_column_name_array: Ein Array von Zeichenfolgen, die alle Spalten mit Vorhersagewerten in der Datenquelle benennen. Siehe ARRAY-Konstanten. Die Spalten müssen vom Typ NUMBER sein.
ACTUAL_CLASS_COLUMNS = actual_class_column_name_array: Eine Reihe von Zeichenketten, die alle tatsächlichen Klassenspalten in der Datenquelle benennen. Siehe ARRAY-Konstanten. Die Spalten müssen vom Typ NUMBER sein.
ACTUAL_SCORE_COLUMNS = actual_column_name_array: Eine Reihe von Zeichenketten, die alle tatsächlichen Wertepalten in der Datenquelle benennen. Siehe ARRAY-Konstanten. Die Spalten müssen vom Typ NUMBER sein.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung	Objekt	Anmerkungen
OWNERSHIP	Modellmonitor	OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).
CREATE MODEL MONITOR	Schema
SELECT	Die durch den Parameter SOURCE angegebene Tabelle oder Ansicht
USAGE	Das durch den Parameter WAREHOUSE angegebene Warehouse
USAGE	Das durch den Parameter MODEL angegebene Modell

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen.

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.

Nutzungshinweise¶

Für die Parameter gelten die folgenden Anforderungen:

Die Modellaufgabe muss tabular_binary_classification oder tabular_regression sein.
Modelle mit mehreren Ausgaben werden derzeit nicht unterstützt. Obwohl es sich bei den Vorhersagespalten und Spalten für tatsächliche Werte um Arrays handelt, dürfen die Arrays nur ein Element enthalten.
Mindestens eine der Vorhersagespalten muss angegeben werden.
Spalten mit tatsächlichen Werten sind optional, aber die Genauigkeitsmetriken werden nicht berechnet, wenn sie nicht angegeben werden.
Eine Spalte kann nur einmal übergreifend für alle Parameter angegeben werden (eine ID-Spalte kann z. B. nicht gleichzeitig eine Vorhersagespalte sein).

Die Anzahl der überwachten Features ist auf 500 begrenzt.

Die Grundkonfiguration der MODEL MONITOR-Instanzen, einschließlich des überwachten Modells und der verwendeten Datenquellen, kann nach der Erstellung des Monitors nicht mehr geändert werden. Mit ALTER MODEL MONITOR können Sie nur einige wenige Optionen ändern. Um die Konfiguration eines Monitors zu ändern, löschen Sie die Instanz und erstellen Sie eine neue.

Die Replikation wird nur für Instanzen der Klasse CUSTOM_CLASSIFIER unterstützt.