java - 使 ElasticSearch 在配置错误时失败

Question

我正在使用来自 Java 的当前 ES 2.3.4，它对我这边的错误保持沉默。很难追查问题的原因。

问题:如何将 ES 配置为非宽松的，并尽早失败，而不是尝试施展魔法？

---

案例 1:使用 Java API 创建索引

一个正确的例子在 Define custom ElasticSearch Analyzer using Java API 的答案中和 How to add analyzer settings in ElasticSearch?

不幸的是，在第二个链接的问题中，我在 analysis 周围有一个额外的 settings 对象。

运行 prepareCreate() 没有关系，没有错误，只是确认。

案例 2:在不存在的映射中引用分析器

在对 prepareCreate() 的同一次调用中，我定义了我的映射。我定义了不存在的 field("analyzer", "myanalyzer")(因为对象的装箱是错误的)并且它再次不介意。

我最终弄清楚的方法是运行一个带有显式 QueryBuilders.matchQuery("myfield", myvalue).analyzer("myanalyzer") 的 prepareSearch() 并在那里提示说有没有这样的分析器。

---

更新 1

我仍然对 settings 部分感到困惑。本例 https://www.elastic.co/guide/en/elasticsearch/guide/current/ngrams-compound-words.html使用 settings 部分作为 mappings 部分的兄弟，并且不直接从 analysis 部分开始。

所以我在 Java 中做同样的事情，这里是我的确切代码:

        xContentBuilder = XContentFactory.jsonBuilder().prettyPrint()
                .startObject() //root

                .startObject("settings")
                .startObject("analysis")
                .startObject("filter")
                .startObject("trigrams_filter").field("type", "ngram").field("min_gram", "3").field("max_gram", "3").endObject()
                .endObject() //filter
                .startObject("analyzer")
                .startObject("trigrams")
                    .field("type", "custom")
                    .field("tokenizer", "standard")
                    .field("filter", new String[]{"lowercase", "trigrams_filter"})
                .endObject()
                .endObject() //analyzer
                .endObject() //settings

                .startObject("mappings")
                .startObject(typeName)
                .startObject("properties")
                .startObject("myfield1").field("type", "string").field("analyzer", "trigrams").endObject()
                .endObject() //properties
                .endObject() //typeName
                .endObject() //mappings

                .endObject(); //root

我创建了新索引，没有失败回调，没有中止:

    ListenableActionFuture<CreateIndexResponse> execute = this.node.client().admin().indices().prepareCreate(indexName)
            .setSettings(xContentBuilder)
            .execute();

    execute.addListener(new ActionListener<CreateIndexResponse>() {
        @Override
        public void onResponse(CreateIndexResponse createIndexResponse) {
            System.out.println(createIndexResponse);
        }

        @Override
        public void onFailure(Throwable e) {
            e.printStackTrace();
        }
    });

    CreateIndexResponse createIndexResponse = execute.actionGet();

然后我查询，这个查询经过:

boolQuery.must(QueryBuilders.matchQuery("myfield1", parsedStreetName.getBase()));

而这个不是:

boolQuery.must(QueryBuilders.matchQuery("myfield1", parsedStreetName.getBase()).analyzer("trigrams").minimumShouldMatch("40%"));

它说:

Caused by: [streetindex] QueryParsingException[[match] analyzer [trigrams] not found] at org.elasticsearch.index.query.MatchQueryParser.parse(MatchQueryParser.java:101)

如果我省略 settings 开始和结束对象，则会创建 trigrams 分析器(搜索不会报错)。

但是:

• 如何让它失败？
• 此处的 Java API 与 REST 有何不同？这是故意的吗？
• 搜索未找到与八卦相关的任何内容。

我可以创建其他无效的配置，它很乐意创建索引。一个例子:

        xContentBuilder = XContentFactory.jsonBuilder().prettyPrint()
                .startObject() //root

                .startObject("asdf")
                .startObject("nana")
                .startObject("foobar").field("dada", "dudu").endObject()
                .endObject()
                .endObject()

                .endObject(); //root

我也有一次缺少 endObject() 并且代码没有抛出。

我很困惑。

Answer 1

我的用例的正确 Java API 方法是 setSource()，而不是 setSettings()。

我从 SO 链接的 Java 代码示例仅设置设置，而不是同时设置映射。这就是为什么那些在层次结构中没有 settings 的原因。

setSource() 方法的 Javadoc 说:

Sets the settings and mappings as a single source.

就是这样。现在一切都清楚了。

但是，我真的不明白为什么 setSettings() 接受任何类型的内容。