› › ›

Запрос скрипта

Поля runtime предоставляют очень похожую функцию, которая более гибкая. Вы пишете скрипт для создания значений поля, и они доступны везде, например, в fields, всех запросах и агрегациях.

Фильтрует документы на основе предоставленного скрипта. Запрос script обычно используется в контексте фильтра.

Использование скриптов может привести к замедлению скорости поиска. См. Скрипты, кэширование и скорость поиска.

Пример запроса

GET /_search
{
  "query": {
    "bool": {
      "filter": {
        "script": {
          "script": """
            double amount = doc['amount'].value;
            if (doc['type'].value == 'expense') {
              amount *= -1;
            }
            return amount < 10;
          """
        }
      }
    }
  }
}

Вы можете добиться тех же результатов в запросе поиска, используя поля runtime. Используйте параметр fields в API _search, чтобы извлечь значения в рамках того же запроса:

GET /_search
{
  "runtime_mappings": {
    "amount.signed": {
      "type": "double",
      "script": """
        double amount = doc['amount'].value;
        if (doc['type'].value == 'expense') {
          amount *= -1;
        }
        emit(amount);
      """
    }
  },
  "query": {
    "bool": {
      "filter": {
        "range": {
          "amount.signed": { "lt": 10 }
        }
      }
    }
  },
  "fields": [{"field": "amount.signed"}]
}

Параметры верхнего уровня для `script`

script: (Обязательный, объект скрипта) Содержит скрипт для выполнения в качестве запроса. Этот скрипт должен возвращать булево значение, true или false.

Примечания

Настраиваемые параметры

Как и фильтры, скрипты кэшируются для ускорения выполнения. Если вы часто изменяете аргументы скрипта, рекомендуется хранить их в параметре params скрипта. Например:

GET /_search
{
  "query": {
    "bool": {
      "filter": {
        "script": {
          "script": {
            "source": "doc['num1'].value > params.param1",
            "lang": "painless",
            "params": {
              "param1": 5
            }
          }
        }
      }
    }
  }
}

Разрешить дорогостоящие запросы

Запросы скриптов не будут выполняться, если search.allow_expensive_queries установлено в значение false.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/query-dsl-script-query.html