SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO¶

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

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 connectivité privée sur la plateforme Cloud (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"
  },
  ...
]

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é :

SQLReturned value

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();

Copy