SHOW NOTEBOOK PROJECTS

Listet die Notebook-Projekte auf (Snowflake NOTEBOOK-Objekte), die für die aktuelle Rolle sichtbar sind.

Mit diesem Befehl können Sie die Objekte in der aktuellen Datenbank und im aktuellen Schema für die Sitzung, für eine bestimmte Datenbank oder ein bestimmtes Schema oder für Ihr gesamtes Konto auflisten.

Die Ausgabe enthält die Metadaten und Eigenschaften für jedes Objekt. Die Objekte werden lexikografisch nach Datenbank, Schema und Objektname sortiert (Beschreibungen der Ausgabespalten finden Sie hier unter Ausgabe). Die Reihenfolge der Zeilen in den Ergebnissen muss beachtet werden, wenn Sie die Ergebnisse filtern möchten.

Siehe auch:

CREATE NOTEBOOK PROJECT, EXECUTE NOTEBOOK PROJECT, SHOW NOTEBOOKS, DESCRIBE NOTEBOOK

Syntax

SHOW NOTEBOOK PROJECTS;

SHOW NOTEBOOK PROJECTS IN SCHEMA <database_name>.<schema_name>;

SHOW NOTEBOOK PROJECTS IN DATABASE <database_name>;

SHOW NOTEBOOK PROJECTS IN ACCOUNT;
Copy

Parameter

IN SCHEMA <database_name>.<schema_name>

Listet Notebook-Projekte im angegebenen Schema auf.

IN DATABASE <database_name>

Listet Notebook-Projekte in allen Schemas der angegebenen Datenbank auf.

IN ACCOUNT

Listet alle Notebook-Projekte im Konto auf, die für die aktuelle Rolle sichtbar sind.

Ausgabe

Die Ausgabe des Befehls enthält die folgenden Spalten, die die Eigenschaften und Metadaten des Objekts beschreiben:

Spalte

Beschreibung

created_on

Zeitstempel der Erstellung.

name

Name des Notebook-Projekts.

database_name

Datenbank, die das Notebook enthält

schema_name

Schema, das das Notebook enthält

owner

Die Rolle, der das Notebook-Projekt gehört.

comment

Kommentar, der mit dem Notebook-Projekt verbunden ist.

Anforderungen an die Zugriffssteuerung

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

Berechtigung

Objekt

Anmerkungen

USAGE oder OWNERSHIP

Datenbank

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).

USAGE oder OWNERSHIP

Schema

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).

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 Ausführung des Befehls ist kein aktives Warehouse erforderlich.

  • Der Befehl gibt nur Objekte zurück, für die der aktuellen Rolle des aktuellen Benutzers mindestens ein Zugriffsrecht zugewiesen wurde.

  • Das Zugriffsrecht MANAGE GRANTS gibt seinem Eigentümer implizit die Möglichkeit, jedes Objekt im Konto anzuzeigen. Standardmäßig haben nur der Kontoadministrator (Benutzer mit der Rolle ACCOUNTADMIN) und der Systemadministrator (Benutzer mit der Rolle SECURITYADMIN) die Berechtigung MANAGE GRANTS.

  • Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie den Befehl Pipe-Operator (->>) oder die RESULT_SCAN-Funktion verwenden. Beide Konstrukte behandeln die Ausgabe als Resultset, das Sie abfragen können.

    Sie können zum Beispiel den Pipe-Operator oder die RESULT_SCAN-Funktion verwenden, um bestimmte Spalten aus der SHOW-Befehlsausgabe auszuwählen oder die Zeilen zu filtern.

    Wenn Sie sich auf die Ausgabespalten beziehen, verwenden Sie Bezeichner mit doppelten Anführungszeichen für die Spaltennamen. Um beispielsweise die Ausgabespalte type auszuwählen, geben Sie SELECT "type" an.

    Sie müssen Bezeichner in doppelten Anführungszeichen verwenden, da die Ausgabespaltennamen für SHOW-Befehle in Kleinbuchstaben geschrieben sind. Die doppelten Anführungszeichen stellen sicher, dass die Spaltennamen in der SELECT-Liste oder WHERE-Klausel den Spaltennamen in der SHOW-Befehlsausgabe entsprechen, die gescannt wurde.

  • Der Befehl gibt maximal zehntausend Datensätze für den angegebenen Objekttyp zurück, entsprechend den Zugriffsrechten für die zur Ausführung des Befehls verwendete Rolle. Datensätze, die die Grenze von zehntausend Datensätzen überschreiten, werden nicht zurückgegeben, selbst wenn ein Filter angewendet wurde.

    Um Ergebnisse anzuzeigen, für die mehr als zehntausend Datensätze existieren, fragen Sie die entsprechende Ansicht (sofern vorhanden) in Snowflake Information Schema ab.

  • Gibt alle Snowflake-NOTEBOOK-Objekte, die für die aktuelle Rolle sichtbar sind, zurück.

  • Verwenden Sie DESCRIBE NOTEBOOK oder GET_DDL('NOTEBOOK', ...), um den Inhalt zu prüfen.

  • Bezeichner, die Sonderzeichen enthalten, müssen in doppelte Anführungszeichen gesetzt werden.

Beispiele

Listen Sie alle Notebook-Projekte auf, die für die aktuelle Rolle sichtbar sind:

SHOW NOTEBOOK PROJECTS;
Copy

Notebook-Projekte in einem bestimmten Schema auflisten:

SHOW NOTEBOOK PROJECTS IN SCHEMA TESTDB.TESTSCHEMA;
Copy

Notebook-Projekte in einer bestimmten Datenbank auflisten:

SHOW NOTEBOOK PROJECTS IN DATABASE TESTDB;
Copy

Auflisten der Notebook-Projekte im Konto:

SHOW NOTEBOOK PROJECTS IN ACCOUNT;
Copy
Sprache: Deutsch