Mensagens de erro

As mensagens de erro de conectividade do cliente podem sinalizar várias causas subjacentes localizadas no caminho da rede entre um host e um ponto de extremidade do Snowflake, incluindo possíveis proxies, dispositivos de segurança, balanceadores de carga, servidores DNS e assim por diante. Você pode encontrar mensagens de erro comuns e suas possíveis causas e soluções para os seguintes clientes:

Erros de JDBC

JDBC error 1

Erro(s)

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

Causa raiz: esse erro tem várias causas subjacentes, localizadas no caminho da rede entre o host do qual você está tentando se conectar e o ponto de extremidade do Snowflake, incluindo possíveis proxies, dispositivos de segurança, balanceadores de carga e outros.

Cenário de resolução: Problemas de inspeção de firewall ou proxy SSL.

JDBC error 2

Erro(s)

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'

Causa raiz: o problema provavelmente é causado por um proxy ou dispositivo de segurança realizando uma inspeção SSL.

Em raras ocasiões, geralmente com instalações mais antigas do Java, o mesmo sintoma também pode ocorrer quando não há inspeção SSL, mas o provedor de nuvem alterou uma das autoridades de certificação intermediárias para outra autoridade (bem conhecida), que ainda não está presente no truststore.

Cenário de resolução: Problemas de inspeção de firewall ou proxy SSL.

JDBC error 3

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: Problemas de inspeção de firewall ou proxy SSL.

JDBC error 4

Erro(s)

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

Causa raiz: consulte Problemas de configuração de DNS.

Cenário de resolução: Problemas de configuração de DNS.

JDBC error 5

Erro(s)

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>"}

Causa raiz: consulte Problemas de OCSP e porta 80.

Cenário de resolução: Problemas de OCSP e porta 80.

JDBC error 6

Erro(s)

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:

Causa raiz: consulte Falhas na busca de grandes conjuntos de resultados de consulta.

Cenário de resolução: Falhas na busca de grandes conjuntos de resultados de consulta.

JDBC error 7

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: Problemas de inspeção de firewall ou proxy SSL.

JDBC error 8

Erro(s)

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)

Causa raiz:

O driver do cliente tentou enviar dados por meio de uma conexão (canal) que ele acredita estar ativa, cuja conexão específica já está fechada na extremidade remota, mas o driver do cliente não estava ciente disso.

  • Um cenário (mais) simples para esse erro é quando há um tempo limite ocioso configurado em um proxy ou dispositivo de segurança entre o driver do cliente e o Snowflake, que, quando expira, encerra a conexão sem notificar as partes

  • Muitas vezes, a solução de problemas da verdadeira causa raiz subjacente do que exatamente e por que está destruindo as conexões entre o driver do cliente e o Snowflake pode ser uma tarefa complexa, cujos detalhes estão fora do escopo desta documentação

Cenário de resolução:

Você pode configurar um TTL dentro do driver JDBC que fechará as conexões do lado do cliente antes que elas sejam interrompidas por um tempo limite de inatividade remoto, evitando o problema. A configuração está disponível a partir da versão 3.12.17 do driver JDBC; e a partir da versão 3.13.30 há um padrão (1 minuto) já configurado.

Para obter mais informações, consulte I/O Error: Connection Reset.

JDBC error 9

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: Problemas de inspeção de firewall ou proxy SSL.

JDBC error 10

Erro(s)

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

Causa raiz: o driver do cliente tem problemas para acessar o armazenamento em nuvem associado à sua conta Snowflake durante uma operação de upload. Isso é causado por uma configuração incorreta em um proxy /dispositivo de segurança localizado no caminho de rede entre o driver do cliente e o armazenamento em nuvem.

Cenário de resolução: embora a direção do tráfego seja oposta, consulte Falhas na busca de grandes conjuntos de resultados de consulta.

JDBC error 11

Erro(s)

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].

Causa raiz: o que esta mensagem de erro significa: o driver do cliente está tentando se conectar a uma conta Snowflake (ou armazenamento em nuvem) localizada em AWS US WEST, que também é a região de nuvem padrão. A conexão não foi bem-sucedida porque o certificado visto pelo driver do cliente não corresponde ao nome do host na solicitação.

As causas mais prováveis incluem:

  • Se sua conta Snowflake não estiver em AWS US WEST: o problema mais comum é uma configuração incorreta na parte da conta na cadeia de caracteres de conexão do driver JDBC.

  • Se sua conta Snowflake estiver realmente em AWS US WEST: a causa provável pode ser um proxy /dispositivo de segurança realizando a inspeção SSL.

Cenário de resolução:

  • Para a primeira causa, use a notação sem região no campo de conta da configuração, como myorg-test, myorg-prod etc. Alternativamente, se você quiser usar a notação do localizador, certifique-se de usar a correta, conforme indicado na documentação Identificadores de conta. Por exemplo, uma conta em AWS EU Frankfurt seria xy12345.eu-central-1.

  • Para a segunda causa, veja Falhas na busca de grandes conjuntos de resultados de consulta.

