已弃用的功能¶
本主题介绍了 Snowflake 版本 5.40 中已弃用的 Snowflake SQL API 功能。
有关 SQL API 当前行为的信息,请参阅 Snowflake SQL REST API。
本主题内容:
使用已弃用的 SQL API 功能¶
:doc:` 当前版本 <about-endpoints>` 的 SQL API 默认处于启用状态。要访问已弃用的版本,请使用以下端点:
端点 |
描述 |
---|---|
|
使用此端点提交要执行的 SQL 语句。 |
|
使用此端点检查语句的执行状态。( |
|
使用此端点取消执行语句。 |
备注
这些端点不再受支持,仅用于向后兼容。未来的版本中会禁用这些端点。
已更改和弃用的功能¶
使用已弃用的 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",
...
}
如果发生这种情况,请再次发送请求,并将 pageSize
参数设置为适合页面最大大小的较小值。