오류 메시지

클라이언트 연결 오류 메시지는 가능한 프록시, 보안 어플라이언스, 로드 밸런서, DNS 서버 등 호스트와 Snowflake 엔드포인트 사이의 네트워크 경로에 있는 다양한 근본 원인을 로케이터에 알릴 수 있습니다. 다음 클라이언트에 대한 일반적인 오류 메시지와 잠재적 원인 및 해결 방법을 확인할 수 있습니다.

JDBC 오류

JDBC 오류 1

오류

Cannot connect: connection refused: Java::NetSnowflakeClientJdbc::SnowflakeSQLException: JDBC driver encountered communication error. Message: Exception encountered for HTTP request: Connection reset.

근본 원인: 이 오류에는 연결할 호스트와 Snowflake 엔드포인트 사이의 네트워크 경로, 즉 가능한 프록시, 보안 어플라이언스, 로드 밸런서 등으로 인한 다양한 근본 원인이 있습니다.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제.

JDBC 오류 2

오류

JDBC driver encountered communication error. Message: Exception encountered for HTTP request:

sun.security.validator.ValidatorException: No trusted certificate found.

OR

javax.net.ssl.SSLHandshakeException: No trusted certificate found

OR

'SSL peer certificate or SSH remote key was not OK'

근본 원인: 이 문제는 프록시 또는 보안 어플라이언스가 SSL 검사를 수행하기 때문에 발생한 것일 수 있습니다.

드물게, 일반적으로 이전 버전 Java 설치 관리자의 경우, SSL 검사는 수행되지 않지만, 클라우드 공급자가 중개 인증 기관 중 하나를 아직 truststore에 없는 다른 (잘 알려진) 기관으로 변경한 경우에도 동일한 증상이 발생할 수 있습니다.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제.

JDBC 오류 3

오류

JDBC driver encountered a communication error. Message: Exception encountered for an HTTP request: Network is unreachable (Connect Failed)

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제.

JDBC 오류 4

오류

JDBC driver encountered communication error. Message: Exception encountered for HTTP request: <SERVICE_ENDPOINT>: nodename nor servname provided, or not known.

근본 원인: DNS 구성 문제 섹션을 참조하십시오.

해결 시나리오: DNS 구성 문제.

JDBC 오류 5

오류

WARNING!!! Using fail-open to connect. Driver is connecting to an HTTPS endpoint without OCSP based Certificate Revocation checking as it could not obtain a valid OCSP Response to use from the CA OCSP responder. Details: {"cacheEnabled":true,"ocspReqBase64":null,"ocspMode":"FAIL_OPEN","sfcPeerHost":"<SERVICE_ENDPOINT>","ocspResponderURL":null,"cacheHit":true,"eventType":"OCSPValidationError","certId":"<OBFUSCATED>"}

근본 원인: OCSP 및 포트 80 문제 섹션을 참조하십시오.

해결 시나리오: OCSP 및 포트 80 문제.

JDBC 오류 6

오류

JDBC driver internal error: Max retry reached for the download of #chunk0 (Total chunks:<x>) retry=<y>, error=net.snowflake.client.jdbc.SnowflakeSQLException: JDBC driver encountered communication error. Message: Error encountered when downloading a result chunk:

근본 원인: 대규모 쿼리 결과 세트 가져오기 실패 섹션을 참조하십시오.

해결 시나리오: 대규모 쿼리 결과 세트 가져오기 실패.

JDBC 오류 7

오류

JDBC driver encountered communication error. Message: Exception encountered for HTTP request: Failed to find the root CA

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제.

JDBC 오류 8

오류

net.snowflake.client.jdbc.internal.apache.http.impl.execchain.RetryExec execute INFO: I/O exception (java.net.SocketException) caught when processing request to {s}->https://[<SNOWFLAKE_DEPLOYMENT>|<SNOWFLAKE_DEPLOYMENT_REGIONLESS>|<CLIENT_FAILOVER>]:443: Broken pipe (Write failed)

근본 원인:

