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

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"
  },
  ...

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

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

SQLReturned value

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();

Copy