- Catégories :
Fonctions système (Informations système)
SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO¶
Renvoie le statut de tous les points de terminaison de connectivité privée que vous provisionnez. 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.
Syntaxe¶
SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO()
Renvoie¶
Renvoie un objet JSON avec les champs suivants :
AWS:
provider_service_name
Nom du service ou de la ressource.
snowflake_endpoint_name
ID du point de terminaison VPC dans votre compte Snowflake. Ce champ contient un nom temporaire pendant la création du point de terminaison. Une fois que le point de terminaison est créé, et que
endpoint_state
passe àCREATED
, ce nom change.endpoint_state
État du point de terminaison dans Snowflake. Ce champ peut contenir l’un des états suivants :
PENDING_CREATION
: le point de terminaison est en cours de création.
CREATED
: indique que Snowflake a reçu une réponse du fournisseur de Cloud indiquant que le point de terminaison a été créé avec succès et qu’il est prêt à être utilisé.
FAILED
: le point de terminaison se trouve dans un état inattendu sur le fournisseur Cloud, et ne peut pas être utilisé.
PENDING_DELETION
: le point de terminaison est dans la file d’attente de suppression, mais peut être restauré.
DELETING
: le point de terminaison est en cours de suppression sur le fournisseur Cloud et ne peut pas être restauré.host
Nom d’hôte utilisé pour se connecter au service.
status
Statut du point de terminaison sur AWS. Ce champ peut contenir l’un des statuts suivants :
Pending
: le point de terminaison est en cours de création.
Available
: le point de terminaison est créé et prêt à être utilisé.
Azure :
provider_resource_id
ID de la ressource Azure à laquelle le point de terminaison se connecte.
subresource
Sous-ressource de la ressource Azure à laquelle le point de terminaison se connecte.
snowflake_resource_id
ID de la ressource Azure du point de terminaison privé qui se connecte à la ressource Azure.
host
Nom d’hôte utilisé pour se connecter à la ressource.
endpoint_state
État du point de terminaison dans Snowflake. Ce champ peut contenir l’un des états suivants :
PENDING_CREATION
: le point de terminaison est en cours de création.
CREATED
: indique que Snowflake a reçu une réponse du fournisseur de Cloud indiquant que le point de terminaison a été créé avec succès et qu’il est prêt à être utilisé.
FAILED
: le point de terminaison se trouve dans un état inattendu sur le fournisseur Cloud, et ne peut pas être utilisé.
PENDING_DELETION
: le point de terminaison est dans la file d’attente de suppression, mais peut être restauré.
DELETING
: le point de terminaison est en cours de suppression sur le fournisseur Cloud et ne peut pas être restauré.status
Statut du point de terminaison sur Microsoft Azure. Ce champ permet de déterminer si Microsoft Azure a approuvé la connexion du point de terminaison privé à la ressource. Ce champ peut contenir l’un des statuts suivants :
APPROVED
PENDING
DISCONNECTED
REJECTED
Google Cloud :
provider_resource_id
L’ID de ressource (ID d’attachement de service) auquel le point de terminaison de connexion privée se connecte.
snowflake_resource_id
L’identificateur du point de terminaison de la connexion privée.
host
Le nom d’hôte à utiliser lors de l’accès au service du fournisseur ou à la ressource qui utilise ce point de terminaison.
endpoint_state
État du point de terminaison côté Snowflake.
status
Le statut de la connexion sur Google Cloud. NO CONNECTION peut s’afficher peu après la création du point de terminaison de connexion privée, car le fournisseur cloud prend du temps pour finaliser la configuration de la connexion. Ce champ peut contenir l’un des statuts suivants :
ACCEPTED
NO CONNECTION
REJECTED
Notes sur l’utilisation¶
Cette fonction peut prendre environ cinq minutes à exécuter car elle dépend du processus de récupération des points de terminaison de connexion privée sur la plateforme cloud qui sont en dehors de Snowflake.
Exemples¶
AWS:
Répertorier tous les points de terminaison PrivateLink ayant un accès externe à Amazon S3, exécuter l’instruction SQL suivante :
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();
[
{
"provider_service_name": "com.amazonaws.us-west-2.s3",
"snowflake_endpoint_name": "vpce-123456789012abcdea",
"endpoint_state": "CREATED",
"host": "*.s3.us-west-2.amazonaws.com",
"status": "Available"
},
...
Pour votre compte Snowflake sur Amazon Web Services, renvoyez le point de terminaison de connexion privée pour un identificateur de ressource spécifique :
Azure :
Pour votre compte Snowflake sur Microsoft Azure, répertoriez les points de terminaison de connectivité privée que vous avez provisionnés et les noms de service auxquels chaque point de terminaison est associé :
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();[ { "provider_resource_id": "/subscriptions/11111111-2222-3333-4444-5555555555/...", "subresource": "sqlServer", "snowflake_resource_id": "/subscriptions/fa57a1f0-b4e6-4847-9c00-95f39520f...", "host": "testdb.database.windows.net", "endpoint_state": "CREATED", "status": "Approved", } ]
Google Cloud
Pour votre compte Snowflake sur Google Cloud, répertoriez les points de terminaison de connexion privée que vous avez provisionnés et les noms de service auxquels chaque point de terminaison est associé :
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();[ { "provider_resource_id": "projects/my-project/regions/us-east4/serviceAttachments/...", "snowflake_resource_id": "abcd0000000000000001", "host": "my-service.com", "endpoint_state": "CREATED", "status": "ACCEPTED", } ]