错误消息¶
客户端连接错误消息可以指示位于主机和 Snowflake 端点之间的网络路径中的各种潜在原因,包括任何可能的代理、安全设备、负载平衡器、DNS 服务器等。您可以找到以下客户端的常见错误消息及其潜在原因和解决方法:
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 检查但云提供商将一个中间证书颁发机构更改为另一个(众所周知的)颁发机构,而该颁发机构尚未出现在信任存储中时,也会出现相同的症状。 解决方案:防火墙或代理 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)
根本原因: 客户端驱动程序试图通过它认为已经启动的连接(管道)发送数据,而那个特定连接在远端已经关闭,只是客户端驱动程序没有意识到这一点。
解决方案: 您可以在 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.cn, *.us-west-2.aws.snowflakecomputing.cn, *.global.snowflakecomputing.cn, *.snowflakecomputing.cn, *.prod1.us-west-2.aws.snowflakecomputing.cn, *.prod2.us-west-2.aws.snowflakecomputing.cn].
根本原因:此客户端驱动程序正试图连接到位于 AWS US WEST(也是默认的云区域)中的 Snowflake 账户(或云存储)。连接不成功,因为客户端驱动程序看到的证书与请求中的主机名不匹配。 最可能的原因包括:
解决方案:
|
---|
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.cn:443: The target server failed to respond
根本原因: 客户端驱动程序没有收到发送到远程端点的请求的及时响应。 最可能的原因包括:
解决方案:
从 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
根本原因:有多种因素可能导致此错误。 解决方法:尝试 常见连接问题和解决方案 并执行:doc: |
---|
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'.
根本原因:请参阅 获取大型查询结果集失败。 解决方案场景:请参阅 获取大型查询结果集失败。 |
---|
Snowflake Connector for Python 和 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 支持部门 以获得进一步帮助。