SnowCD (Connectivity Diagnostic Tool)¶

Étape 1 : exécution de la fonction SYSTEM$ALLOWLIST ou SYSTEM$ALLOWLIST_PRIVATELINK¶

Cette étape est une condition préalable et doit être effectuée, sauf si les noms d’hôte ou les ports sont modifiés.

1. Connectez-vous à Snowflake par le biais de l’interface Web.

2. Exécutez SELECT SYSTEM$ALLOWLIST(); ou SELECT SYSTEM$ALLOWLIST_PRIVATELINK();.

3. Enregistrez le résultat de la requête dans un fichier (c.-à-d. allowlist.json).

Pour plus d’informations sur ces fonctions, voir SYSTEM$ALLOWLIST ou SYSTEM$ALLOWLIST_PRIVATELINK.

Les exemples ci-dessous utilisent JSON comme format de sortie de la fonction SQL correspondante. SnowCD accepte le format JSON, CSV ou TSV comme entrée pour l’étape 3 : exécution de SnowCD.

Pour enregistrer le résultat de la requête au format CSV ou TSV, dans l’interface Web, cliquez sur l’icône Download or View Results, sélectionnez CSV ou TSV, puis cliquez sur Export.

Exemple de fichier (non mis en retrait et édité)

Exécutez SYSTEM$ALLOWLIST et enregistrez la sortie dans un fichier (par exemple allowlist.json).

Où :

<emplacement_stockage> est l’emplacement de stockage (Amazon S3, Google Cloud Storage ou Microsoft Azure) qui stocke le fichier auquel le client Snowflake peut accéder en lecture et en écriture.

<id_région> est la région AWS où se trouvent vos comptes VPCs et Snowflake.

[{"type":"STAGE","host":"<storage_location>.s3.<region_id>.amazonaws.com","port":443},
{"type":"STAGE","host":"<storage_location>.s3-<region_id>.amazonaws.com","port":443},
{"type":"STAGE","host":"<storage_location>.s3.amazonaws.com","port":443},
{"type":"SNOWSQL_REPO","host":"<repository_name_1>.s3.<region_id>.amazonaws.com","port":443},
{"type":"SNOWSQL_REPO","host":"<repository_name_2>.snowflakecomputing.com","port":443},
{"type":"OUT_OF_BAND_TELEMETRY","host":"<telemetry_subdomain>.snowflakecomputing.com","port":443},
{"type":"OCSP_CACHE","host":"ocsp.snowflakecomputing.com","port":80},
{"type":"OCSP_RESPONDER","host":"ocsp.digicert.com","port":80}]

Copy

Exemple de fichier (non mis en retrait et édité)

Exécutez SYSTEM$ALLOWLIST et enregistrez la sortie dans un fichier (par exemple allowlist.json).

Où :

<emplacement_stockage> est l’emplacement de stockage (Amazon S3, Google Cloud Storage ou Microsoft Azure) qui stocke le fichier auquel le client Snowflake peut accéder en lecture et en écriture.

<id_région> est la région AWS où se trouvent vos comptes VPCs et Snowflake.

[{
  "type": "STAGE",
  "host": "<storage_location>.s3.<region_id>.amazonaws.com",
  "port": 443
}, {
  "type": "STAGE",
  "host": "<storage_location>.s3-<region_id>.amazonaws.com",
  "port": 443
}, {
  "type": "STAGE",
  "host": "<storage_location>.s3.amazonaws.com",
  "port": 443
}, {
  "type": "SNOWSQL_REPO",
  "host": "<repository_name_1>.s3.<region_id>.amazonaws.com",
  "port": 443
}, {
  "type": "SNOWSQL_REPO",
  "host": "<repository_name_2>.snowflakecomputing.com",
  "port": 443
}, {
  "type": "OUT_OF_BAND_TELEMETRY",
  "host": "<telemetry_subdomain>.snowflakecomputing.com",
  "port": 443
}, {
  "type": "OCSP_CACHE",
  "host": "ocsp.snowflakecomputing.com",
  "port": 80
}, {
  "type": "OCSP_RESPONDER",
  "host": "ocsp.digicert.com",
  "port": 80
}]

Copy

Exemple de fichier (non mis en retrait et édité)

Exécutez SYSTEM$ALLOWLIST_PRIVATELINK et enregistrez la sortie dans un fichier (par exemple allowlist.json).

Où :

<emplacement_stockage> est l’emplacement de stockage (Amazon S3, Google Cloud Storage ou Microsoft Azure) qui stocke le fichier auquel le client Snowflake peut accéder en lecture et en écriture.

<id_région> est la région AWS où se trouvent vos comptes VPCs et Snowflake.

[{"type":"SNOWFLAKE_DEPLOYMENT","host":"<storage_location>.<region>.privatelink.snowflakecomputing.com","port":443},
{"type":"STAGE","host":"<storage_location>.<region>.amazonaws.com","port":443},
{"type":"STAGE","host":"<storage_location>-<region>.amazonaws.com","port":443},
{"type":"STAGE","host":"<storage_location>.amazonaws.com","port":443},
{"type":"SNOWSQL_REPO","host":"<repository_name_1>.s3.<region>.amazonaws.com","port":443},
{"type":"SNOWSQL_REPO","host":"<repository_name_2>.snowflakecomputing.com","port":443},
{"type":"OUT_OF_BAND_TELEMETRY","host":"<telemetry_subdomain>.snowflakecomputing.com","port":443},
{"type":"OCSP_CACHE","host":"ocsp.<storage_location>.<region>.privatelink.snowflakecomputing.com","port":80}]

