SnowCD(Connectivity Diagnostic Tool)¶

1단계: SYSTEM$ALLOWLIST 또는 SYSTEM$ALLOWLIST_PRIVATELINK 함수 실행¶

전제 조건 단계이며 한 번 수행해야 합니다. 단, 호스트 이름이나 포트가 변경되는 경우는 제외입니다.

1. 웹 인터페이스를 통해 Snowflake에 연결합니다.

2. SELECT SYSTEM$ALLOWLIST(); 또는 SELECT SYSTEM$ALLOWLIST_PRIVATELINK(); 를 실행합니다.

3. 쿼리 결과를 파일(즉, allowlist.json)에 저장합니다.

이러한 함수에 대한 자세한 내용은 SYSTEM$ALLOWLIST 또는 SYSTEM$ALLOWLIST_PRIVATELINK 를 참조하십시오.

아래 예에서는 JSON을 해당 SQL 함수로부터의 출력 형식으로 사용합니다. 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> 는 VPCs 및 Snowflake 계정이 위치한 AWS 리전입니다.

[{"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> 는 VPCs 및 Snowflake 계정이 위치한 AWS 리전입니다.

[{
  "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> 는 VPCs 및 Snowflake 계정이 위치한 AWS 리전입니다.

[{"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> 는 VPCs 및 Snowflake 계정이 위치한 AWS 리전입니다.

[{
  "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 환경에서는 Environment Variables에 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 파일에서 추적을 확인할 수 있습니다.