Funcionalidade obsoleta

Este tópico descreve a funcionalidade da API de SQL do Snowflake que foi preterida na versão Snowflake 5.40.

See the API de SQL do Snowflake for information on the current behavior of the SQL API.

Neste tópico:

Como usar a funcionalidade preterida da API do SQL

A versão atual da API do SQL está habilitada por padrão. Para acessar a versão preterida, use os seguintes pontos de extremidade:

Ponto de extremidade

Descrição

/api/statements/

Use esse ponto de extremidade para enviar instruções SQL para execução.

/api/statements/statementHandle

Use esse ponto de extremidade para verificar o status da execução de uma instrução . (statementHandle é um identificador único para a instrução enviada para execução).

/api/statements/statementHandle/cancel

Use esse ponto de extremidade para cancelar a execução de uma instrução.

Nota

Esses pontos de extremidade não são mais suportados e são fornecidos apenas para compatibilidade com versões anteriores. Eles serão desativados em um lançamento futuro.

Funcionalidade alterada e obsoleta

Ao usar a funcionalidade preterida da API do SQL, se você definir o parâmetro de solicitação pageSize para paginar os resultados, o Snowflake retornará a primeira página de resultados na resposta. Você pode usar o campo numPages no objeto ResultSet_resultSetMetaData no objeto ResultSet para determinar o número total de páginas de resultados.

Para obter a próxima página de resultados ou outras páginas de resultados, use as URLs fornecidas no cabeçalho Link na resposta HTTP. O cabeçalho Link especifica as URLs para obter a primeira página, a página anterior, a próxima página e a última página dos resultados

A funcionalidade a seguir foi alterada ou preterida:

  • Você pode especificar o parâmetro nullable tanto em solicitações GET quanto POST.

  • Use o parâmetro pageSize para especificar o número de linhas retornadas por uma consulta. O tamanho da página pode variar do número mínimo suportado (10) até o número máximo suportado (10.000) de linhas por página. Por padrão, o número de linhas devolvidas varia dependendo da execução da instrução.

  • Você usa o page para identificar qual página de resultados retornar. O número pode variar de 0 até o número total de páginas menos 1.

  • Os números das linhas são retornados por padrão como parte do conjunto de dados.

Como determinar se o tamanho de página do conjunto de resultados excede o limite

A funcionalidade preterida na API do SQL pode retornar uma página de conjunto de resultados com um tamanho máximo de aproximadamente 10 MB.

Se a página do conjunto de resultados exceder esse tamanho, o ponto de extremidade retornará uma resposta HTTP 200 com um resultado truncado definido no corpo e o campo code definido como 391908:

HTTP/1.1 200 OK
...
{
  "code": "391908",
  ...
}

Se isso ocorrer, envie a solicitação novamente com o parâmetro pageSize definido como um valor menor que esteja dentro do tamanho máximo de uma página.