ANSI 连接
本章介绍如何跨实体使用 ANSI 连接。自 5.5 版本起,Couchbase 服务器支持通过字段连接文档的 ANSI 连接。早期版本仅支持索引连接与查找连接,在 SDC 中只能通过 SDK 直接查询来使用。
跨仓库的实体之间的关系可以是一对一或一对多。通过定义此类关系,可以获取关联实体的同步视图。
配置
可以通过在实体的属性引用上添加 @N1qlJoin 注解来获取关联实体。前缀 lks 表示左侧键空间(当前实体),rks 表示右侧键空间(关联实体)。@N1qlJoin 注解必需的元素是 on 子句,它是一个布尔表达式,表示左侧(lks)与右侧(rks)之间的连接条件,可以是字段、常量表达式或任何复杂的 N1QL 表达式。注解上还可以为连接指定可选的 where 子句,同样使用 lks 表示当前实体、rks 表示关联实体。
示例 1. ANSI 连接注解
@Document
public class Author {
@Id
String id;
String name;
@N1qlJoin(on = "lks.name=rks.authorName")
List<Book> books;
@N1qlJoin(on = "lks.name=rks.name")
Address address;
...
}
延迟抓取
关联实体可以在首次访问该属性时被延迟抓取,这样可以避免在加载实体时抓取超出所需的数据。要延迟加载关联实体,必须将 @N1qlJoin 注解的 fetchType 元素设置为 FetchType.LAZY。默认值为 FetchType.IMMEDIATE。
示例 2. 延迟抓取配置
@N1qlJoin(on = "lks.name=rks.authorName", fetchType = FetchType.LAZY)
List<Book> books;
ANSI 连接提示
使用索引提示
@N1qlJoin 上的 index 元素可用于为 lks(当前实体)索引提供提示,rightIndex 元素可用于为 rks(关联实体)索引提供提示。
哈希连接提示
如果连接类型为哈希连接,则可以为 rks(关联实体)指定哈希侧。如果关联实体位于构建侧,则可以指定为 HashSide.BUILD,否则为 HashSide.PROBE。
使用键提示
@N1qlJoin 注解上的 keys 元素可用于指定唯一的文档键,以限制连接键空间。