elasticsearch/docs/reference/sql/apis/clear-sql-cursor-api.asciidoc
James Rodewig f56a0f4b66
[DOCS] Remove testenv annotations from doc snippet tests (#80023)
Removes `testenv` annotations and related code. These annotations originally let you skip x-pack snippet tests in the docs. However, that's no longer possible.

Relates to #79309, #31619
2021-11-05 18:38:50 -04:00

47 lines
972 B
Text

[role="xpack"]
[[clear-sql-cursor-api]]
=== Clear SQL cursor API
++++
<titleabbrev>Clear SQL cursor</titleabbrev>
++++
Clears an <<sql-pagination,SQL search cursor>>.
////
[source,console]
----
POST _sql
{
"query": "SELECT * FROM library ORDER BY page_count DESC",
"fetch_size": 5
}
----
// TEST[setup:library]
////
[source,console]
----
POST _sql/close
{
"cursor": "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWYUpOYklQMHhRUEtld3RsNnFtYU1hQQ==:BAFmBGRhdGUBZgVsaWtlcwFzB21lc3NhZ2UBZgR1c2Vy9f///w8="
}
----
// TEST[continued]
// TEST[s/sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWYUpOYklQMHhRUEtld3RsNnFtYU1hQQ==:BAFmBGRhdGUBZgVsaWtlcwFzB21lc3NhZ2UBZgR1c2Vy9f\/\/\/w8=/$body.cursor/]
[[clear-sql-cursor-api-request]]
==== {api-request-title}
`POST _sql/close`
[[clear-sql-cursor-api-limitations]]
===== Limitations
See <<sql-limitations>>.
[role="child_attributes"]
[[clear-sql-cursor-api-request-body]]
==== {api-request-body-title}
`cursor`::
(Required, string) Cursor to clear.