Запрос с использованием строки поиска (simple query string query)

Оператор simple_query_string поддерживает следующие операторы:

Чтобы использовать один из этих символов буквально, экранируйте его предшествующей обратной косой чертой (\).

Поведение этих операторов может отличаться в зависимости от значения default_operator. Например:

resp = client.search(
    query={
        "simple_query_string": {
            "fields": [
                "content"
            ],
            "query": "foo bar -baz"
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      simple_query_string: {
        fields: [
          'content'
        ],
        query: 'foo bar -baz'
      }
    }
  }
)
puts response

const response = await client.search({
  query: {
    simple_query_string: {
      fields: ["content"],
      query: "foo bar -baz",
    },
  },
});
console.log(response);

GET /_search
{
  "query": {
    "simple_query_string": {
      "fields": [ "content" ],
      "query": "foo bar -baz"
    }
  }
}

Этот поиск предназначен для возврата только документов, содержащих foo или bar, которые также не содержат baz. Однако из-за default_operator OR, этот поиск на самом деле возвращает документы, содержащие foo или bar, а также любые документы, не содержащие baz. Чтобы получить документы так, как предполагалось, измените строку запроса на foo bar +-baz.

Вы можете использовать параметр flags для ограничения поддерживаемых операторов синтаксиса простого запроса.

Чтобы явно включить только определенные операторы, используйте разделитель |. Например, значение flags OR|AND|PREFIX отключает все операторы, кроме OR, AND и PREFIX.

resp = client.search(
    query={
        "simple_query_string": {
            "query": "foo | bar + baz*",
            "flags": "OR|AND|PREFIX"
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      simple_query_string: {
        query: 'foo | bar + baz*',
        flags: 'OR|AND|PREFIX'
      }
    }
  }
)
puts response

const response = await client.search({
  query: {
    simple_query_string: {
      query: "foo | bar + baz*",
      flags: "OR|AND|PREFIX",
    },
  },
});
console.log(response);

GET /_search
{
  "query": {
    "simple_query_string": {
      "query": "foo | bar + baz*",
      "flags": "OR|AND|PREFIX"
    }
  }
}

Поля могут быть указаны с подстановочными знаками, например:

resp = client.search(
    query={
        "simple_query_string": {
            "query": "Will Smith",
            "fields": [
                "title",
                "*_name"
            ]
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      simple_query_string: {
        query: 'Will Smith',
        fields: [
          'title',
          '*_name'
        ]
      }
    }
  }
)
puts response

const response = await client.search({
  query: {
    simple_query_string: {
      query: "Will Smith",
      fields: ["title", "*_name"],
    },
  },
});
console.log(response);

GET /_search
{
  "query": {
    "simple_query_string" : {
      "query":    "Will Smith",
      "fields": [ "title", "*_name" ] 
    }
  }
}

Отдельные поля могут быть усилены с помощью знака вставки (^):

resp = client.search(
    query={
        "simple_query_string": {
            "query": "this is a test",
            "fields": [
                "subject^3",
                "message"
            ]
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      simple_query_string: {
        query: 'this is a test',
        fields: [
          'subject^3',
          'message'
        ]
      }
    }
  }
)
puts response

const response = await client.search({
  query: {
    simple_query_string: {
      query: "this is a test",
      fields: ["subject^3", "message"],
    },
  },
});
console.log(response);

GET /_search
{
  "query": {
    "simple_query_string" : {
      "query" : "this is a test",
      "fields" : [ "subject^3", "message" ] 
    }
  }
}

По умолчанию, анализатор запросов simple_query_string создает запрос match_phrase для каждого токена в нескольких позициях в строке запроса. Например, парсер создает запрос match_phrase для многословного синонима ny, new york:

(ny OR ("new york"))

Чтобы сопоставлять токены в нескольких позициях с конъюнкцией AND, установите значение auto_generate_synonyms_phrase_query в false:

resp = client.search(
    query={
        "simple_query_string": {
            "query": "ny city",
            "auto_generate_synonyms_phrase_query": False
        }
    },
)
print(resp)

response = client.search(
  body: {
    query: {
      simple_query_string: {
        query: 'ny city',
        auto_generate_synonyms_phrase_query: false
      }
    }
  }
)
puts response

const response = await client.search({
  query: {
    simple_query_string: {
      query: "ny city",
      auto_generate_synonyms_phrase_query: false,
    },
  },
});
console.log(response);

GET /_search
{
  "query": {
    "simple_query_string": {
      "query": "ny city",
      "auto_generate_synonyms_phrase_query": false
    }
  }
}

Для данного примера парсер создает следующий запрос bool:

(ny OR (new AND york)) city)

Этот запрос bool соответствует документам с термином ny или конъюнкцией new AND york.