Spring Data Elasticsearch 不会隐式地从注解创建映射

Question

我正在尝试使用 Spring Data Elasticsearch 4.0.1 并试图弄清楚 Elasticsearch 映射是如何以及何时由 Spring 创建的，或者它们是否是由 Spring 创建的。

如果我有这样的实体：

@Document(indexName = "companies")
public class CompanyEntity {

  @Id
  private final String id;

  @MultiField(
      mainField = @Field(type = Text),
      otherFields = {
          @InnerField(suffix = "raw", type = Keyword)
      }
  )
  private final String companyName;

  @PersistenceConstructor
  public CompanyEntity(String id, String companyName) {
    this.id = id;
    this.companyName = companyName;
  }

  public String getId() {
    return id;
  }

  public String getCompanyName() {
    return companyName;
  }
}

我的印象是 Spring 会隐式创建此索引的映射，但我似乎弄错了。 Elasticsearch 仍会为此索引创建映射。

{
    "companies": {
        "mappings": {
            "properties": {
                "_class": {
                    "type": "text",
                    "fields": {
                        "keyword": {
                            "type": "keyword",
                            "ignore_above": 256
                        }
                    }
                },
                "companyName": {
                    "type": "text",
                    "fields": {
                        "keyword": {
                            "type": "keyword",
                            "ignore_above": 256
                        }
                    }
                },
                "id": {
                    "type": "text",
                    "fields": {
                        "keyword": {
                            "type": "keyword",
                            "ignore_above": 256
                        }
                    }
                }
            }
        }
    }
}

从上面很明显，InnerField 注释中的后缀没有被使用，并且 ignore_above 值也没有被使用，因为它默认为 -1，如果尝试将 ignore_above 设置为 -1，Elasticsearch 将完全删除该字段。

我能够获得上述注释映射的唯一方法是自己显式设置映射。

@Autowired private ElasticsearchOperations operations;

Document mapping = operations.indexOps(CompanyEntity.class).createMapping();
operations.indexOps(CompanyEntity.class).putMapping(mapping); 

这会产生预期的映射：

{
    "companies": {
        "mappings": {
            "properties": {
                "_class": {
                    "type": "text",
                    "fields": {
                        "keyword": {
                            "type": "keyword",
                            "ignore_above": 256
                        }
                    }
                },
                "companyName": {
                    "type": "text",
                    "fields": {
                        "raw": {
                            "type": "keyword"
                        }
                    }
                },
                "id": {
                    "type": "text",
                    "fields": {
                        "keyword": {
                            "type": "keyword",
                            "ignore_above": 256
                        }
                    }
                }
            }
        }
    }
}

这很好，但我觉得有点奇怪，因为我在官方Spring Data Elasticsearch docs 中找不到这种方法的任何细节。 JavaDocs 没有任何细节。

这是从 Spring Data 将映射安装到 Elasticsearch 的正确方法吗？

Answer 1

如果您使用的是ElasticsearchOperations，那么这是创建映射的正确方法。在4.1版本中会有一个额外的方法

boolean putMapping(Class<?> clazz)

它结合了创建和编写映射的两个步骤。

ElasticsearchOperations 和 IndexOperations - 或者更好的实现 - 是 Spring Data Elasticsearch 中对 Elasticsearch 的更低级别的访问 - 创建索引、放置映射、编写实体等。这些是基本操作。您可以完全控制执行哪些操作，但执行这些操作是您的责任。

建立在此之上的是存储库支持。如果你定义了一个仓库接口

interface CompanyRepository extends ElasticsearchRepository<CompanyEntity, String>{}

你在你的一个类中注入的

@Autowired CompanyRepository repository;

然后在应用程序启动时，Spring Data Elasticsearch 将创建此接口的实现，并检查实体的@Document 注释定义的索引是否存在。如果没有，它将创建索引并编写映射 - @Document 注释有一个参数 createIndex，默认情况下为 true。

因此，对于自动创建，您必须使用存储库，存储库支持还利用 ElasticsearchOperations 提供诸如从方法名称派生的查询、分页支持等。