Spring Data访问Elasticsearch----路由值Routing values

Spring Data访问Elasticsearch----路由值Routing values

当Elasticsearch将文档存储在具有多个分片的索引中时,它会根据文档的id确定要使用的分片。有时有必要预先定义多个文档应该在同一个shard上建立索引(join-types,更快地搜索相关数据)。为此,Elasticsearch提供了定义路由的可能性,路由是用于计算shard的值,而不是id。
Spring Data Elasticsearch通过以下方式支持存储和检索数据的路由定义:

一、join-types的路由

当使用联接类型(请参阅联接类型实现)时,Spring Data Elasticsearch将自动使用实体的JoinField属性的parent属性作为路由的值。

这对于parent-child关系只有一个级别的所有用例都是正确的。如果是更深层次的,比如child-parent-grandparent的关系------比如之前的例子vote → answer → question-然后需要使用下一节中描述的技术明确指定路由(投票需要question.id作为路由值)。

二、自定义路由值

为了定义一个实体的自定义路由,Spring Data Elasticsearch提供了一个@Routing注解(重用之前的Statement类):

java 复制代码
@Document(indexName = "statements")
@Routing("routing")         --------1         
public class Statement {
    @Id
    private String id;

    @Field(type = FieldType.Text)
    private String text;

    @JoinTypeRelations(
        relations =
            {
                @JoinTypeRelation(parent = "question", children = {"answer", "comment"}),
                @JoinTypeRelation(parent = "answer", children = "vote")
            }
    )
    private JoinField<String> relation;

    @Nullable
    @Field(type = FieldType.Keyword)
    private String routing; --------2         

    // getter/setter...
}

1. 这将"路由"定义为路由规范
2. 具有名称routing的属性

如果注解的路由定义是纯字符串而不是SpEL表达式,则它被解析为实体的属性的名称,在本例中,它是routing属性。然后,此属性的值将用作使用该实体的所有请求的路由值。

我们也可以在@Document注解中使用SpEL表达式,如下所示:

java 复制代码
@Document(indexName = "statements")
@Routing("@myBean.getRouting(#entity)")
public class Statement{
    // all the needed stuff
}

在这种情况下,用户需要提供一个名为myBean的bean,该bean具有String getRouting(Object)方法。要引用实体,必须在SpEL表达式中使用"#entity",并且返回值必须为null或路由值为String。

如果普通属性的名称和SpEL表达式不足以自定义路由定义,则可以定义并提供RoutingResolver接口的实现。然后可以在ElasticOperations实例上设置:

java 复制代码
RoutingResolver resolver = ...;

ElasticsearchOperations customOperations= operations.withRouting(resolver);

withRouting()函数返回带有自定义路由集的原始ElasticsearchOperations实例的副本。

当路由存储在Elasticsearch中时,在实体上定义了路由时,在执行get或delete操作时必须提供相同的值。对于不使用实体(如get(ID)或delete(ID))的方法,ElasticsearchOperations.withRouting(RoutingResolver)方法可以这样使用:

java 复制代码
String id = "someId";
String routing = "theRoutingValue";

// get an entity
Statement s = operations
                .withRouting(RoutingResolver.just(routing))  --------1     
                .get(id, Statement.class);

// delete an entity
operations.withRouting(RoutingResolver.just(routing)).delete(id);

1. RoutingResolver.just(s)返回一个只会返回给定字符串的解析器。
相关推荐
liliangcsdn6 小时前
如何基于ElasticsearchRetriever构建RAG系统
大数据·elasticsearch·langchain
相与还7 小时前
IDEA和GIT实现cherry pick拣选部分变更到新分支
git·elasticsearch·intellij-idea
hello 早上好7 小时前
深入 Spring 依赖注入底层原理
数据库·sql·spring
Elastic 中国社区官方博客12 小时前
Simple MCP Client - 连接到 Elasticsearch MCP 并进行自然语言搜索
大数据·人工智能·elasticsearch·搜索引擎·ai·全文检索
会飞的小蛮猪12 小时前
ELK运维之路(Logstash测试案例1)
elasticsearch·kibana·logstash
cxyxiaokui00113 小时前
🔍 为什么我的日志在事务回滚后也没了?——揭秘 REQUIRES_NEW 的陷阱
java·后端·spring
跟着珅聪学java14 小时前
spring boot 整合 activiti 教程
android·java·spring
Java水解14 小时前
Spring JDBC与KingbaseES深度集成:构建高性能国产数据库应用实战
后端·spring
tcwgq14 小时前
Centos Stream 8 搭建Cas Server
linux·elasticsearch·centos
低音钢琴15 小时前
【SpringBoot从初学者到专家的成长15】MVC、Spring MVC与Spring Boot:理解其差异与联系
spring boot·spring·mvc