Funcionalidade obsoleta

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

Consulte o REST API SQL Snowflake para informações sobre o comportamento atual da API de SQL.

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",
  ...
}
Copy

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.

Linguagem: Português