Catégories :: Fonctions système (Informations système)

SYSTEM$GET_PRIVATELINK_CONFIG¶

Renvoie une représentation JSON des informations du compte Snowflake nécessaires pour faciliter la configuration en libre-service de la connectivité privée au service Snowflake ou aux zones de préparation internes.

Syntaxe¶

SYSTEM$GET_PRIVATELINK_CONFIG()

Arguments¶

Aucun.

Notes sur l’utilisation¶

Seuls les administrateurs de compte (utilisateurs dotés du rôle ACCOUNTADMIN) peuvent exécuter cette fonction.

Sortie¶

La fonction renvoie un objet JSON contenant les paires nom/valeur suivantes, en fonction de la plate-forme Cloud où se trouve votre compte Snowflake :

AWS

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-internal-stage": "<privatelink_stage_endpoint>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>"
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-vpce-id": "<aws_vpce_id>"
}

Microsoft Azure

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-internal-stage": "<privatelink_stage_endpoint>",
  "privatelink-account-url":"<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>"
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-pls-id": "<azure_privatelink_service_id>"
}

Google Cloud Platform

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>"
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-gcp-service-attachment": "<snowflake_service_endpoint>"
}

Où :

regionless-snowsight-privatelink-url
L’URL de votre organisation pour accéder à Snowsight en utilisant Connectivité privée au service Snowflake.

Utilisez cette URL pour créer un nom canonique (c’est-à-dire CNAME) pour la résolution DNS. Cette URL doit correspondre à la sortie pour le SNOWSIGHT_DEPLOYMENT_REGIONLESS (c’est-à-dire TYPE) de la fonction SYSTEM$ALLOWLIST_PRIVATELINK.

Pour plus d’informations, voir Identificateurs de compte et Snowsight : connectez-vous à l’interface Web de Snowflake..

privatelink-account-name
L’identificateur de votre compte Snowflake.

Utilisez cette valeur avec les clients pour Connexion à Snowflake.

Pour plus d’informations, voir Identificateurs de compte.

snowsight-privatelink-url
Les URL contenant la région Cloud pour accéder à Snowsight et Snowflake Marketplace utilisant Connectivité privée au service Snowflake.

Utilisez cette URL pour créer un nom canonique (c’est-à-dire CNAME) pour la résolution DNS. Cette URL doit correspondre à la sortie pour le SNOWSIGHT_DEPLOYMENT (c’est-à-dire TYPE) de la fonction SYSTEM$ALLOWLIST_PRIVATELINK.

Pour plus d’informations, voir Identificateurs de compte et Snowsight : connectez-vous à l’interface Web de Snowflake..

privatelink-internal-stage
Le point de terminaison pour se connecter à votre zone de préparation interne Snowflake en utilisant AWS PrivateLink ou Azure Private Link.

Utilisez cette valeur avec Connectivité privée aux zones de préparation internes de Snowflake.

La visibilité de cette clé et de la valeur correspondante dans le résultat de la requête dépend du paramètre ENABLE_INTERNAL_STAGES_PRIVATELINK. Le paramètre par défaut pour ce paramètre est FALSE. Vous devez définir ce paramètre sur TRUE avant d’exécuter cette fonction système pour obtenir le point de terminaison de la zone de préparation interne dans le résultat de la requête.

privatelink-account-url
L’URL pour vous connecter à votre compte Snowflake en utilisant AWS PrivateLink, Azure Private Link ou Google Cloud Private Service Connect.

Utilisez cette valeur pour créer un nom canonique (c’est-à-dire CNAME) pour la résolution DNS. Cette URL doit correspondre à la sortie de SYSTEM$ALLOWLIST_PRIVATELINK.

Pour plus d’informations sur les formats d’URL, voir Identificateurs de compte.

privatelink-connection-urls
La liste des URLs de connexion pour Redirection des clients.

Utilisez ces URLs pour créer un nom canonique (c’est-à-dire CNAME) pour la résolution DNS. Ces URL doivent correspondre à la sortie pour CLIENT_FAILOVER (c’est-à-dire TYPE) de la fonction SYSTEM$ALLOWLIST_PRIVATELINK.

privatelink-ocsp-url
L’URL OCSP correspondant à l’identificateur de votre compte Snowflake qui utilise AWS PrivateLink, Microsoft Azure Private Link ou Google Cloud Private Service Connect.

Utilisez cette valeur pour créer un nom canonique (c’est-à-dire CNAME) pour la résolution DNS.

privatelink-vpce-id
L’ID VPCE AWS de votre identificateur de compte.

Utilisez cette valeur pour créer un point de terminaison VPC AWS (c’est-à-dire VPCE).

privatelink-pls-id
L’ID de service Microsoft Azure Private Link pour l’identificateur de votre compte.

Utilisez cette valeur pour créer un point de terminaison privé Azure Private Link.

privatelink-gcp-service-attachment
Le point de terminaison du service Snowflake lorsque vous utilisez Google Cloud Private Service Connect.

Utilisez cette valeur lorsque vous créez une règle de transfert pour acheminer le point de terminaison Private Service Connect de votre VPC vers le service Snowflake.

Exemples¶

Récupérez les informations JSON de votre compte Snowflake sur AWS :

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

Vous pouvez éventuellement exécuter la commande suivante pour aplatir la sortie JSON. La sortie suivante est un exemple pour un compte Snowflake sur Microsoft Azure :

select key, value from table(flatten(input=>parse_json(SYSTEM$GET_PRIVATELINK_CONFIG())));

+-----------------------------------------------------------------------------+
| KEY                                  | VALUE                                |
+-----------------------------------------------------------------------------+
| regionless-snowsight-privatelink-url | "<privatelink_org_snowsight_url>"    |
|--------------------------------------|--------------------------------------|
| privatelink-account-name             | "<account_identifier>"               |
|--------------------------------------|--------------------------------------|
| snowsight-privatelink-url            | "<privatelink_region_snowsight_url>" |
|--------------------------------------|--------------------------------------|
| privatelink-internal-stage           | "<privatelink_stage_endpoint>"       |
|--------------------------------------|--------------------------------------|
| privatelink-account-url              | "<privatelink_account_url>"          |
|--------------------------------------|--------------------------------------|
| privatelink-connection-urls          | "<privatelink_connection_url_list>"  |
|--------------------------------------|--------------------------------------|
| privatelink-pls-id                   | "<azure_private_link_service_id>"    |
|--------------------------------------|--------------------------------------|
| privatelink-ocsp-url                 | "<privatelink_ocsp_url>"             |
+--------------------------------------|--------------------------------------+