- Kategorien:
Systemfunktionen (Systeminformationen)
SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO¶
Liefert den Status aller privaten Konnektivitätsendpunkte, die Sie bereitstellen. Bei dem Endpunkt kann es sich um einen Dienstendpunkt oder einen Ressourcenendpunkt handeln. Dies hängt von der Cloud-Plattform, die Ihr Snowflake Konto hostet.
Syntax¶
SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO()
Rückgabewerte¶
Gibt ein JSON-Objekt mit den folgenden Feldern zurück:
AWS:
provider_service_name
Name des Dienstes oder der Ressource.
snowflake_endpoint_name
Der VPC-Endpunkt-ID in Ihrem Snowflake Konto. Dieses Feld enthält einen temporären Namen, während der Endpunkt erstellt wird. Nachdem der Endpunkt erstellt wurde und
endpoint_state
inCREATED
geändert wurde, ändert sich dieser Name.endpoint_state
Der Endpunktstatus in Snowflake. Dieses Feld kann einen der folgenden Status enthalten:
PENDING_CREATION
: Der Endpunkt wird noch erstellt.
CREATED
: Zeigt an, dass Snowflake eine Antwort des Cloudanbieters erhalten hat, dass der Endpunkt erfolgreich erstellt wurde und einsatzbereit ist.
FAILED
: Der Endpunkt befindet sich beim Cloudanbieter in einem unerwarteten Zustand und kann nicht verwendet werden.
PENDING_DELETION
: Der Endpunkt befindet sich in der Löschwarteschlange, kann aber wiederhergestellt werden.
DELETING
: Der Endpunkt wird beim Cloudanbieter gelöscht und kann nicht wiederhergestellt werden.host
Hostname, der für die Verbindung mit dem Dienst verwendet wird.
status
Der Endpunkt-Bereitstellungsstatus in AWS. Dieses Feld kann einen der folgenden Status enthalten:
Pending
: Der Endpunkt wird noch erstellt.
Available
: Der Endpunkt wurde erstellt und ist einsatzbereit.
Azure:
provider_resource_id
Azure-Ressourcen-ID der Ressource, mit der sich der Endpunkt verbindet.
subresource
Unterressource der Azure-Ressource, mit der sich der Endpunkt verbindet.
snowflake_resource_id
Azure-Ressourcen-ID des privaten Endpunkts, der sich mit der Azure-Ressource verbindet.
host
Hostname, der für die Verbindung mit der Ressource verwendet wird.
endpoint_state
Der Endpunktstatus in Snowflake. Dieses Feld kann einen der folgenden Status enthalten:
PENDING_CREATION
: Der Endpunkt wird noch erstellt.
CREATED
: Zeigt an, dass Snowflake eine Antwort des Cloudanbieters erhalten hat, dass der Endpunkt erfolgreich erstellt wurde und einsatzbereit ist.
FAILED
: Der Endpunkt befindet sich beim Cloudanbieter in einem unerwarteten Zustand und kann nicht verwendet werden.
PENDING_DELETION
: Der Endpunkt befindet sich in der Löschwarteschlange, kann aber wiederhergestellt werden.
DELETING
: Der Endpunkt wird beim Cloudanbieter gelöscht und kann nicht wiederhergestellt werden.status
Der Endpunkt-Bereitstellungsstatus in Microsoft Azure. Verwenden Sie dieses Feld, um festzustellen, ob Microsoft Azure die Verbindung des privaten Endpunkts mit der Ressource genehmigt hat. Dieses Feld kann einen der folgenden Status enthalten:
APPROVED
PENDING
DISCONNECTED
REJECTED
Google Cloud:
provider_resource_id
Die Ressource ID (Service-Anhang-ID), mit dem sich der private Konnektivitätsendpunkt verbindet.
snowflake_resource_id
Der Bezeichner des privaten Konnektivitätsendpunkts.
host
Der Hostname, der beim Zugriff auf den Anbieterdienst oder die Ressource, die diesen Endpunkt verwendet, genutzt werden soll.
endpoint_state
Der Status des Endpunkts auf der Snowflake-Seite.
status
Der Verbindungsstatus in Google Cloud. NO CONNECTION könnte kurz nach der Erstellung des privaten Konnektivitätsendpunkts erscheinen, da der Cloudanbieter Zeit benötigt, um das Einrichten der Verbindung abzuschließen. Dieses Feld kann einen der folgenden Status enthalten:
ACCEPTED
NO CONNECTION
REJECTED
Nutzungshinweise¶
Die Ausführung dieser Funktion kann ca. fünf Minuten dauern, da sie vom Prozess zum Abrufen der privaten Konnektivitätsendpunkte in der Cloud-Plattform, die sich außerhalb von Snowflake befinden, abhängt.
Beispiele¶
AWS:
Um alle PrivateLink-Endpunkte mit externem Zugriff auf Amazon S3 aufzulisten, führen Sie die folgende SQL-Anweisung aus:
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();
[
{
"provider_service_name": "com.amazonaws.us-west-2.s3",
"snowflake_endpoint_name": "vpce-123456789012abcdea",
"endpoint_state": "CREATED",
"host": "*.s3.us-west-2.amazonaws.com",
"status": "Available"
},
...
Geben Sie für Ihr Snowflake-Konto auf Amazon Web Services den privaten Konnektivitätsendpunkt für einen bestimmten Ressourcenbezeichner zurück:
Azure:
Listen Sie für Ihr Snowflake Konto auf Microsoft Azure die privaten Konnektivitätsendpunkte auf, die Sie bereitgestellt haben, sowie die Namen der Dienste, denen die einzelnen Endpunkte zugeordnet sind:
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();[ { "provider_resource_id": "/subscriptions/11111111-2222-3333-4444-5555555555/...", "subresource": "sqlServer", "snowflake_resource_id": "/subscriptions/fa57a1f0-b4e6-4847-9c00-95f39520f...", "host": "testdb.database.windows.net", "endpoint_state": "CREATED", "status": "Approved", } ]
Google Cloud
Listen Sie für Ihr Snowflake Konto auf Google Cloud die privaten Konnektivitätsendpunkte auf, die Sie bereitgestellt haben, sowie die Namen der Dienste, denen die einzelnen Endpunkte zugeordnet sind:
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();[ { "provider_resource_id": "projects/my-project/regions/us-east4/serviceAttachments/...", "snowflake_resource_id": "abcd0000000000000001", "host": "my-service.com", "endpoint_state": "CREATED", "status": "ACCEPTED", } ]