Kategorien:: Systemfunktionen (Systemsteuerung)

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT¶

Entfernt einen privaten Konnektivitätsendpunkt in der Snowflake-VPC oder-VNet, um zu verhindern, dass Snowflake über private Konnektivität eine Verbindung zu einem externen Dienst herstellt. 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.

Wenn Sie diese Funktion aufrufen und den falschen Endpunkt für die private Konnektivität angeben, rufen Sie die Systemfunktion SYSTEM$RESTORE_PRIVATELINK_ENDPOINT auf, um den Endpunkt innerhalb eines Zeitraums von sieben Tagen wiederherzustellen. Nach sieben Tagen wird der Endpunkt gelöscht und kann nicht wiederhergestellt werden. Sie müssen den Endpunkt mit der Funktion SYSTEM$PROVISION_PRIVATELINK_ENDPOINT des Systems neu erstellen.

Siehe auch:: Einführung in die private Konnektivität , Private Konnektivitätsendpunkte verwalten: Azure

Syntax¶

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  '<provider_resource_id>' ,
  '<subresource>'
  )

Copy

Argumente¶

provider_resource_id

Gibt den vollqualifizierten Bezeichner für die Ressource oder den Dienst in Ihrem VPC oder VNet an.

'subresource'

Gibt den Namen der Subresource im Argument host_name an. Der Wert host_name wird bei der Bereitstellung des privaten Endpunkts verwendet.

Wenn Sie ausgehende private Verbindungen mit den folgenden Diensten verwenden möchten, geben Sie diese Werte an:

Externer Netzwerkzugriff auf Microsoft Azure: Wenn der Wert des Hostnamens externalaccessdemo.database.windows.net ist, lautet der Wert von subresource sqlServer.
Externe Stagingbereiche auf Microsoft Azure: Wenn der Wert des Hostnamens storagedemo.blob.core.windows.net ist, lautet der Wert von subresource blob.

Alle unterstützten Werte finden Sie in der Tabelle Subressourcen.

Rückgabewerte¶

Gibt eine Statusmeldung zurück, die besagt, dass der Endpunkt mit seinem Bezeichner erfolgreich entfernt wurde.

Azure:

Private endpoint with id "/subscriptions/e48379a7-2fc4-473e-b071-f94858cc83f5/resourcegroups/dbsec_test_rg/providers/microsoft.network/privateendpoints/5ef8fd34-07db-4583-b0dd-0e2360398ed3" successfully marked for deletion. Before it is fully deleted in 7-8 days, it can be restored.

Nutzungshinweise¶

Diese Funktion kann nur von Kontoadministratoren (d. h. Benutzer mit der Rolle ACCOUNTADMIN) ausgeführt werden.
Es erscheint eine Fehlermeldung, wenn ein privater Konnektivitätsendpunkt nicht mit den angegebenen Argumenten verbunden ist.

Beispiele¶

Entfernen Sie einen privaten Endpunkt, damit Snowflake auf Microsoft Azure eine Verbindung zum Azure API Management Service in Ihrem Azure VNet herstellen kann:

Entfernen Sie einen privaten Endpunkt, um zu verhindern, dass Snowflake auf Microsoft Azure eine Verbindung mit dem Microsoft Azure API Management Service in Ihrem Microsoft Azure VNet herstellt:

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api',
  'Gateway'
  );

Copy

Private endpoint with id "/subscriptions/e48379a7-2fc4-473e-b071-f94858cc83f5/resourcegroups/test_rg/providers/microsoft.network/privateendpoints/5ef8fd34-07db-4583-b0dd-0e2360398ed3" successfully marked for deletion. Before it is fully deleted in 7-8 days, it can be restored.

Entfernen Sie einen privaten Endpunkt, um zu verhindern, dass Snowflake auf Microsoft Azure eine Verbindung zu einem externen Dienst über einen externen Netzwerkzugang herstellt:

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/leorg1/providers/Microsoft.Sql/servers/myserver/databases/testdb',
  'sqlServer'
  );

Copy

"Resource Endpoint with id "/subscriptions/f0abb333-1b05-47c6-8c31-dd36d2512fd1/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"

Entfernen Sie einen privaten Endpunkt, um zu verhindern, dass Snowflake eine Verbindung zu einem externen Stagingbereich für Microsoft Azure herstellt:

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  'storagedemo.blob.core.windows.net',
  'blob'
);

Copy

"Resource Endpoint with id "/subscriptions/57faea9a-20c2-4d35-b283-9c0c1e9593d8/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"