- Kategorien:
Systemfunktionen (Systemsteuerung)
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT¶
Stellt einen privaten Konnektivitätsendpunkt in der VPC oder dem VNet von Snowflake wieder her, damit Snowflake eine Verbindung zu einem externen Dienst über private Konnektivität herstellen kann. 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.
Sie können einen privaten Endpunkt innerhalb von 7 Tagen nach dessen Entfernung wiederherstellen. Nach Ablauf von 7 Tagen kann der Endpunkt nicht mehr wiederhergestellt werden, und Sie müssen den Endpunkt mit der Systemfunktion SYSTEM$PROVISION_PRIVATELINK_ENDPOINT neu erstellen.
Syntax¶
AWS:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT( '<provider_service_name>' )
Azure:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
'<provider_resource_id>'
[, '<subresource>' ]
)
Argumente¶
provider_service_name
Gibt den externen Dienst- oder Ressourcen-Endpunkt an, der wiederhergestellt werden soll. Zum Beispiel:
com.amazonaws.us-west-2.execute-api
für das Amazon API-Gateway odercom.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 wiederhergestellt wurde.
Wenn dies nicht gelingt, wird ein Fehler zurückgegeben. Zum Beispiel, wenn das angegebene Argument kein gültiger vorhandener Endpunkt ist. Wenn Sie den Namen des Endpunkts nicht kennen, können Sie die Systemfunktion SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO verwenden, um alle Endpunkte in Ihrem Snowflake-Konto aufzulisten.
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:
Wiederherstellen eines privaten Endpunkts mit externem Zugriff auf Amazon S3:
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT('com.amazonaws.us-west-2.s3');
Azure:
Stellen Sie einen privaten Endpunkt wieder her, damit Snowflake auf Microsoft Azure eine Verbindung mit dem Azure API Management Service in Ihrem Azure VNet herstellen kann:
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT( '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/my_rg/providers/Microsoft.Sql/servers/my_db_server', 'sqlServer' );Private endpoint with id ''/subscriptions/66666666-7777-8888-9999-0000000000/resourcegroups/rg/providers/microsoft.network/privateendpoints/00000000-1111-2222-3333-4444444444'' restored successfully.