カラム形式の結果（Columnar results）

カラム形式の結果

SQLクエリの結果を表示する最も一般的な方法は、各個別のレコード/ドキュメントが1行/行を表す形式です。特定のフォーマットでは、Elasticsearch SQLは結果をカラム形式で返すことができます：1行は現在の結果ページから特定のカラムのすべての値を表します。

次のフォーマットはカラム指向で返すことができます：json、yaml、cbor、およびsmile。

Python

resp = client.sql.query(
   format="json",
   query="SELECT * FROM library ORDER BY page_count DESC",
   fetch_size=5,
   columnar=True,
)
print(resp)

Ruby

response = client.sql.query(
  format: 'json',
  body: {
   query: 'SELECT * FROM library ORDER BY page_count DESC',
   fetch_size: 5,
   columnar: true
  }
)
puts response

Js

const response = await client.sql.query({
  format: "json",
  query: "SELECT * FROM library ORDER BY page_count DESC",
  fetch_size: 5,
  columnar: true,
});
console.log(response);

コンソール

POST /_sql?format=json
{
  "query": "SELECT * FROM library ORDER BY page_count DESC",
  "fetch_size": 5,
  "columnar": true
}

次のように返されます：

コンソール結果

{
  "columns": [
   {"name": "author", "type": "text"},
   {"name": "name", "type": "text"},
   {"name": "page_count", "type": "short"},
   {"name": "release_date", "type": "datetime"}
  ],
  "values": [
   ["Peter F. Hamilton", "Vernor Vinge", "Frank Herbert", "Alastair Reynolds", "James S.A. Corey"],
   ["Pandora's Star", "A Fire Upon the Deep", "Dune", "Revelation Space", "Leviathan Wakes"],
   [768, 613, 604, 585, 561],
   ["2004-03-02T00:00:00.000Z", "1992-06-01T00:00:00.000Z", "1965-06-01T00:00:00.000Z", "2000-03-15T00:00:00.000Z", "2011-06-02T00:00:00.000Z"]
  ],
  "cursor": "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWWWdrRlVfSS1TbDYtcW9lc1FJNmlYdw==:BAFmBmF1dGhvcgFmBG5hbWUBZgpwYWdlX2NvdW50AWYMcmVsZWFzZV9kYXRl+v///w8="
}

その後の呼び出しでcursorを使用する場合でも、オリエンテーションを保持するためにcolumnarパラメータを含める必要があります。つまり、最初のクエリはカラムオプションを記憶しません。

Python

resp = client.sql.query(
   format="json",
   cursor="sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWWWdrRlVfSS1TbDYtcW9lc1FJNmlYdw==:BAFmBmF1dGhvcgFmBG5hbWUBZgpwYWdlX2NvdW50AWYMcmVsZWFzZV9kYXRl+v///w8=",
   columnar=True,
)
print(resp)

Js

const response = await client.sql.query({
  format: "json",
  cursor:
   "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWWWdrRlVfSS1TbDYtcW9lc1FJNmlYdw==:BAFmBmF1dGhvcgFmBG5hbWUBZgpwYWdlX2NvdW50AWYMcmVsZWFzZV9kYXRl+v///w8=",
  columnar: true,
});
console.log(response);

コンソール

POST /_sql?format=json
{
  "cursor": "sDXF1ZXJ5QW5kRmV0Y2gBAAAAAAAAAAEWWWdrRlVfSS1TbDYtcW9lc1FJNmlYdw==:BAFmBmF1dGhvcgFmBG5hbWUBZgpwYWdlX2NvdW50AWYMcmVsZWFzZV9kYXRl+v///w8=",
  "columnar": true
}

次のようになります：

コンソール結果

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