概要（Overview）

概要

SQL検索APIは、JSONドキュメント内のSQLを受け取り、それを実行し、結果を返します。例えば:

Python

resp = client.sql.query(
   format="txt",
   query="SELECT * FROM library ORDER BY page_count DESC LIMIT 5",
)
print(resp)

Ruby

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

Js

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

コンソール

POST /_sql?format=txt
{
  "query": "SELECT * FROM library ORDER BY page_count DESC LIMIT 5"
}

これにより、次のように返されます:

テキスト

author      |        name        |  page_count   | release_date
-----------------+--------------------+---------------+------------------------
Peter F. Hamilton|Pandora's Star      |768            |2004-03-02T00:00:00.000Z
Vernor Vinge     |A Fire Upon the Deep|613            |1992-06-01T00:00:00.000Z
Frank Herbert    |Dune                |604            |1965-06-01T00:00:00.000Z
Alastair Reynolds|Revelation Space    |585            |2000-03-15T00:00:00.000Z
James S.A. Corey |Leviathan Wakes     |561            |2011-06-02T00:00:00.000Z

Kibanaコンソールの使用

Kibanaコンソールを使用している場合（強く推奨されます）、クエリを作成する際に三重引用符"""を活用してください。これにより、クエリ文字列内の二重引用符(")が自動的にエスケープされるだけでなく、以下のように複数行もサポートされます: