SnowCD （Connectivity Diagnostic Tool）¶

ステップ1： SYSTEM$ALLOWLIST または SYSTEM$ALLOWLIST_PRIVATELINK 関数を実行する¶

これは前提条件の手順であり、ホスト名またはポートが変更されない限り、1度完了する必要があります。

1. ウェブインターフェイスを介してSnowflakeに接続します。

2. SELECT SYSTEM$ALLOWLIST(); または SELECT SYSTEM$ALLOWLIST_PRIVATELINK(); を実行します。

3. クエリ結果をファイル（つまり、 allowlist.json）に保存します。

これらの関数の詳細については、 SYSTEM$ALLOWLIST または SYSTEM$ALLOWLIST_PRIVATELINK をご参照ください。

以下の例では、対応する SQL 関数からの出力形式として JSON を使用しています。SnowCD は、 ステップ3： SnowCD を実行する のための入力として、 JSON、 CSV、 TSV 形式のいずれかを受け入れます。

クエリ結果を CSV または TSV 形式で保存するには、ウェブインターフェイスで Download or View Results アイコンをクリックし、 CSV または TSV を選択して、 Export をクリックします。

サンプルファイル（インデントおよび編集なし）

SYSTEM$ALLOWLIST を実行して、出力をファイル（例： allowlist.json）に保存します。

条件:

<ストレージの場所> は、Snowflakeクライアントが読み取りまたは書き込みできるファイルを保存するストレージの場所（つまり、Amazon S3、Google Cloud Storage、またはMicrosoft Azure）です。

<地域ID> は、 AWS 地域で VPCs と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

サンプルファイル（インデントおよび編集済み）

SYSTEM$ALLOWLIST を実行して、出力をファイル（例： allowlist.json）に保存します。

条件:

<ストレージの場所> は、Snowflakeクライアントが読み取りまたは書き込みできるファイルを保存するストレージの場所（つまり、Amazon S3、Google Cloud Storage、またはMicrosoft Azure）です。

<地域ID> は、 AWS 地域で VPCs と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

サンプルファイル（インデントおよび編集なし）

SYSTEM$ALLOWLIST_PRIVATELINK を実行して、出力をファイル（例: allowlist.json）に保存します。

条件:

<ストレージの場所> は、Snowflakeクライアントが読み取りまたは書き込みできるファイルを保存するストレージの場所（つまり、Amazon S3、Google Cloud Storage、またはMicrosoft Azure）です。

<地域ID> は、 AWS 地域で VPCs と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

サンプルファイル（インデントおよび編集済み）

SYSTEM$ALLOWLIST_PRIVATELINK を実行して、出力をファイル（例: allowlist.json）に保存します。

条件:

<ストレージの場所> は、Snowflakeクライアントが読み取りまたは書き込みできるファイルを保存するストレージの場所（つまり、Amazon S3、Google Cloud Storage、またはMicrosoft Azure）です。

<地域ID> は、 AWS 地域で VPCs と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())));

ステップ2： SnowCD をダウンロードし、インストールする¶

ステップ3： SnowCD を実行する¶

macOS およびLinux環境で SnowCD を実行する前に、そのディレクトリを $PATH に追加できます。Windows環境では、環境変数に SnowCD を追加できます。

1. macOS またはLinux環境では、 snowcd <path_to_allowlist.json> [flags] を実行することにより、コマンドラインからsnowcd実行可能ファイルを実行できます。

2. Windows環境では、 snowcd.exe <path_to_allowlist.json> [flags] を実行します。

すべてのチェックが有効な場合、SnowCD はメッセージ All checks passed とともに、ホスト数のチェック数を次のように返します。

Performing 30 checks on 12 hosts
All checks passed

SELECT SYSTEM$ALLOWLIST() から JSON 許可リスト情報を渡さずに SnowCD を実行しようとすると、現在サポートされているフラグのリスト、該当する場合はそのデータタイプ、およびフラグの簡単な説明とともに、ファイルを含めるリマインダーとして次のエラーメッセージが表示されます。

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

SnowCD が誤った設定または構成を検出した場合、失敗したチェックに関する情報がトラブルシューティングの提案とともに表示されます。例えば、次の応答は無効なホスト名を示しています。

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

HTTP プロキシで SnowCD を使用する¶

HTTP プロキシに対して SnowCD を実行することで、接続状態を確認できます。

Linuxを使用した代表的な例では、プロキシに対して SnowCD を実行する次のコマンドを実行し、必要に応じてフラグ値を置き換えます。

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

ロギングはオプションであり、2つのロギングフラグをプロキシコマンドに追加できます。コマンドの実行時にログが記録されるように、ログファイルへのパスを含めることが重要です。

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

このコマンドを実行すると、 test.log ファイルでトレースを表示できます。