SnowCD (Connectivity Diagnostic Tool)¶

Schritt 1: Funktion SYSTEM$ALLOWLIST oder SYSTEM$ALLOWLIST_PRIVATELINK ausführen¶

Dies ist eine Voraussetzung und muss einmal ausgeführt werden, es sei denn, die Hostnamen oder Ports ändern sich.

1. Stellen Sie über die Weboberfläche eine Verbindung zu Snowflake her.

2. Führen Sie SELECT SYSTEM$ALLOWLIST(); oder SELECT SYSTEM$ALLOWLIST_PRIVATELINK(); aus.

3. Speichern Sie das Abfrageergebnis in eine Datei (d. h. allowlist.json).

Weitere Informationen zu diesen Funktionen finden Sie unter SYSTEM$ALLOWLIST oder SYSTEM$ALLOWLIST_PRIVATELINK.

In den folgenden Beispielen wird JSON als Ausgabeformat der entsprechenden SQL-Funktion verwendet. SnowCD akzeptiert entweder das JSON-, CSV- oder TSV-Format als Eingabe für Schritt 3: SnowCD ausführen.

Um das Abfrageergebnis im CSV- oder TSV-Format zu speichern, klicken Sie auf der Weboberfläche auf das Symbol Download or View Results, wählen Sie entweder CSV oder TSV aus, und klicken Sie auf Export.

Beispieldatei (nicht eingerückt und redigiert)

Führen Sie SYSTEM$ALLOWLIST aus, und speichern Sie die Ausgabe in eine Datei (z. B. allowlist.json).

Wobei:

<Speicherort> ist der Speicherort (Amazon S3, Google Cloud Storage oder Microsoft Azure), in dem die Datei gespeichert ist, die ein Snowflake-Client lesen oder schreiben kann.

<Regions-ID> ist die AWS-Region, in der sich Ihre VPCs und Ihr Snowflake-Konto befinden.

[{"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

Beispieldatei (eingerückt und redigiert)

Führen Sie SYSTEM$ALLOWLIST aus, und speichern Sie die Ausgabe in eine Datei (z. B. allowlist.json).

Wobei:

<Speicherort> ist der Speicherort (Amazon S3, Google Cloud Storage oder Microsoft Azure), in dem die Datei gespeichert ist, die ein Snowflake-Client lesen oder schreiben kann.

<Regions-ID> ist die AWS-Region, in der sich Ihre VPCs und Ihr Snowflake-Konto befinden.

[{
  "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

Beispieldatei (nicht eingerückt und redigiert)

Führen Sie SYSTEM$ALLOWLIST_PRIVATELINK aus, und speichern Sie die Ausgabe in eine Datei (z. B. allowlist.json).

Wobei:

<Speicherort> ist der Speicherort (Amazon S3, Google Cloud Storage oder Microsoft Azure), in dem die Datei gespeichert ist, die ein Snowflake-Client lesen oder schreiben kann.

<Regions-ID> ist die AWS-Region, in der sich Ihre VPCs und Ihr Snowflake-Konto befinden.

[{"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

Beispieldatei (eingerückt und redigiert)

Führen Sie SYSTEM$ALLOWLIST_PRIVATELINK aus, und speichern Sie die Ausgabe in eine Datei (z. B. allowlist.json).

Wobei:

<Speicherort> ist der Speicherort (Amazon S3, Google Cloud Storage oder Microsoft Azure), in dem die Datei gespeichert ist, die ein Snowflake-Client lesen oder schreiben kann.

<Regions-ID> ist die AWS-Region, in der sich Ihre VPCs und Ihr Snowflake-Konto befinden.

[{
  "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())));

Schritt 2: SnowCD herunterladen und installieren¶

Schritt 3: SnowCD ausführen¶

Bevor Sie SnowCD unter macOS und Linux ausführen, können Sie das zugehörige Verzeichnis zu $PATH hinzufügen. In Windows-Umgebungen können Sie SnowCD zu den Umgebungsvariablen hinzufügen.

1. In macOS- oder Linux-Umgebungen können Sie die ausführbare „snowcd“-Datei über die Befehlszeile starten, indem Sie snowcd <path_to_allowlist.json> [flags] ausführen.

2. Führen Sie in Windows-Umgebungen snowcd.exe <path_to_allowlist.json> [flags] aus.

Wenn alle Prüfungen gültig sind, gibt SnowCD die Anzahl der Prüfungen für die Anzahl der Hosts mit der Meldung All checks passed wie folgt zurück.

Performing 30 checks on 12 hosts
All checks passed

Wenn Sie versuchen, SnowCD auszuführen, ohne die Informationen von SELECT SYSTEM$ALLOWLIST() an die JSON-Zulassungsliste zu übergeben, wird die folgende Fehlermeldung angezeigt, um Sie daran zu erinnern, die Datei mit der Liste der derzeit unterstützten Flags, ggf. deren Datentyp sowie eine kurze Beschreibung der Flags einzuschließen.

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

Wenn SnowCD eine falsche Einstellung oder Konfiguration feststellt, werden Informationen zu den fehlgeschlagenen Prüfungen mit einem Vorschlag zur Problembehandlung angezeigt. Die folgende Antwort zeigt beispielsweise einen ungültigen Hostnamen an.

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

Verwenden von SnowCD mit einem HTTP-Proxy¶

SnowCD kann über einen HTTP-Proxy ausgeführt werden, um dessen Konnektivitätsstatus zu ermitteln.

Verwenden Sie Linux als repräsentatives Beispiel, und führen Sie den folgenden Befehl aus, um SnowCD für einen Proxy auszuführen. Ersetzen Sie dabei die Flagwerte, falls erforderlich.

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

Die Protokollierung ist optional. Sie können die beiden Protokollierungsflags zum Proxybefehl hinzufügen. Es ist wichtig, einen Pfad zur Protokolldatei anzugeben, um sicherzustellen, dass beim Ausführen des Befehls die Protokollierung erfolgt.

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

Nachdem Sie diesen Befehl ausgeführt haben, können Sie die Ablaufverfolgung in der Datei test.log anzeigen.