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.

Syntax¶

AWS:

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT( '<provider_service_name>' )

Copy

Azure:

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

Copy

Argumente¶

provider_service_name: Gibt den Endpunkt des externen Dienstes oder der Ressource an. Zum Beispiel: com.amazonaws.us-west-2.execute-api für das Amazon API-Gateway oder com.amazonaws.us-west-2.s3 für Amazon S3.

'provider_resource_id'

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

'subresource'

Gibt den Namen der Subressource der Azure-Ressource an.

Dieses Argument ist für Azure Private Link Service und Azure API Management Service nicht erforderlich.

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.

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¶

AWS:

Entfernen eines privaten Endpunkts mit externem Zugriff auf Amazon S3:

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT('com.amazonaws.us-west-2.s3');

Copy

Azure:

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(
  '/subscriptions/cb72345g5-d347-4sdc-r3ee-70d234551a78/resourceGroups/rg-db-dev/providers/Microsoft.Storage/storageAccounts/dbasdfffext',
  '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"