Copy

Exemple de fichier (non mis en retrait et édité)

Exécutez SYSTEM$ALLOWLIST_PRIVATELINK et enregistrez la sortie dans un fichier (par exemple allowlist.json).

Où :

<emplacement_stockage> est l’emplacement de stockage (Amazon S3, Google Cloud Storage ou Microsoft Azure) qui stocke le fichier auquel le client Snowflake peut accéder en lecture et en écriture.

<id_région> est la région AWS où se trouvent vos comptes VPCs et Snowflake.

[{
  "type": "SNOWFLAKE_DEPLOYMENT",
  "host": "<storage_location>.<region>.privatelink.snowflakecomputing.com",
  "port": 443
}, {
  "type": "STAGE",
  "host": "<storage_location>.<region>.amazonaws.com",
  "port": 443
}, {
  "type": "STAGE",
  "host": "<storage_location>-<region>.amazonaws.com",
  "port": 443
}, {
  "type": "STAGE",
  "host": "<storage_location>.amazonaws.com",
  "port": 443
}, {
  "type": "SNOWSQL_REPO",
  "host": "<repository_name_1>.s3.<region>.amazonaws.com",
  "port": 443
}, {
  "type": "SNOWSQL_REPO",
  "host": "<repository_name_2>.snowflakecomputing.com",
  "port": 443
}, {
  "type": "OUT_OF_BAND_TELEMETRY",
  "host": "<telemetry_subdomain>.snowflakecomputing.com",
  "port": 443
}, {
  "type": "OCSP_CACHE",
  "host": "ocsp.<storage_location>.<region>.privatelink.snowflakecomputing.com",
  "port": 80
}]

Copy

use warehouse my_warehouse;
select value:type as type,
       value:host as host,
       value:port as port
   from table(flatten(input => parse_json(system$allowlist())));

Étape 2 : téléchargement et installation de SnowCD¶

Étape 3 : exécution de SnowCD¶

Avant d’exécuter SnowCD dans des environnements macOS et Linux, vous pouvez ajouter son répertoire à votre $PATH. Dans les environnements Windows, vous pouvez ajouter SnowCD à vos variables d’environnement.

1. Dans les environnements macOS ou Linux, vous pouvez lancer l’exécutable snowcd à partir de la ligne de commande en exécutant snowcd <path_to_allowlist.json> [flags].

2. Dans les environnements Windows, exécutez snowcd.exe <path_to_allowlist.json> [flags].

Si toutes les vérifications sont valides, SnowCD renvoie le nombre de vérifications sur le nombre d’hôtes avec le message All checks passed comme suit.

Performing 30 checks on 12 hosts
All checks passed

Si vous essayez d’exécuter SnowCD sans transmettre les informations de la liste autorisée JSON depuis SELECT SYSTEM$ALLOWLIST(), le message d’erreur suivant s’affiche pour rappeler d’inclure le fichier, avec la liste des indicateurs actuellement pris en charge, leur type de données, le cas échéant, et une brève description de l’indicateur.

Error: please provide whitelist generated by SYSTEM$ALLOWLIST()
Usage:
./snowcd <path to input json file> [flags]

Examples:
./snowcd test.json

Flags:
  -h, --help                   help for ./snowcd
  --logLevel string            log level (panic, fatal[default], error, warning, info, debug, trace) (default "fatal")
  --logPath string             Output directory for log. When not specified, no log is generated
  --proxyHost string           host for http proxy. (When not specified, does not use proxy at all)
  --proxyIsHTTPS               Is connection to proxy secure, i.e. https. (default false)
  --proxyPassword string       password for http proxy.(default empty)
  --proxyPort int              port for http proxy.(default 8080) (default 8080)
  --proxyUser string           user name for http proxy.(default empty)
  -t, --timeout int            timeout for each hostname's checks in seconds (default 5) (default 5)
  --version                    version for ./snowcd

Si SnowCD détecte un paramètre incorrect ou une configuration incorrecte, des informations sur les vérifications ayant échoué s’affichent avec une suggestion de dépannage. Par exemple, la réponse ci-dessous indique un nom d’hôte non valide.

Check for 1 hosts failed, display as follow:
==============================================
Host: www.google1.com
Port: 443
Type: SNOWFLAKE_DEPLOYMENT
Failed Check: DNS Check
Error: lookup www.google1.com: no such host
Suggestion: Check your configuration on DNS server

Utilisation de SnowCD avec un proxy HTTP¶

SnowCD peut être exécuté sur un proxy HTTP pour déterminer son statut de connectivité.

En utilisant Linux comme exemple représentatif, exécutez la commande suivante pour exécuter SnowCD sur un proxy, en remplaçant les valeurs d’indicateur si nécessaire.

snowcd allowlist.json \
  --proxyHost <hostname> \
  --proxyPort <port_number> \
  --proxyUser <username> \
  --proxyPassword <password>

La journalisation est facultative et vous pouvez ajouter les deux indicateurs de journalisation à la commande proxy. Il est important d’inclure un chemin d’accès au fichier journal pour vous assurer que la journalisation a lieu lors de l’exécution de la commande.

snowcd allowlist.json \
  --proxyHost <hostname> \
  --proxyPort <port_number> \
  --proxyUser <username> \
  --proxyPassword <password> \
  --logLevel trace \
  --logPath test.log

Après avoir exécuté cette commande, vous pouvez afficher la trace dans le fichier test.log.