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.

Nutzungshinweise¶

• Nur Benutzer mit der Rolle ACCOUNTADMIN können diese Funktion aufrufen.

• 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.net