JDBC error 12

Erro(s)

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

Causa raiz:

O driver do cliente não recebeu uma resposta oportuna à solicitação enviada ao ponto de extremidade remoto.

As causas mais prováveis incluem:

  • Se o problema persistir, provavelmente é um problema real de conectividade.

  • Se o problema for intermitente e, especificamente, se NoHttpResponseException acontecer muito rapidamente (milissegundos) após o envio da solicitação, esse erro indica que a sessão TCP entre o driver cliente e o servidor está inativa, mas o driver não sabia disso. Isso geralmente acontece quando um proxy/balanceador de carga intermediário interrompe a sessão entre o cliente e o servidor, sem informar a nenhuma das partes.

Cenário de resolução:

  • Para erros persistentes e quando NoHttpResponseException acontece após uma espera maior após a solicitação, siga Etapas de solução de problemas.

  • Para ocasiões em que essa exceção é intermitente e é lançada muito rapidamente depois que o driver do cliente envia a solicitação, entre as versões 3.12.17 e 3.13.30, você tem uma opção de configuração net.snowflake.jdbc.ttl para garantir que as conexões ociosas sejam fechadas e, assim, evitar que o nó intermediário (como loadbalancer) o desligue inesperadamente, sem informar os clientes nas outras extremidades. Para obter mais informações, consulte I/O Error: Connection Reset.

A partir da versão 3.13.30 do driver JDBC em diante, você ainda tem essa opção de configuração, mas normalmente não é necessário alterá-la, pois agora ela tem um valor padrão de tempo limite de inatividade de 1 minuto (60 segundos).

Em ambos os cenários, o driver JDBC deve tentar enviar novamente a solicitação com falha automaticamente, de acordo com sua estratégia de nova tentativa, sem precisar de nenhuma intervenção do usuário.

Erros de ODBC

ODBC error 1

Erro(s)

'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'. . '.*

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

ODBC error 2

Erro(s)

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'.

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

ODBC error 3

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

ODBC error 4

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

ODBC error 5

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

ODBC error 6

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

ODBC error 7

Erro(s)

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'.

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

ODBC error 8

Erro(s)

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)'.

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

ODBC error 9

Erro(s)

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

Causa raiz: existem vários fatores que podem levar a esse erro.

Cenário de resolução: tente Problemas comuns de conectividade e soluções e execute Etapas de solução de problemas.

ODBC error 10

Erro(s)

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

Causa raiz:

O driver do cliente não conseguiu executar a operação de login para o usuário fornecido, devido ao tempo limite da solicitação. (código de erro curl 28 = CURLE_OPERATION_TIMEDOUT).

Isso provavelmente ocorre devido a uma configuração incorreta em um ou mais dispositivos (proxy /dispositivo de segurança) no caminho de rede entre o driver do cliente e o Snowflake.

Cenário de resolução:

Siga Etapas de solução de problemas e trabalhe com seu administrador de sistema/rede para garantir que todos os pontos de extremidade do Snowflake possam ser acessados a partir do host em que você está executando o driver do cliente.

ODBC error 11

Erro(s)

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'.

Causa raiz: consulte Problemas de configuração de DNS.

Cenário de resolução: consulte Problemas de configuração de DNS.

ODBC error 12

Erro(s)

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'.

Causa raiz: consulte Problemas de configuração de DNS.

Cenário de resolução: consulte Problemas de configuração de DNS.

ODBC error 13

Erro(s)

[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'.

Causa raiz: consulte Falhas na busca de grandes conjuntos de resultados de consulta.

Cenário de resolução: consulte Falhas na busca de grandes conjuntos de resultados de consulta.

Erros do Snowflake Connector para Python e SnowSQL

Python error 1

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

Python error 2

Erro(s)

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')])")))

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

Python error 3

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

Python error 4

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

Python error 5

Erro(s)

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

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

Python error 6

Erro(s)

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>

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

Python error 7

Erro(s)

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

Causa raiz:

O que essa mensagem de erro significa: o driver do cliente conseguiu se conectar à extremidade remota e enviou uma solicitação HTTP a ela, mas ao tentar ler a resposta, nenhum dado foi lido, indicando que algo na extremidade remota fechou a conexão.

A causa mais provável é um erro de RemoteDisconnected persistente, que sugere configuração incorreta em um ou mais dispositivos de proxy/segurança entre o driver do cliente e o ponto de extremidade do Snowflake.

Cenário de resolução: siga Etapas de solução de problemas e certifique-se de que todos os pontos de extremidade do Snowflake sejam permitidos em qualquer proxy intermediário ou dispositivo de segurança que você possa ter.

Python error 8

Erro(s)

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')")))

Causa raiz: consulte Problemas de inspeção de firewall ou proxy SSL.

Cenário de resolução: consulte Problemas de inspeção de firewall ou proxy SSL.

Se as etapas de resolução não resolverem o problema, entre em contato com o suporte Snowflake para obter mais assistência.