Apache Ignite缓存查询使用指南：从基础到高级技巧-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00948/article/details/148524613

Apache Ignite缓存查询使用指南：从基础到高级技巧

ignite Apache Ignite 项目地址: https://gitcode.com/gh_mirrors/ignite16/ignite

概述

Apache Ignite作为一个高性能的内存计算平台，提供了强大的分布式缓存功能。其中缓存查询是Ignite最核心的能力之一，开发者可以通过多种方式查询缓存中的数据。本文将全面介绍Ignite的缓存查询机制，帮助开发者掌握从基础查询到高级应用的各项技巧。

查询基础架构

Ignite的查询体系基于两个核心抽象：

Query类：表示要在缓存上执行的抽象分页查询，可以通过setPageSize()方法配置页面大小（默认为1024）
QueryCursor类：表示查询结果集，支持透明的逐页迭代

当用户开始迭代最后一页时，QueryCursor会自动在后台请求下一页。如果不需要分页，可以直接使用QueryCursor.getAll()方法一次性获取所有结果。

重要提示：使用迭代器遍历结果时，必须显式关闭游标或使用try-with-resources语句，否则可能导致资源泄漏。

扫描查询(Scan Query)

扫描查询是最基础的查询类型，它以分布式方式从缓存中检索数据。当不带参数执行时，扫描查询会返回缓存中的所有条目。

基本用法

Java示例：

IgniteCache<Integer, Person> cache = ignite.cache("myCache");
QueryCursor<Cache.Entry<Integer, Person>> cursor = cache.query(new ScanQuery<>());

使用谓词过滤

扫描查询可以配合谓词(Predicate)使用，谓词会在远程节点上应用，减少网络传输：

ScanQuery<Integer, Person> scanQuery = new ScanQuery<>(
    (k, p) -> p.getName().contains("Smith") && p.getSalary() > 1000
);

结果转换

扫描查询支持可选的转换器(Transformer)，可以在服务器节点上转换条目后再发送回客户端，这对于减少网络流量特别有用：

ScanQuery<Integer, Person> scanQuery = new ScanQuery<>(
    null, // 无过滤谓词
    entry -> entry.getKey() // 只返回键
);

本地扫描查询

默认情况下，扫描查询会分布到所有节点执行。但也可以将查询限制在本地节点：

ScanQuery<Integer, Person> scanQuery = new ScanQuery<>();
scanQuery.setLocal(true); // 设置为本地查询

索引查询(Index Query) - 实验性API

索引查询是Ignite 2.12引入的实验性功能，它通过分布式索引检索匹配查询条件的缓存条目，并按索引定义的顺序返回结果。

索引查询优势

相比扫描查询，索引查询在以下场景表现更优：

匹配条件的数据量较小时
查询可以利用索引树结构过滤大部分条目
需要按特定顺序获取结果时

基本用法

IndexQuery<Integer, Person> idxQuery = new IndexQuery<Integer, Person>(Person.class, "salary_idx")
    .setCriteria(lt("salary", 1000), gt("salary", 500));

索引查询准则

条件字段必须与索引定义匹配
多个条件默认使用AND连接
可以为同一字段指定多个条件

// 多条件示例
IndexQuery<Integer, Person> idxQuery = new IndexQuery<>(Person.class)
    .setCriteria(lt("salary", 1000), gt("age", 30));

附加过滤

索引查询也支持额外的谓词过滤，适用于以下场景：

过滤逻辑复杂（如包含OR操作）
过滤条件涉及非索引字段

IndexQuery<Integer, Person> idxQuery = new IndexQuery<>(Person.class, "salary_idx")
    .setCriteria(gt("salary", 1000))
    .setFilter((k, p) -> p.getName().startsWith("A"));