正在加载

分页处理大型响应

Elastic Stack Serverless

使用上一节的示例，可以通过发送 cursor 字段继续到下一页。对于 CSV、TSV 和 TXT 格式，cursor 在 Cursor HTTP 标头中返回。

 POST /_sql?format=json {
  "cursor": "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWYUpOYklQMHhRUEtld3RsNnFtYU1hQQ==:BAFmBGRhdGUBZgVsaWtlcwFzB21lc3NhZ2UBZgR1c2Vy9f///w8="
}

看起来像

{
  "rows" : [
    ["Dan Simmons",        "Hyperion",             482,  "1989-05-26T00:00:00.000Z"],
    ["Iain M. Banks",      "Consider Phlebas",     471,  "1987-04-23T00:00:00.000Z"],
    ["Neal Stephenson",    "Snow Crash",           470,  "1992-06-01T00:00:00.000Z"],
    ["Frank Herbert",      "God Emperor of Dune",  454,  "1981-05-28T00:00:00.000Z"],
    ["Frank Herbert",      "Children of Dune",     408,  "1976-04-21T00:00:00.000Z"]
  ],
  "cursor" : "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWODRMaXBUaVlRN21iTlRyWHZWYUdrdw==:BAFmBmF1dGhvcgFmBG5hbWUBZgpwYWdlX2NvdW50AWYMcmVsZWFzZV9kYXRl9f///w8="
}

请注意，columns 对象仅是第一页的一部分。

当结果中没有返回 cursor 时，您就到达了最后一页。与 Elasticsearch 的 scroll 类似，SQL 可能会在 Elasticsearch 中保留状态以支持 cursor。与 scroll 不同，接收到最后一页就足以保证 Elasticsearch 状态被清除。

要更早地清除状态，请使用 clear cursor API

 POST /_sql/close {
  "cursor": "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWYUpOYklQMHhRUEtld3RsNnFtYU1hQQ==:BAFmBGRhdGUBZgVsaWtlcwFzB21lc3NhZ2UBZgR1c2Vy9f///w8="
}

这将会返回

{
  "succeeded" : true
}
© . All rights reserved.