SHOW CHANNELS

Listet die Snowpipe Streaming-Kanäle auf, für die Sie Zugriffsrechte haben. Mit diesem Befehl können Sie die Kanäle einer angegebenen Tabelle, einer angegeben Datenbank oder eines angegebenen Schemas (oder der aktuellen Datenbank/des aktuellen Schemas der Sitzung) oder aber für Ihr gesamtes Konto auflisten.

Siehe auch:

Syntax

SHOW CHANNELS [ LIKE '<pattern>' ]
           [ IN
                {
                  ACCOUNT                  |

                  DATABASE                 |
                  DATABASE <database_name> |

                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>

                  TABLE                    |
                  TABLE <table_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 ... ]

Gibt optional den Geltungsbereich des Befehls an. Geben Sie eine der folgenden Optionen an:

ACCOUNT

Gibt Datensätze für das gesamte Konto zurück.

DATABASE, . DATABASE db_name

Gibt Datensätze für die aktuell verwendete Datenbank oder eine angegebene Datenbank (db_name) zurück.

Wenn Sie DATABASE ohne db_name angeben und aktuell keine Datenbank in Verwendung ist, hat das Schlüsselwort keine Auswirkungen auf die Ausgabe.

SCHEMA, . SCHEMA schema_name, . schema_name

Gibt Datensätze für das aktuell verwendete Schema oder ein angegebenes Schema (schema_name) zurück.

SCHEMA ist optional, wenn aktuell eine Datenbank in Verwendung ist oder wenn Sie für schema_name den vollqualifizierten Schemanamen (z. B. db.schema) angeben.

Wenn aktuell keine Datenbank in Verwendung ist, hat die Angabe von SCHEMA keine Auswirkungen auf die Ausgabe.

TABLE, . TABLE table_name

Gibt Datensätze für die Tabelle zurück.

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 Objekte zurück, für die Sie Berechtigungen zum Anzeigen in der Datenbank haben).

  • Keine Datenbank: ACCOUNT ist der Standardwert (d. h. der Befehl gibt die Objekte zurück, für die Sie Berechtigungen zum Anzeigen in Ihrem Konto haben).

Ausgabe

Die Befehlsausgabe stellt Eigenschaften und Metadaten der Pipe in den folgenden Spalten bereit:

Spalte

Beschreibung

created_on

Datum und Uhrzeit der Erstellung des Kanals.

name

Name des Kanals.

database_name

Datenbank, in der der Kanal gespeichert ist.

schema_name

Schema, in dem der Kanal gespeichert ist.

table_name

Tabelle, der der Kanal zugeordnet ist.

client_sequenzer

Nur für den internen Gebrauch.

row_sequencer

Nur für den internen Gebrauch.

offset_token

Eine Zeichenfolge, die zum Verfolgen des Erfassungsprozesses verwendet wird.

Beispiele

Zeigen Sie alle Kanäle an, für die Sie über Berechtigungen zum Anzeigen im Schema public in der Datenbank mydb verfügen:

use database mydb;

show channels;

+-------------------------------+-----------+---------------+------------------+------------------------+------------------+---------------+--------------+
| created_on                    | name      | database_name | schema_name      | table_name             | client_sequencer | row_sequencer | offset_token |
|-------------------------------+-----------+---------------+------------------+------------------------+------------------+---------------+--------------+
| 2023-05-05 17:13:17.579 -0700 | CHANNEL8  | TEST_DB1      | STREAMING_INGEST | STREAMING_INGEST_TABLE | 7                | 1             | 0            |
|                               |           |               |                  |                        |                  |               |              |
+-------------------------------+-----------+---------------+------------------+------------------------+------------------+---------------+--------------+
Copy
Sprache: Deutsch