SHOW MODELS¶

Listet die Machine-Learning-Modelle für auf, für die Sie Zugriffsrechte haben.

Die Ausgabe gibt Tabellenmetadaten und -eigenschaften zurück, die nach Datenbank, Schema und Modellnamen lexikographisch geordnet sind (Beschreibungen der Ausgabespalten finden Sie unter diesem Thema unter Ausgabe). Dies muss beachtet werden, wenn Sie die Ergebnisse mit den bereitgestellten Filtern filtern möchten.

Siehe auch:: CREATE MODEL, DROP MODEL, ALTER MODEL, SHOW VERSIONS IN MODEL

Syntax¶

SHOW MODELS [ LIKE '<pattern>' ]
            [ IN { DATABASE [ <db_name> ] | SCHEMA [ <schema_name> ] } ]

Copy

Parameter¶

LIKE 'pattern'

Filtert optional die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet einen Musterabgleich ohne Berücksichtigung der Groß-/Kleinschreibung, aber mit Unterstützung von SQL-Platzhalterzeichen (% und _).

Die folgenden Muster geben beispielsweise die gleichen Ergebnisse zurück:

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. Standard: Kein Wert (die Ausgabe wird nicht gefiltert).

IN DATABASE [ db_name ] | SCHEMA [ schema_name ]

Gibt optional den Geltungsbereich des Befehls an, der bestimmt, ob der Befehl Modelle nur für die aktuelle/angegebene Datenbank oder das aktuelle/angegebene Schema auflistet.

Wenn Sie das Schlüsselwort ACCOUNT angeben, ruft der Befehl Datensätze für alle Schemas in allen Datenbanken des aktuellen Kontos ab.

Wenn Sie das Schlüsselwort DATABASE angeben, dann gilt Folgendes:

Wenn Sie einen Wert für db_name angeben, ruft der Befehl Datensätze für alle Schemas der angegebenen Datenbank ab.
Wenn Sie keinen Wert für db_name angeben, dann gilt Folgendes:
- Wenn es eine aktuelle Datenbank gibt, ruft der Befehl Datensätze für alle Schemas in der aktuellen Datenbank ab.
- Wenn es keine aktuelle Datenbank gibt, ruft der Befehl Datensätze aller Datenbanken und Schemas im Konto ab.

Wenn Sie das Schlüsselwort SCHEMA angeben, dann gilt Folgendes:

Wenn Sie einen qualifizierten Schemanamen angeben (z. B. my_database.my_schema), ruft der Befehl Datensätze für die angegebene Datenbank und das angegebene Schema ab.
Wenn Sie einen nicht qualifizierten Wert für schema_name angeben, dann gilt Folgendes:
- Wenn es eine aktuelle Datenbank gibt, ruft der Befehl Datensätze für das angegebene Schema in der aktuellen Datenbank ab.
- Wenn keine aktuelle Datenbank vorhanden ist, zeigt der Befehl den Fehler SQL compilation error: Object does not exist, or operation cannot be performed an.
Wenn Sie keinen Wert für schema_name angeben, dann gilt Folgendes:
- Wenn es eine aktuelle Datenbank gibt, dann gilt Folgendes:
  - Wenn es ein aktuelles Schema gibt, dann ruft der Befehl Datensätze für das aktuelle Schema in der aktuellen Datenbank ab.
  - Wenn kein aktuelles Schema vorhanden ist, ruft der Befehl Datensätze für alle Schemas in der aktuellen Datenbank ab.
- Wenn es keine aktuelle Datenbank gibt, ruft der Befehl Datensätze für alle Datenbanken und alle Schemas im Konto ab.

Standard: Abhängig davon, ob für die Sitzung aktuell eine Datenbank in Verwendung ist:

Datenbank: DATABASE ist der Standardwert (d. h. der Befehl gibt die Modelle zurück, für die Sie Berechtigungen zum Anzeigen in der aktuellen Datenbank haben).
Keine Datenbank: Der Geltungsbereich des Kontos ist die Standardeinstellung (d. h. der Befehl gibt die Modelle zurück, für die Sie Berechtigungen zum Anzeigen in Ihrem Konto haben).

Ausgabe¶

Die Befehlsausgabe enthält Tabelleneigenschaften und Metadaten in den folgenden Spalten:

Spalte	Beschreibung
created_on	Datum und Uhrzeit der Erstellung des Modells.
name	Name des Modells.
database_name	Datenbank, in der das Modell gespeichert ist.
schema_name	Schema, in dem das Modell gespeichert ist.
owner	Rolle, die Eigentümer des Modells ist.
comment	Kommentar zum Modell.
versions	JSON-Array mit den Versionen des Modells.
default_version_name	Version des Modells, wenn auf das Modell ohne Versionsangabe verwiesen wird.

Nutzungshinweise¶

Die Ergebnisse werden nach Datenbankname, Schemaname und dann nach Modellname sortiert. Das bedeutet, dass die Ergebnisse für eine Datenbank Modelle aus mehreren Schemas enthalten können und die Paginierung unterbrochen werden kann. Damit die Paginierung wie erwartet funktioniert, müssen Sie die Anweisung SHOW MODELS für ein einzelnes Schema ausführen. Sie können den Parameter IN SCHEMA schema_name für den Befehl SHOW MODELS verwenden. Alternativ können Sie das Schema im aktuellen Kontext verwenden, indem Sie eine USE SCHEMA schema_name-Anweisung vor der Ausführung einer SHOW TABLES-Anweisung ausführen.