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 Snowflake.

Syntaxe¶

SYSTEM$GET_PRIVATELINK_CONFIG()

Copy

Arguments¶

Aucun.

Renvoie¶

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>",
  "privatelink-connection-ocsp-urls": "<client_redirect_ocsp_url_list>",
  "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>",
  "regionless-privatelink-account-url": "<privatelink_org_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-vpce-id": "<aws_vpce_id>",
  "privatelink-account-principal": "<aws_principal_arn>",
  "regionless-privatelink-ocsp-url": "<privatelink_org_ocsp_url>",
  "app-service-privatelink-url": "<privatelink_streamlit_url>",
  "privatelink-dashed-urls-for-duo": "<privatelink_duo_url_list>"
}

Copy

Microsoft Azure

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "privatelink-connection-ocsp-urls": "<client_redirect_ocsp_url_list>",
  "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>",
  "regionless-privatelink-account-url": "<privatelink_org_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-pls-id": "<azure_privatelink_service_id>",
  "regionless-privatelink-ocsp-url": "<privatelink_org_ocsp_url>",
  "privatelink-dashed-urls-for-duo": "<privatelink_duo_url_list>"
}

Copy

Google Cloud Platform

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "privatelink-connection-ocsp-urls": "<client_redirect_ocsp_url_list>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>",
  "regionless-privatelink-account-url": "<privatelink_org_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-gcp-service-attachment": "<snowflake_service_endpoint>",
  "regionless-privatelink-ocsp-url": "<privatelink_org_ocsp_url>",
  "privatelink-dashed-urls-for-duo": "<privatelink_duo_url_list>"
}

Copy

Où :

regionless-snowsight-privatelink-url
L’URL de votre organisation pour accéder à Snowsight en utilisant la 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 : l’interface Web de Snowflake.

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

Utilisez cette valeur avec les clients pour Applications et outils pour se connecter à Snowflake.

Pour plus d’informations, voir Identificateurs de compte.

privatelink-connection-ocsp-urls
La liste d’URLs OCSP à utiliser avec Redirection des connexions des clients.

La liste des valeurs doit correspondre à la sortie pour OCSP_CLIENT_FAILOVER de la fonction SYSTEM$ALLOWLIST_PRIVATELINK.

snowsight-privatelink-url
L’URL contenant la région Cloud pour accéder à Snowsight et Snowflake Marketplace en utilisant la 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 : 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 la 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.

regionless-privatelink-account-url
L’URL de la connectivité privée qui comprend le nom de votre organisation et le nom de votre compte.

Cette valeur correspond à la valeur de sortie de SNOWFLAKE_DEPLOYMENT_REGIONLESS dans 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-account-principal
Le principal AWS ARN pour permettre des connexions privées sortantes vers vos services de point de terminaison VPC.

Utilisez cette valeur pour définir le principal autorisé de votre service de point de terminaison, qui permet à Snowflake de se connecter à votre service de point de terminaison via AWSPrivateLink.

privatelink-pls-id
L’ID de service Microsoft Azure Private Link pour l’identificateur de votre compte sous la forme d’un alias. Par exemple :

sf-pvlinksvc-azurecentralus.<unique_identifier>.centralus.azure.privatelinkservice

Où <l'identificateur unique> est au format GUID/UUID.

Utilisez cette valeur pour créer un point de terminaison privé Azure Private Link. Si vous recevez une erreur lors de la création du point de terminaison privé, contactez le support Snowflake et demandez l’ID de la ressource qui est associée à cette valeur d’alias.

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.

"regionless-privatelink-ocsp-url
L” URL OCSP de votre identificateur de compte.

La valeur est enregistrée comme suit :

"ocsp.org_name-account_name.privatelink.snowflakecomputing.com"

Où :

org_name est le nom de votre organisation Snowflake.

account_name est le nom unique de votre compte au sein de votre organisation.

app-service-privatelink-url
L’URL générique requise pour acheminer le trafic de l’application Streamlit via AWS PrivateLink.

privatelink-dashed-urls-for-duo
La liste des variantes d’URLs en pointillés n’est affichée que lorsque le nom d’hôte contient un trait de soulignement. Ces URLs sont utilisées pour l’authentification multifactorielle Duo.

Notes sur l’utilisation¶

Seuls les administrateurs de compte (utilisateurs dotés du rôle ACCOUNTADMIN) peuvent exécuter cette fonction.
Pour les comptes Snowflake sur Microsoft Azure, si vous appelez la fonction et que le temps de requête est supérieur à une minute, contactez le support Snowflake.

Exemples¶

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

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

Copy

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>"               |
|--------------------------------------+--------------------------------------|
| privatelink-connection-ocsp-urls     | "<client_redirect_ocsp_url_list>"    |
|--------------------------------------+--------------------------------------|
| 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>"    |
|--------------------------------------+--------------------------------------|
| regionless-privatelink-account-url   | "<privatelink_org_account_url>"      |
|--------------------------------------+--------------------------------------|
| privatelink-ocsp-url                 | "<privatelink_ocsp_url>"             |
|--------------------------------------+--------------------------------------|
| regionless-privatelink-ocsp-url      | "<privatelink_org_ocsp_url>"         |
+--------------------------------------+--------------------------------------+

Copy