- Catégories :
Fonctions système (Contrôle du système)
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT¶
Restaure un point de terminaison de connectivité privée dans le VPC ou VNet Snowflake pour permettre à Snowflake de se connecter à un service externe à l’aide d’une connectivité privée. Le point de terminaison peut être un point de terminaison de service ou un point de terminaison de ressource selon la plateforme cloud qui héberge votre compte Snowflake.
Vous pouvez restaurer un point de terminaison privé dans les 7 jours suivant son déprovisionnement. Après 7 jours, le point de terminaison ne peut pas être restauré et vous devez recréer le point de terminaison avec la fonction système SYSTEM$PROVISION_PRIVATELINK_ENDPOINT.
Syntaxe¶
AWS:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT( '<provider_service_name>' )
Azure :
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
'<provider_resource_id>'
[, '<subresource>' ]
)
Arguments¶
provider_service_name
Spécifie le service externe ou le point de terminaison de ressource à rétablir. Par exemple,
com.amazonaws.us-west-2.execute-api
pour Amazon API Gateway oucom.amazonaws.us-west-2.s3
pour Amazon S3.
'provider_resource_id'
Spécifie l’identificateur complet de la ressource dans votre VPC ou VNet.
'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.
Renvoie¶
Renvoie un message de statut indiquant que le point de terminaison, avec son identificateur, est restauré correctement.
En cas d’échec, une erreur est renvoyée. Par exemple, si l’argument fourni n’est pas un point de terminaison existant valide. Si vous ne connaissez pas le nom du point de terminaison, vous pouvez utiliser la fonction système SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO pour répertorier tous les points de terminaison de votre compte Snowflake.
Notes sur l’utilisation¶
Seuls les administrateurs de comptes (utilisateurs dotés du rôle ACCOUNTADMIN) peuvent appeler cette fonction.
Un message d’erreur s’affiche si un point de terminaison de connectivité privée n’est pas associé aux arguments spécifiés.
Exemples¶
AWS:
Rétablir un point de terminaison privé avec un accès externe à Amazon S3 :
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT('com.amazonaws.us-west-2.s3');
Azure :
Restaurez un point de terminaison privé pour permettre à Snowflake sur Microsoft Azure de se connecter au service de gestion des API Azure dans votre VNet Azure :
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.