SHOW ENTITIES IN DCM PROJECT¶

Zeigt alle Snowflake-Objekte an, die derzeit von einem angegebenen DCM-Projekt verwaltet werden.

Eine gemischte Liste vollqualifizierter Namen für alle Objekte wird bereitgestellt. Um Ergebnisse zu sehen, benötigen die Benutzenden sowohl die READ-Berechtigung für das DCM project als auch die READ-Berechtigung für das verwaltete Objekt selbst.

Bemerkung

Das Ergebnis stimmt nicht unbedingt mit den Entitäten der letzten Bereitstellung überein. Objekte, die manuell gelöscht oder von dem Projekt getrennt wurden, werden hier nicht aufgelistet.

Der Befehl gibt Objektmetadaten und zugehörige Eigenschaften zurück, die nach Erstellungsdatum sortiert sind.

Siehe auch:: CREATE DCM PROJECT , ALTER DCM PROJECT, DESCRIBE DCM PROJECT , DROP DCM PROJECT, EXECUTE DCM PROJECT, SHOW DCM PROJECTS

Syntax¶

SHOW ENTITIES IN DCM PROJECT <name> [ LIMIT <rows> ]

SHOW ENTITIES LIKE <pattern> IN DCM PROJECT <name>;

SHOW ENTITIES IN DCM PROJECT <name> STARTS WITH <prefix>;

SHOW ENTITIES IN DCM PROJECT <name> LIMIT <n> FROM <cursor>;

Erforderliche Parameter¶

IN DCM PROJECT name

Gibt den Bezeichner des DCM-Projekts an, das die aufzulistenden Bereitstellungen enthält.

Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

Optionale Parameter¶

LIMIT rows

Begrenzt optional die maximale Anzahl der zurückgegebenen Zeilen. Die tatsächliche Anzahl der zurückgegebenen Zeilen kann geringer sein als das angegebene Limit. Beispielsweise ist die Anzahl der vorhandenen Objekte geringer als das angegebene Limit.

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

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

STARTS WITH 'name_string'

Filtert die Befehlsausgabe optional anhand der Zeichen, die am Anfang des Objektnamens angezeigt werden. Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei zwischen Groß-/Kleinschreibung unterschieden wird.

Die folgenden Zeichenfolgen geben beispielsweise unterschiedliche Ergebnisse zurück:

... STARTS WITH 'B' ...

... STARTS WITH 'b' ...

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

LIMIT rows [ FROM 'name_string' ]

Schränkt optional die maximale Anzahl der zurückgegebenen Zeilen ein und ermöglicht gleichzeitig die „Paginierung“ der Ergebnisse. Die tatsächliche Anzahl der zurückgegebenen Zeilen kann geringer sein als das angegebene Limit. Beispielsweise ist die Anzahl der vorhandenen Objekte geringer als das angegebene Limit.

Die optionale Unterklausel FROM 'name_string' dient als „Cursor“ für die Ergebnisse. Dies ermöglicht das Abrufen der angegebenen Anzahl von Zeilen nach der ersten Zeile, deren Objektname mit der angegebenen Zeichenfolge übereinstimmt:

Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei zwischen Groß-/Kleinschreibung unterschieden wird.
Die Zeichenfolge muss nicht den vollständigen Datenbanknamen enthalten. Partielle Namen werden unterstützt.

Standard: Kein Wert (die Ausgabe wird nicht begrenzt)

Bemerkung

Bei SHOW-Befehlen, die sowohl die FROM 'name_string'- als auch die STARTS WITH 'name_string'-Klausel unterstützen, können Sie diese beiden Klauseln in derselben Anweisung kombinieren. Beide Bedingungen müssen jedoch erfüllt sein, da sie sich sonst gegenseitig aufheben und keine Ergebnisse zurückgegeben werden.

Außerdem werden Objekte in lexikographischer Reihenfolge nach Namen zurückgegeben. Daher gibt FROM 'name_string' nur Zeilen mit einem höheren lexikografischen Wert zurück als die von STARTS WITH 'name_string' zurückgegebenen Zeilen.

Beispiel:

... STARTS WITH 'A' LIMIT ... FROM 'B' würde keine Ergebnisse zurückgeben.
... STARTS WITH 'B' LIMIT ... FROM 'A' würde keine Ergebnisse zurückgeben.
... STARTS WITH 'A' LIMIT ... FROM 'AB' würde Ergebnisse zurückgeben (wenn Zeilen mit den Eingabezeichenfolgen übereinstimmen).

Ausgabe¶


Spalte	Beschreibung
`CREATED_ON`	Zeitstempel der Erstellung (LTZ)
`NAME`	vollqualifizierter Name des Objekts (FQN), geeignet für DESC
`OBJECT_TYPE`	Objekttyp
`OWNER`	Eigentümerschaft von Rollen, pro Domain-Konventionen
`COMMENT`	benutzerdefinierter Kommentar

Anforderungen an die Zugriffssteuerung¶

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


Berechtigung	Objekt
READ	DCM project Verwaltetes Objekt

Für das Ausführen von Operationen für ein Objekt in einem Schema ist mindestens eine Berechtigung für die übergeordnete Datenbank und mindestens eine Berechtigung für das übergeordnete Schema erforderlich.

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.

Beispiele¶

Anzeigen aller Entitäten im my_project DCM-Projekt:

SHOW ENTITIES IN DCM PROJECT my_project;

Anzeigen aller Entitäten im my_project DCM-Projekt, die mit my_ beginnen:

SHOW ENTITIES LIKE 'my_%' IN DCM PROJECT my_project;

Anzeigen aller dynamischen Tabellen im my_project DCM-Projekt:

SHOW ENTITIES IN DCM PROJECT my_project
  ->> SELECT * FROM $1 WHERE "object_type" = 'DYNAMIC_TABLE';