SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO¶

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 in CREATED 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"
  },
  ...

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:

SQLReturned value

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();

Copy

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:

SQLReturned value

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();

Copy