클라이언트 드라이버가 가동 중이라고 생각되는 연결(파이프)을 통해 데이터를 전송하려고 했지만, 원격 쪽에서 이미 특정 연결이 닫혀 있어 클라이언트 드라이버가 이를 인식하지 못했을 뿐입니다.

  • 이 오류의 간단하거나 더 간단한 시나리오는 클라이언트 드라이버와 Snowflake 사이에 프록시 또는 보안 어플라이언스에 구성된 유휴 시간 초과가 발생한 경우이며, 이 시간 초과가 만료되면 당사자에게 알리지 않고 연결이 종료됩니다.

  • 클라이언트 드라이버와 Snowflake 간의 연결을 끊는 정확한 근본 원인을 파악하는 것은 이 문서에서 자세히 설명할 수 없는 복잡한 작업인 경우가 많습니다.

해결 시나리오:

JDBC 드라이버 내부에 TTL을 구성하면 클라이언트 측에서 원격 유휴 시간 제한으로 인해 연결이 끊어지는 것보다 더 빨리 연결을 정상적으로 종료하여 문제를 방지할 수 있습니다. 설정은 JDBC 드라이버 버전 3.12.17부터 가능하며, 3.13.30부터는 기본값(1분)이 이미 설정되어 있습니다.

자세한 내용은 I/O 오류: 연결 재설정 섹션을 참조하십시오.

JDBC 오류 9

오류

JDBC driver encountered communication error. Message: Exception encountered for HTTP request: Remote host terminated the handshake

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제.

JDBC 오류 10

오류

net.snowflake.client.jdbc.SnowflakeSQLLoggedException: JDBC driver encountered IO error. Message: Encountered exception during upload: null.

근본 원인: 업로드 작업 중에 클라이언트 드라이버가 Snowflake 계정과 연결된 클라우드 저장소에 액세스하는 데 문제가 있습니다. 이 문제는 클라이언트 드라이버와 클라우드 저장소 사이의 네트워크 경로에 있는 프록시/보안 어플라이언스의 구성 오류로 인해 발생합니다.

해결 시나리오: 트래픽의 방향이 반대인 경우 대규모 쿼리 결과 세트 가져오기 실패 를 참조하십시오.

JDBC 오류 11

오류

JDBC driver encountered communication error. Message: Exception encountered for HTTP request: Certificate for [<SNOWFLAKE_DEPLOYMENT>|<SNOWFLAKE_DEPLOYMENT_REGIONLESS>|<CLIENT_FAILOVER>] doesn't match any of the subject alternative names: [*.us-west-2.snowflakecomputing.com, *.us-west-2.aws.snowflakecomputing.com, *.global.snowflakecomputing.com, *.snowflakecomputing.com, *.prod1.us-west-2.aws.snowflakecomputing.com, *.prod2.us-west-2.aws.snowflakecomputing.com].

근본 원인: 이 오류 메시지의 의미 클라이언트 드라이버가 기본 클라우드 리전인 AWS US WEST에 있는 Snowflake 계정(또는 클라우드 저장소)에 연결을 시도하고 있습니다. 클라이언트 드라이버에서 본 인증서가 요청의 호스트 이름과 일치하지 않기 때문에 연결이 실패합니다.

가장 가능성이 높은 원인은 다음과 같습니다.

  • Snowflake 계정이 AWS US WEST에 위치하지 않은 경우: 가장 일반적인 문제는 JDBC 드라이버 연결 문자열의 계정 부분이 잘못 구성된 경우입니다.

  • Snowflake 계정이 실제로 AWS US WEST에 위치한 경우: 프록시/보안 어플라이언스가 SSL 검사를 수행하는 것이 원인일 가능성이 높습니다.

해결 시나리오:

  • 첫 번째 원인의 경우, 구성의 계정 필드에서 myorg-test, myorg-prod 등과 같이 리전이 없는 표기법을 사용합니다. 또는 로케이터 표기법을 사용하려면 계정 식별자 설명서에 표시된 대로 올바른 표기법을 사용해야 합니다. 예를 들어, AWS EU 프랑크푸르트에 위치한 계정은 xy12345.eu-central-1 입니다.

  • 두 번째 원인은 대규모 쿼리 결과 세트 가져오기 실패 섹션을 참조하십시오.

