SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME¶

Syntax¶

AWS:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<provider_service_name>' , '<host_name>' )

Azure:

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

Google Cloud:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<target_service_id>' , '<host_name>' )

Argumente¶

AWS:

'provider_service_name'

Gibt den externen Dienst oder die Ressource an, mit der eine Verbindung hergestellt werden soll. 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.

Weitere Informationen zum Abrufen dieses Wertes von AWS finden Sie unter Bereitstellung privater Konnektivitätsendpunkte.

'host_name'

Gibt den neuen vollqualifizierten Hostnamen an, der für den für den Zugriff auf die Ressource in Ihrem VPC oder VNet verwendet werden sollte.

Dieser Wert enthält keine Portnummern und muss mit dem Wert übereinstimmen, den Sie in dem Snowflake-Objekt angegeben haben, mit dem Sie die Verbindung zum externen Dienst herstellen.

Beispiele hierfür sind bedrock-runtime.us-west-2.amazonaws.com und *.s3.us-west-2.amazonaws.com.

Wenn Sie eine private Konnektivität für externe Stagingbereiche und externe Volumes verwenden, muss host_name einen Platzhalter verwenden, anstatt einen AWS S3-Bucket anzugeben.

Weitere Informationen zum Abrufen dieses Wertes von AWS finden Sie unter Bereitstellung privater Konnektivitätsendpunkte.

Azure:

'provider_resource_id'

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

'host_name'

Gibt den vollqualifizierten Hostnamen für den Zugriff auf die Ressource in Ihrem VPC oder VNet neu an.

Beispiele für den Hostnamen für ausgehende private Konnektivität für externe Funktionen finden Sie in den folgenden Themen:

• Azure-Portal

• Azure ARM-Vorlage.

'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.

Google Cloud:

'target_service_id'

Gibt die Service-Anhang-ID (für einen kundenspezifischen Dienst) oder den regionalen Google API-Endpunkt an, mit dem eine Verbindung hergestellt werden soll.

'host_name'

Gibt den neuen vollqualifizierten Hostnamen für den Zugriff auf die Ressource an.

Rückgabewerte¶

Gibt eine Statusmeldung zurück, dass der Hostname für den privaten Konnektivitätsendpunkt erfolgreich aktualisiert wurde.

Anforderungen an die Zugriffssteuerung¶

Diese Funktion kann nur von Kontoadministratoren (d. h. Benutzer mit der Rolle ACCOUNTADMIN) ausgeführt werden.

Nutzungshinweise¶

• Sie können nur den Hostnamen eines bestehenden privaten Konnektivitätsendpunkts ändern.

Beispiele¶

AWS:

Aktualisieren Sie den Hostnamen eines privaten Endpunkts, um Snowflake auf Amazon Web Services zuzulassen, damit eine Verbindung zum VPCE-Dienst in Ihrem Amazon Web Services VPC hergestellt werden kann:

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  'com.amazonaws.vpce.us-west-2.vpce-svc-01234567890abcdef',
  'my-new-service-name.com'
  );

Copy

Successfully set the host name of the privatelink endpoint ``com.amazonaws.vpce.us-west-2.vpce-svc-01234567890abcdef`` to ``my-new-service-name.com``

Azure:

Aktualisieren Sie den Hostnamen eines privaten Endpunkts, um Snowflake auf Microsoft Azure zuzulassen, damit eine Verbindung zum Microsoft Azure API Management-Dienst in Ihrem Microsoft Azure VNet hergestellt werden kann:

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

Copy

Successfully set the host name of the privatelink endpoint ``/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api`` to ``my-new-custom-api-endpoint.net``

Google Cloud:

Aktualisieren Sie den Hostnamen eines privaten Endpunkts, um Snowflake auf Google Cloud Platform zuzulassen, damit eine Verbindung zum Service-Anhang in Ihrem Google Cloud Platform VPC-Netzwerk hergestellt werden kann:

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  'projects/my-project/regions/us-west2/serviceAttachments/my-http-server',
  'my-new-custom-api-endpoint.com'
  );

Copy

Successfully set the host name of the privatelink endpoint ``projects/my-project/regions/us-west2/serviceAttachments/my-http-server`` to ``my-new-custom-api-endpoint.com``