Cloud Save 查询
Understand indexes and query types for both numerical and text data stored in player and game data.
阅读时间3 分钟最后更新于 7 个月前
您可以使用 Cloud Save 来查询存储在玩家数据和游戏数据中的数字和文本数据。 查询功能可用于多种目的，例如创建公会或氏族系统、添加匹配、实施经济系统或拍卖行，或在多人游戏环境中返回 NPC 或物品数据。
创建索引
您需要先在 Cloud Save 中为数据编制索引，然后才能查询数据。您可以在 Unity Cloud 后台、Unity CLI 或 Admin REST API 中创建和管理索引。 您可以构建单个 Cloud Save 键的索引，或按特定顺序组合多个键以形成复合索引。Cloud Save 为每个键标记一个布尔值，以指定索引是按升序还是降序排序。使用索引无需支付额外费用。查询类型
Cloud Save 支持以下类型的查询：- - 等于
EQ - - 不等于
NE - - 小于
LT - - 小于或等于
LE - - 大于
GT - - 大于或等于
GE
随机样本
如果不希望返回可以分页的完整排序结果集（默认行为），您可以让 Cloud Save 返回查询的随机结果样本。 要使用此功能，请在执行查询时传递sampleSize限制
查询限制
可从客户端或服务器查询的数据由索引键的访问类决定：- 使用面向 Unity 的 Cloud Save SDK，游戏客户端可以查询公开访问类中的玩家数据，或者查询存储在默认访问类中的游戏数据。
- 使用面向 Cloud Code 的 Cloud Save SDK，或者使用 CLI 或 Admin REST API，可以查询任何访问类（例如默认、公开、私有或受保护）中的索引键。
索引限制
- 可以编制索引的值的最大大小为 128 字节： 大于 128 字节的值不会被索引；如果您尝试将大于 128 字节的值写入到索引键，则索引会失败（数据仍会保存到 Cloud Save，但数据不会被索引）。
- 最多可以定义 20 个键，这些键可以在所有索引、所有访问类、玩家状态和游戏状态中编制索引。 这意味着，可以有多达 20 个索引，每个索引各包含一个索引键，或者一个索引包含 20 个索引键，或是这两者之间的任意组合。只要索引键的总数不超过限制即可。
重要
重要：您只能查询创建索引后保存的数据。查询响应中不包含您在创建索引之前保存的任何数据。