使 ElasticSearch 因配置错误而失败答案

【问题标题】：Make ElasticSearch fail on configuration error使 ElasticSearch 因配置错误而失败
【发布时间】：2016-08-03 01:12:13
【问题描述】：

我正在使用来自 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() 的同一次调用中，我定义了我的 mappings。我定义了不存在的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

我新建索引，没有失败回调，没有abort：

    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%"));

上面写着：

原因：[streetindex] QueryParsingException[[match] 分析器 [trigrams] 未找到] 在 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() 并且代码没有抛出。

我很困惑。

【问题讨论】：

关于案例 2，ES 不允许您通过在映射中引用未知分析器来创建索引。不知道你是怎么做的，但你应该展示一些代码。

标签： java elasticsearch

【解决方案1】：

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

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

setSource() 方法的 Javadoc 说：

将设置和映射设置为单一来源。

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

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

【讨论】：