SHOW ENDPOINTS

Listet die Endpunkte in einem Snowpark Container Services-Dienst auf.

Siehe auch:

CREATE SERVICE, ALTER SERVICE, DROP SERVICE, SHOW SERVICES

Syntax

SHOW ENDPOINTS IN SERVICE <name>
Copy

Parameter

name

Gibt den Bezeichner für den Dienst an, dessen Endpunkte aufgelistet werden sollen.

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 Details dazu finden Sie unter Anforderungen an Bezeichner.

Ausgabe

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

Spalte

Beschreibung

name

Benutzerfreundlicher Endpunktname, der den entsprechenden Port darstellt.

port

Der Netzwerkport, den der Dienst überwacht.

protocol

Unterstütztes Netzwerkprotokoll (TCP, HTTP oder HTTPS). Der Standardwert ist HTTP. Öffentliche Endpunkte und Dienstfunktionen (siehe Verwenden eines Dienstes) erfordern HTTP oder HTTPS.

ingress_enabled

Wert ist „true“, wenn der Endpunkt öffentlich, also über das Internet zugänglich ist.

ingress_url

Endpunkt-URL, die über das Internet zugänglich ist.

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung

Objekt

Anmerkungen

USAGE

Dienst

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

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

  • Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Beispiele

Im folgenden Beispiel werden die vom Dienst echo_service bereitgestellten Endpunkte aufgelistet:

SHOW ENDPOINTS IN SERVICE echo_service;
Copy
+--------------+------+----------+----------------- +------------------------------------------------------------+
| name         | port | protocol | ingress_enabled | ingress_url                                                 |
|--------------+------+----------+-----------------+-------------------------------------------------------------|
| echoendpoint | 8000 | TCP      | true            | org-id-acct-id.snowflakecomputing.app                       |
+--------------+------+----------+-----------------+-------------------------------------------------------------+