JDBC 오류 12

오류

I/O exception (net.snowflake.client.jdbc.internal.apache.http.NoHttpResponseException) caught when processing request to {s}->https://[<SNOWFLAKE_DEPLOYMENT>|<SNOWFLAKE_DEPLOYMENT_REGIONLESS>|<CLIENT_FAILOVER>].snowflakecomputing.com:443: The target server failed to respond

근본 원인:

클라이언트 드라이버가 원격 엔드포인트로 전송된 요청에 대한 적절한 응답을 수신하지 못했습니다.

가장 가능성이 높은 원인은 다음과 같습니다.

  • 문제가 지속적으로 발생하는 경우 실제 연결 문제일 가능성이 높습니다.

  • 문제가 간헐적이고 구체적으로, 요청이 전송된 후 매우 빠르게(밀리초) NoHttpResponseException이 발생하는 경우 이 오류는 클라이언트 드라이버와 서버 간의 TCP 세션이 다운되었지만 드라이버가 이를 인지하지 못했음을 나타냅니다. 후자는 중개 프록시/로드 밸런서가 어느 당사자에게도 알리지 않고 클라이언트와 서버 간의 세션을 종료할 때 발생하는 경우가 많습니다.

해결 시나리오:

  • 지속적인 오류가 발생하거나 요청 후 더 오래 기다린 후에 문제 해결 단계 가 발생하는 경우, NoHttpResponseException 를 따르십시오.

  • 이 예외가 간헐적이고 클라이언트 드라이버가 요청을 보낸 후 매우 빠르게 발생하는 경우, 버전 3.12.17과 3.13.30 사이에는 유휴 연결이 닫히도록 하여 중개 노드(예: loadbalancer)가 다른 쪽 끝에 있는 클라이언트에게 알리지 않고 갑자기 연결을 끊는 것을 방지하는 구성 옵션 net.snowflake.jdbc.ttl을 사용할 수 있습니다. 자세한 내용은 I/O 오류: 연결 재설정 섹션을 참조하십시오.

JDBC 드라이버 버전 3.13.30 이상부터, 이 구성 옵션은 계속해서 제공되지만 기본값이 1분 유휴 시간 제한(60초)이므로 일반적으로는 변경할 필요가 없습니다.

두 시나리오 모두에서 JDBC 드라이버는 사용자의 개입 없이도 재시도 전략에 따라 실패한 요청을 자동으로 다시 전송해야 합니다.

ODBC 오류

ODBC 오류 1

오류

'OLE DB or ODBC error: [DataSource.Error] ERROR [HY000] [Snowflake][Snowflake] (25) Result download worker error: Worker error: [Snowflake][Snowflake] (4) REST request for URL <>.... :  CURLerror (curl_easy_perform() failed) - code=60 msg='SSL peer certificate or SSH remote key was not OK' osCode=9 osMsg='Bad file descriptor'. . '.*

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

ODBC 오류 2

오류

Error: nanodbc/nanodbc.cpp:1135: 01S00: [Snowflake][Snowflake] (4) REST request for URL *** failed: CURLerror (curl_easy_perform() failed) - code=60 msg='SSL peer certificate or SSH remote key was not OK'.

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

ODBC 오류 3

오류

'SSL peer certificate or SSH remote key was not OK'

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

ODBC 오류 4

오류

SSL certificate problem: self signed certificate in certificate chain. Please check for SSL interception proxy in your network.

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

ODBC 오류 5

오류

CURLerror (curl _easy_perform failed) - code=35 msg='SSL connect error' osCode=10054 osMsg='Unknown error'.

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

ODBC 오류 6

오류

