大きなレスポンスのページネーション（Paginating through a large response）

大きなレスポンスのページネーション

前のセクションの例を使用して、カーソルフィールドを返すことで次のページに進むことができます。CSV、TSV、TXT形式の場合、カーソルはCursor HTTPヘッダーに返されます。

Python

resp = client.sql.query(
   format="json",
   cursor="sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWYUpOYklQMHhRUEtld3RsNnFtYU1hQQ==:BAFmBGRhdGUBZgVsaWtlcwFzB21lc3NhZ2UBZgR1c2Vy9f///w8=",
)
print(resp)

Js

const response = await client.sql.query({
  format: "json",
  cursor:
   "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWYUpOYklQMHhRUEtld3RsNnFtYU1hQQ==:BAFmBGRhdGUBZgVsaWtlcwFzB21lc3NhZ2UBZgR1c2Vy9f///w8=",
});
console.log(response);

コンソール

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="
}

結果に`````cursor`````が返されない場合、最後のページに到達したことになります。Elasticsearchの[スクロール](238327401f76c2ac.md#scroll-search-results)のように、SQLはカーソルをサポートするためにElasticsearchに状態を保持することがあります。スクロールとは異なり、最後のページを受け取ることは、Elasticsearchの状態がクリアされることを保証するのに十分です。  
状態を早くクリアするには、[カーソルクリアAPI](/read/elasticsearch-8-15/a81d6232d594dbba.md)を使用してください:
#### Python
``````python
resp = client.sql.clear_cursor(
   cursor="sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWYUpOYklQMHhRUEtld3RsNnFtYU1hQQ==:BAFmBGRhdGUBZgVsaWtlcwFzB21lc3NhZ2UBZgR1c2Vy9f///w8=",
)
print(resp)
`

Js

const response = await client.sql.clearCursor({
  cursor:
   "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWYUpOYklQMHhRUEtld3RsNnFtYU1hQQ==:BAFmBGRhdGUBZgVsaWtlcwFzB21lc3NhZ2UBZgR1c2Vy9f///w8=",
});
console.log(response);

コンソール

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

次のように返されます:

コンソール-結果

{
  "succeeded" : true
}