SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME¶

Syntaxe¶

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

Arguments¶

AWS:

'provider_service_name'

Spécifie le service externe ou la ressource auquel se connecter. Par exemple, com.amazonaws.us-west-2.execute-api pour Amazon API Gateway ou com.amazonaws.us-west-2.s3 pour Amazon S3.

Pour obtenir des informations sur la manière de récupérer cette valeur à partir de AWS, voir Fournir des points de terminaison de connectivité privée.

'host_name'

Spécifie le nouveau nom d’hôte complet qui doit être utilisé pour accéder à la ressource dans votre VPC ou VNet.

Cette valeur ne contient aucun numéro de port et doit correspondre à ce que vous avez spécifié dans l’objet Snowflake qui vous permet de vous connecter au service externe.

Les exemples incluent bedrock-runtime.us-west-2.amazonaws.com et *.s3.us-west-2.amazonaws.com.

Lors de l’utilisation de la connexion privée pour les zones de préparation externes et les volumes externes, le host_name doit utiliser un caractère générique au lieu de spécifier un compartiment S3 AWS.

Pour obtenir des informations sur la manière de récupérer cette valeur à partir de AWS, voir Fournir des points de terminaison de connectivité privée.

Azure :

'provider_resource_id'

Spécifie l’identificateur complet de la ressource dans votre VPC ou VNet.

'host_name'

Spécifie le nouveau nom d’hôte complet pour accéder à la ressource dans votre VPC ou VNet.

Pour obtenir des exemples de nom d’hôte en matière de connexion privée sortante pour les fonctions externes, consultez les rubriques suivantes :

• Portail Azure

• Modèle Azure ARM.

'subresource'

Spécifie le nom de la sous-ressource de la ressource Azure.

Cet argument n’est pas requis pour Azure Private Link Service et Azure API Management Service.

Pour toutes les valeurs prises en charge, consultez la Table des sous-ressources.

Google Cloud :

'target_service_id'

Spécifie l’ID de la pièce jointe de service (vers un service personnalisé) ou le point de terminaison API Google régional auquel se connecter.

'host_name'

Spécifie le nouveau nom d’hôte complet pour accéder à la ressource.

Renvoie¶

Renvoie un message de statut indiquant que le nom d’hôte du point de terminaison de connexion privée a été mis à jour correctement.

Notes sur l’utilisation¶

• Seuls les utilisateurs dotés du rôle ACCOUNTADMIN peuvent appeler cette fonction.

• Vous pouvez uniquement modifier le nom d’hôte d’un point de terminaison de connexion privée existant.

Exemples¶

AWS:

Mise à jour du nom d’hôte d’un point de terminaison privé pour autoriser Snowflake sur Amazon Web Services à se connecter au service VPCE dans votre VPC Amazon Web Services :

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 :

Mise à jour du nom d’hôte d’un point de terminaison privé pour autoriser Snowflake sur Microsoft Azure à se connecter au service Management API Microsoft Azure dans votre VNet Microsoft Azure :

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 :

Mise à jour du nom d’hôte d’un point de terminaison privé pour autoriser Snowflake sur Google Cloud Platform à se connecter à la pièce jointe du service dans votre réseau VPC Google Cloud Platform :

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