'Empty reply from server' (CURLerror (curl_easy_perform() failed) - code=52 msg='Server returned nothing (no header..)

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

ODBC 오류 7

오류

ERROR 5052 Simba::ODBC::Connection::SQLDriverConnectW: [Snowflake][Snowflake] (4) REST request for URL https://[<SNOWFLAKE_DEPLOYMENT>|<SNOWFLAKE_DEPLOYMENT_REGIONLESS>|<CLIENT_FAILOVER>]:443/session/v1/login-request?requestId=<OBFUSCATED>&request_guid=<OBFUSCATED>&databaseName=<OBFUSCATED>&schemaName=<OBFUSCATED>&warehouse=<OBFUSCATED>failed: CURLerror (curl_easy_perform() failed) - code=35 msg='SSL connect error'.

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

ODBC 오류 8

오류

ERROR 710 Simba::ODBC::Statement::SQLFetchScroll: [Snowflake][Snowflake] (25) Result download worker error: Worker error: [Snowflake][Snowflake] (4) REST request for URL https://<STAGE>/<OBFUSCATED>/results/<OBFUSCATED>_0/main/data_0_0_1?x-amz-server-side-encryption-customer-algorithm=<OBFUSCATED>&response-content-encoding=gzip&AWSAccessKeyId=<OBFUSCATED>&Expires=<OBFUSCATED>&Signature=<OBFUSCATED> failed: CURLerror (curl_easy_perform() failed) - code=52 msg='Server returned nothing (no headers, no data)'.

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

ODBC 오류 9

오류

[Snowflake][Snowflake] (6) Assertion failure: error_in_response_json

근본 원인: 이 오류가 발생할 수 있는 요인은 여러 가지가 있습니다.

해결 시나리오: 일반적인 연결 문제 및 해결 방법 를 시도하고 문제 해결 단계 를 실행합니다.

ODBC 오류 10

오류

WARN 9594 sf::RestRequest::httpPerform: Got CURL(0000015547C0CC10) error: Failed to connect to <PROXY_HOST> port 80: Timed out when fetching data from https://[<SNOWFLAKE_DEPLOYMENT>|<SNOWFLAKE_DEPLOYMENT_REGIONLESS>|<CLIENT_FAILOVER>]:443/session/v1/login-request?requestId=<OBFUSCATED>&request_guid=<OBFUSCATED>. Status code: 11, curl error code: 28

근본 원인:

요청 시간 초과로 인해 클라이언트 드라이버가 지정된 사용자에 대한 로그인 작업을 수행할 수 없습니다. (curl 오류 코드 28 = CURLE_OPERATION_TIMEDOUT).

이는 클라이언트 드라이버와 Snowflake 간 네트워크 경로에 있는 하나 이상의 디바이스(프록시/보안 어플라이언스)의 구성 오류로 인해 발생할 가능성이 높습니다.

해결 시나리오:

문제 해결 단계 를 따르고 시스템 관리자/네트워크 관리자와 협력하여 클라이언트 드라이버를 실행하는 호스트에서 모든 Snowflake 엔드포인트에 연결할 수 있는지 확인합니다.

ODBC 오류 11

오류

ERROR [HY000] [Microsoft][Snowflake] (4) REST request for URL https://[<SNOWFLAKE_DEPLOYMENT>|<SNOWFLAKE_DEPLOYMENT_REGIONLESS>|<CLIENT_FAILOVER>]:443/session/v1/login-request?requestId=<OBFUSCATED>&request_guid=<OBFUSCATED> failed: CURLerror (curl_easy_perform() failed) - code=6 msg='Couldn't resolve host name'.

근본 원인: DNS 구성 문제 섹션을 참조하십시오.

해결 시나리오: DNS 구성 문제 섹션을 참조하십시오.

ODBC 오류 12

오류

ERROR [HY000] [Snowflake][Snowflake] (4) REST request for URL https://[<SNOWFLAKE_DEPLOYMENT>|<SNOWFLAKE_DEPLOYMENT_REGIONLESS>|<CLIENT_FAILOVER>]:443/session/v1/login-request?requestId=<OBFUSCATED>&request_guid=<OBFUSCATED> failed: CURLerror (curl_easy_perform() failed) - code=5 msg='Couldn't resolve proxy name' osCode=9 osMsg='Bad file descriptor'.

근본 원인: DNS 구성 문제 섹션을 참조하십시오.

해결 시나리오: DNS 구성 문제 섹션을 참조하십시오.

ODBC 오류 13

오류

[Snowflake][Snowflake] (25) Result download worker error: Worker error: [Snowflake][Snowflake] (4) REST request for URL https://<STAGE>/results/<OBFUSCATED>_02Fmain2Fdata_0_0_8?sv=<OBFUSCATED>&spr=https&se=<OBFUSCATED>&sr=b&sp=r&sig=<OBFUSCATED>&rsce=gzip failed: CURLerror (curl_easy_perform() failed) - code=42 msg='Operation was aborted by an application callback'.

근본 원인: 대규모 쿼리 결과 세트 가져오기 실패 섹션을 참조하십시오.

해결 시나리오: 대규모 쿼리 결과 세트 가져오기 실패 섹션을 참조하십시오.

Python용 Snowflake Connector 및 SnowSQL 오류

Python 오류 1

오류

SSL validation failed for https://<STAGE>/?accelerate [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:852)

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

Python 오류 2

오류

SSLError: HTTPSConnectionPool(host='<STAGE>', port=443): Max retries exceeded with url: /<OBFUSCATED>/results/<OBFUSCATED>_0/main/data_0_0_1?x-amz-server-side-encryption-customer-algorithm=<OBFUSCATED>&response-content-encoding=gzip&AWSAccessKeyId=<OBFUSCATED>&Expires=<OBFUSCATED>&Signature=<OBFUSCATED> (Caused by SSLError(SSLError("bad handshake: Error([('SSL routines', 'tls_process_server_certificate', 'certificate verify failed')])")))

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

Python 오류 3

오류

(Caused by ProxyError('Cannot connect to proxy.', OSError('Tunnel connection failed: 407 Request rejected by proxy')))

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

Python 오류 4

오류

250001 (n/a): Could not connect to Snowflake backend after 0 attempt(s).Aborting

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

Python 오류 5

오류

snowflake.connector.network.RetryRequest: HTTP 403: Forbidden

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

Python 오류 6

오류

250003 (n/a): Failed to get the response. Hanging? method: post, url: https://[<SNOWFLAKE_DEPLOYMENT>|<SNOWFLAKE_DEPLOYMENT_REGIONLESS>|<CLIENT_FAILOVER>]:443/session/authenticator-request?request_guid=<OBFUSCATED>

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

Python 오류 7

오류

Retrying (Retry(total=0, connect=None, read=None, redirect=None)) after connection broken by 'ProtocolError('Connection aborted.', RemoteDisconnected ('Remote end closed connection without response'))'

근본 원인:

이 오류 메시지의 의미: 클라이언트 드라이버가 원격 끝에 연결할 수 있었고 HTTP 요청을 보냈지만 응답을 읽으려고 할 때 데이터를 읽지 못하여 원격 끝에 있는 어떤 항목이 연결을 닫았음을 나타냅니다.

가장 가능성이 높은 원인은 지속적인 RemoteDisconnected 오류로, 클라이언트 드라이버와 Snowflake 엔드포인트 사이의 하나 이상의 프록시/보안 어플라이언스에서 구성이 잘못되었음을 나타냅니다.

해결 시나리오: 문제 해결 단계 를 따르고 중개 프록시 또는 보안 어플라이언스에서 모든 Snowflake 엔드포인트가 허용되는지 확인합니다.

Python 오류 8

오류

HTTPSConnectionPool(host='<STAGE>', port=443): Max retries exceeded with url: /<OBFUSCATED>/results/<OBFUSCATED>_0/main/data_0_0_1?x-amz-server-side-encryption-customer-algorithm=<OBFUSCATED>&response-content-encoding=gzip&X-Amz-Algorithm=<OBFUSCATED>&X-Amz-Date=<OBFUSCATED>&X-Amz-SignedHeaders=<OBFUSCATED>&X-Amz-Expires=<OBFUSCATED>&X-Amz-Credential=<OBFUSCATED>&X-Amz-Signature=<OBFUSCATED> (Caused by SSLError(SSLError("bad handshake: SysCallError(-1, 'Unexpected EOF')")))

근본 원인: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 시나리오: 방화벽 또는 프록시 SSL 검사 문제 섹션을 참조하십시오.

해결 단계로 문제가 해결되지 않으면 Snowflake 지원 에 문의하여 추가 지원을 요청하십시오.