Использование SQL для поиска данных в Elasticsearch

Пример использования SQL

• Используйте SQL для поиска данных в Kibana (рекомендовано).

  Войдите в Kibana и, на Dev Tools страницу, отправьте запросы к _opendistro/_sql используя параметры запроса или тело запроса.

  Например, выполните следующую команду, чтобы получить 50 записей из my-index индекс:

  POST _opendistro/_sql
  {
    "query": "SELECT * FROM my-index LIMIT 50"
  }
  
  

  По умолчанию результат запроса возвращается в формате JSON. Чтобы вернуть данные в формате CSV, установите format параметр в команде следующим образом:

  POST _opendistro/_sql?format=csv
  {
    "query": "SELECT * FROM my-index LIMIT 50"
  }
  
  

  Когда результат запроса возвращается в формате CSV, каждая строка соответствует документу, а каждый столбец — полю.

• Запустите команды cURL на ECS для выполнения SQL‑запросов для поиска данных.

  Например, выполните следующую команду, чтобы получить 10 записей из kibana_sample_data_flights индекс.

  curl -XPOST https://localhost:9200/_opendistro/_sql -u username:password -k -d '{"query": "SELECT * FROM kibana_sample_data_flights LIMIT 10"}' -H 'Content-Type: application/json'
  
  

  localhost указывает адрес доступа к кластеру. username and password указывают имя пользователя и пароль для доступа к кластеру в режиме безопасности соответственно.

Поддерживаемые операции SQL

• Statements

  Table 1 Statements

  Statement	Пример
  Select	SELECT * FROM my-index
  Delete	DELETE FROM my-index WHERE _id=1
  Where	SELECT * FROM my-index WHERE ['field']='value'
  Order by	SELECT * FROM my-index ORDER BY _id asc
  Group by	SELECT * FROM my-index GROUP BY range(age, 20,30,39)
  Limit	SELECT * FROM my-index LIMIT 50 (default is 200)
  Union	SELECT * FROM my-index1 UNION SELECT * FROM my-index2
  Minus	SELECT * FROM my-index1 MINUS SELECT * FROM my-index2

  Note

  Как и любой сложный запрос, большие UNION и MINUS могут перегрузить или даже вызвать сбой вашего кластера.

• Conditions

  Table 2 Conditions

  Condition	Пример
  Like	SELECT * FROM my-index WHERE name LIKE 'j%'
  And	SELECT * FROM my-index WHERE name LIKE 'j%' AND age > 21
  Or	SELECT * FROM my-index WHERE name LIKE 'j%' OR age > 21
  Count distinct	SELECT count(distinct age) FROM my-index
  In	SELECT * FROM my-index WHERE name IN ('Bob', 'David')
  Not	SELECT * FROM my-index WHERE name NOT IN ('Bob')
  Between	SELECT * FROM my-index WHERE age BETWEEN 20 AND 30
  Aliases	SELECT avg(age) AS Average_Age FROM my-index
  Date	SELECT * FROM my-index WHERE birthday='1990-11-15'
  Null	SELECT * FROM my-index WHERE name IS NULL

• Aggregations

  Table 3 Aggregations

  Aggregation	Пример
  avg()	SELECT avg(age) FROM my-index
  count()	SELECT count(age) FROM my-index
  max()	SELECT max(age) AS Highest_Age FROM my-index
  min()	SELECT min(age) AS Lowest_Age FROM my-index
  sum()	SELECT sum(age) AS Age_Sum FROM my-index

• Включение и исключение полей

  Table 4 Включение и исключение полей

  Pattern	Пример
  include()	SELECT include('a*'), exclude('age') FROM my-index
  exclude()	SELECT exclude('*name') FROM my-index

• Функции

  Table 5 Функции

  Функция	Пример
  floor	SELECT floor(number) AS Rounded_Down FROM my-index
  trim	SELECT trim(name) FROM my-index
  log	SELECT log(number) FROM my-index
  log10	SELECT log10(number) FROM my-index
  substring	SELECT substring(name, 2,5) FROM my-index
  round	SELECT round(number) FROM my-index
  sqrt	SELECT sqrt(number) FROM my-index
  concat_ws	SELECT concat_ws(' ', age, height) AS combined FROM my-index
  /	SELECT number / 100 FROM my-index
  %	SELECT number % 100 FROM my-index
  date_format	SELECT date_format(date, 'Y') FROM my-index

  Note

  Необходимо включить fielddata в отображении документа, чтобы большинство строковых функций работали корректно.

• Соединения

  Table 6 Соединения

  Join	Пример
  Inner join	SELECT s.firstname, s.lastname, s.gender, sc.name FROM student s JOIN school sc ON sc.name = s.school_name WHERE s.age > 20
  Left outer join	SELECT s.firstname, s.lastname, s.gender, sc.name FROM student s LEFT JOIN school sc ON sc.name = s.school_name
  Cross join	SELECT s.firstname, s.lastname, s.gender, sc.name FROM student s CROSS JOIN school sc

  Подробнее о ограничениях смотрите Соединения.

• Show

  Команды Show отображают индексы и отображения, соответствующие шаблону индекса. Вы можете использовать * or % для шаблонов.

  Table 7 Show

  Show	Пример
  Show tables like	SHOW TABLES LIKE logs-*

Соединения

• Можно соединять только два индекса.

• Для каждого индекса необходимо использовать псевдоним (например, people p).

• В предложении ON можно использовать только условия AND.

• В операторе WHERE не объединяйте деревья, содержащие несколько индексов. Например, следующее утверждение будет работать:

  WHERE (a.type1 > 3 OR a.type1 < 0) AND (b.type2 > 4 OR b.type2 < -1)
  
  

  Следующее утверждение не будет работать:

  WHERE (a.type1 > 3 OR b.type2 < 0) AND (a.type1 > 4 OR b.type2 < -1)
  
  

• Нельзя использовать GROUP BY или ORDER BY для получения результатов.

• LIMIT с OFFSET (например, LIMIT 25 OFFSET 25) не поддерживается.

JDBC Driver