Catégories :

Fonctions système (Informations système)

SYSTEM$WHITELIST — Obsolète

Renvoie les noms d’hôte et les numéros de port à ajouter à la liste autorisée de votre pare-feu afin que vous puissiez accéder à Snowflake de derrière votre pare-feu. La sortie de cette fonction peut ensuite être transmise à SnowCD.

En règle générale, les clients Snowflake utilisent un pare-feu pour empêcher tout accès non autorisé. Par défaut, votre pare-feu peut bloquer l’accès à Snowflake. Pour mettre à jour la liste autorisée de votre pare-feu, vous devez connaître les noms d’hôte et les numéros de port de l’URL de votre compte Snowflake, de vos zones de préparation et des autres hôtes utilisés par Snowflake.

Pour plus de détails sur la liste autorisée pour les clients Snowflake que vous utilisez, voir Autorisation des noms d’hôte.

Syntaxe

SYSTEM$WHITELIST()
Copy

Arguments

Aucune.

Renvoie

Le type de données de la valeur renvoyée est VARIANT. La valeur est un tableau de structures JSON. Chaque structure JSON contient trois paires clé/valeur :

type

Snowflake prend en charge les types suivants :

SNOWFLAKE_DEPLOYMENT

Informations sur le nom d’hôte et le numéro de port de votre compte Snowflake.

SNOWFLAKE_DEPLOYMENT_REGIONLESS

Informations sur le nom d’hôte et le numéro de port de votre organisation.

Pour plus d’informations, voir Identificateurs de compte.

STAGE

Emplacement (Amazon S3, Google Cloud Storage ou Microsoft Azure) où sont stockés les fichiers que le client Snowflake peut lire ou écrire.

SNOWSQL_REPO

Point de terminaison auquel accède SnowSQL pour effectuer des téléchargements/mises à niveau automatiques.

OUT_OF_BAND_TELEMETRY

Les hôtes auxquels les pilotes signalent des métriques et des incidents hors bande tels que des problèmes OCSP.

CLIENT_FAILOVER

Nom d’hôte et port de l’URL de connexion pour la redirection client. Notez que chaque ligne de la sortie de la requête qui spécifie cette valeur se réfère soit à la connexion principale, soit à la connexion secondaire, selon la façon dont les URLs de connexion ont été configurés.

OCSP_CACHE

Une autre source d’informations de certificat OCSP fournie par Snowflake au cas où le répondeur principal OCSP ne serait pas joignable. La plupart des dernières versions des clients Snowflake accèdent au cache OCSP au lieu de se connecter directement au répondeur OCSP.

OCSP_CACHE_REGIONLESS

Source alternative fournie par Snowflake d’informations sur les certificats OCSP pour votre organisation. La plupart des dernières versions des clients Snowflake accèdent au cache OCSP au lieu de se connecter directement au répondeur OCSP.

OCSP_CLIENT_FAILOVER

Source alternative fournie par Snowflake d’informations sur les certificats OCSP pour la redirection de clients.

DUO_SECURITY

Le nom d’hôte du service Duo Security qui est utilisé avec Authentification multifactorielle (MFA) lors de l’authentification à Snowflake.

OCSP_RESPONDER

Nom d’hôte à contacter pour vérifier que le certificat OCSP TLS n’a pas été révoqué.

Notez que cette valeur n’est pas nécessaire lors de la configuration de la connectivité privée au service Snowflake ; suivez les instructions de la rubrique correspondante pour sélectionner la valeur OCSP à ajouter à votre liste d’autorisations.

SNOWSIGHT_DEPLOYMENT_REGIONLESS

Nom d’hôte et numéro de port permettant à votre organisation d’accéder à Snowsight.

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

SNOWSIGHT_DEPLOYMENT

Nom d’hôte et port pour accéder à Snowsight pour votre compte Snowflake.

host

Spécifie le nom d’hôte complet pour type (ex. : "ocsp.snowflakecomputing.com", "xy12345.east-us-2.azure.snowflakecomputing.com").

port

Spécifie le numéro de port pour type (par exemple, 443, 80).

Notes sur l’utilisation

  • Notez que la fonction doit être appelée en tant que fonction système.

  • La sortie peut inclure plusieurs entrées pour certains types (STAGE, OCSP_RESPONDER, etc.).

Exemples

Pour appeler la fonction :

SELECT SYSTEM$WHITELIST();
Copy

Exemple de sortie :

[
  {"type":"SNOWFLAKE_DEPLOYMENT", "host":"xy12345.snowflakecomputing.com",                 "port":443},
  {"type":"STAGE",                "host":"sfc-customer-stage.s3.us-west-2.amazonaws.com",  "port":443},
  ...
  {"type":"SNOWSQL_REPO",         "host":"sfc-repo.snowflakecomputing.com",                "port":443},
  ...
  {"type":"OCSP_CACHE",           "host":"ocsp.snowflakecomputing.com",                    "port":80}
  {"type":"OCSP_RESPONDER",       "host":"o.ss2.us",                                       "port":80},
  ...
]
Copy

Dans cet exemple de sortie, notez les éléments suivants :

  • Pour des raisons de lisibilité, des espaces et des caractères de nouvelle ligne ont été ajoutés. De plus, certaines entrées ont été omises.

  • L’ID de région (us-west-2) de certains noms d’hôtes indique que le compte se trouve dans la région US Ouest. Cependant, l’ID de région n’est pas utilisé dans le nom d’hôte pour SNOWFLAKE_DEPLOYMENT.

Pour extraire des informations dans une sortie tabulaire plutôt que JSON, utilisez la fonction FLATTEN conjointement avec la fonction PARSE_JSON :

SELECT t.VALUE:type::VARCHAR as type,
       t.VALUE:host::VARCHAR as host,
       t.VALUE:port as port
FROM TABLE(FLATTEN(input => PARSE_JSON(SYSTEM$WHITELIST()))) AS t;
Copy

Exemple de sortie :

+-----------------------+---------------------------------------------------+------+
| TYPE                  | HOST                                              | PORT |
|-----------------------+---------------------------------------------------+------|
| SNOWFLAKE_DEPLOYMENT  | xy12345.snowflakecomputing.com                    | 443  |
| STAGE                 | sfc-customer-stage.s3.us-west-2.amazonaws.com     | 443  |
  ...
| SNOWSQL_REPO          | sfc-repo.snowflakecomputing.com                   | 443  |
  ...
| OCSP_CACHE            | ocsp.snowflakecomputing.com                       | 80   |
| OCSP_RESPONDER        | ocsp.sca1b.amazontrust.com                        | 80   |
  ...
+-----------------------+---------------------------------------------------+------+
Copy