已弃用的功能

本主题介绍了 Snowflake 版本 5.40 中已弃用的 Snowflake SQL API 功能。

有关 SQL API 当前行为的信息,请参阅 Snowflake SQL REST API

本主题内容:

使用已弃用的 SQL API 功能

:doc:` 当前版本 <about-endpoints>` 的 SQL API 默认处于启用状态。要访问已弃用的版本,请使用以下端点:

端点

描述

/api/statements/

使用此端点提交要执行的 SQL 语句。

/api/statements/statementHandle

使用此端点检查语句的执行状态。(statementHandle 是提交执行的语句的唯一标识符。)

/api/statements/statementHandle/cancel

使用此端点取消执行语句。

备注

这些端点不再受支持,仅用于向后兼容。未来的版本中会禁用这些端点。

已更改和弃用的功能

使用已弃用的 SQL API 功能时,如果设置了 pageSize 请求参数以对结果进行分页,Snowflake 将在响应中返回结果的第一页。您可以使用 ResultSet 对象中 ResultSet_resultSetMetaData 对象的 numPages 字段来确定结果的总页数。

要获取下一页结果或其他页的结果,请使用 HTTP 响应中 Link 标头处提供的 URLs。Link 标头指定了用于检索第一页、下一页、上一页和最后一页结果的 URLs。

以下功能已更改或弃用:

  • 您可以在 GET 和 POST 请求中指定 nullable 参数。

  • 使用 pageSize 参数可以指定查询返回的行数。页面大小的范围为:每页支持的最小行数 (10) 到支持的最大行数 (10000)。默认情况下,返回的行数因语句的执行情况而异。

  • 您可以使用 page 来确定要返回哪一页结果。该数字的范围为:0 到总页数减去 1。

  • 默认情况下,行号作为数据集的一部分返回。

确定结果集页面大小是否超过限制

SQL API 中已弃用的功能最大可以返回约为 10 MB 的结果集页面。

如果结果集页面超过此大小,则端点将返回 HTTP 200 的响应,其正文中的结果集被截断,且 code 字段设置为 391908

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

如果发生这种情况,请再次发送请求,并将 pageSize 参数设置为适合页面最大大小的较小值。

语言: 中文