1 概述 - 开发者服务评测.docxVIP

1? 概述? 结构化数据存储为移动应用开发者提供安全高效、高度可扩展的分布式NoSQL数据存储云服务。主要功能有： 支持用户自定义数据表结构，且支持多种数据类型 支持读写公共数据 支持客户端安全访问用户的个人数据 支持服务器安全的访问属于该应用的数据 支持多帐号平台系统，如客户端用户使用知名第三方OAuth登录系统并且容易扩展到其他登录系统 支持海量数据和大量并发操作 提供易用的管理平台提供统计数据及数据导入导出 2 新手上路 我们将要创建一个使用结构化数据存储的云端通讯录应用，该应用会提供两个功能：一、支持方便的查询常用的公共电话号码；二、每个用户可以安全的访问自己的通讯录。想象到我们的应用将会有千万甚至上亿级别的活跃用户。如果使用传统的关系型数据库，此刻你应该已经意识到数据库表模型的设计不仅要考虑该如何满足业务需求，还要考虑数据该如何切分（分库分表、水平或垂直拆分）、是否需要读写分离、是否需要数据缓存，每一个细节都需要我们进行深入探究，已确保服务可以高效、稳定、安全的访问。与之类似，使用结构化数据存储，你仍然需要考虑该如何设计表模型以满足的业务，没人可以代替你完成这项工作。接下来，会发现这是你唯一需要考虑的问题，其他问题结构化数据存储很自然的帮你完成了。 下面的演示中，我们会创建一个应用：云通讯录，并且开通小米帐号服务用于用户的登录鉴权，然后创建两张表public_phone_numbers和private_phone_numbers分别用来存储公共电话号码和用户的私人通讯录。 ? 到目前为止，我们已经创建好表及应用的配置，补充两点在应用配置界面的说明： 我们执行了一个表与应用的关联操作，该操作的作用是赋予应用访问表的权限，同样的，我们可以通过解除关联操作撤销应用访问表的权限 在应用鉴权方式部分，我们需要配置应用访问结构化数据存储的登录鉴权方式，若希望使用OAuth登录鉴权，那么需要我们注册所使用的OAuth鉴权应用的AppID，若希望使用自己的登录服务器，那么需要勾选上使用自有服务器登录。还有一点重要说明：若我们选择了多种登录鉴权方式，用户的私有数据是隔离的，因为我们没有办法区分新浪微博用户和小米帐号用户是同一个人。 ? 3 开发指南 3.1 数据模型 3.1.1 表 创建表时需要指定表名、属性列表、主键和表的类型及访问方式。表名可以包含字符a-z, A-Z,0-9，‘_’，并且已字母或下划线开头，最大长度为64个字符。表的分为公共表和用户表两种。 公共表：可以用于存储一个应用中所有用户都可以访问的公共数据，可以通过访问方式指定公共表是否允许用户读写数据，公共表支持的访问方式有：匿名读属主写、登录读属主写、匿名读登录写和登录读登录写 用户表：可以用于存储用户相关的私有数据，用户表仅支持登录读登录写，只有登录用户才能读写该应用中属于用户自己的数据。 3.1.2 属性和主键 数据存储单元由主键和属性，主键类似于一个map对象中的key，属性为value。主键和属性均由一组键值对组成，区别在于主键元素会按照我们创建表时指定的顺序进行存储。需要强调的是，主键的顺序非常重要，因为在scan操作时，可以根据部分主键进行前缀匹配查询，比如，(key1=’a), (key1=’a, key2=’b), (key1=’a, key2=’b, key3=’c), (key1=’a, key2=’b, key3=’c, key4=’d)均是可以正确匹配期望的数据，(key2=’b)，(key2=’b, key3=’c, key4=’d)等因不满足前缀匹配而不能匹配到数据。因此，在创建表的主键时，我们需要根据可能需要的查询方式合理的设置主键的顺序。主键与属性的存储形式如下图所示： 3.1.3 数据类型 主键和属性元素值的类型可以是下面之一： 布尔类型：BOOL 整数类型：INT8, INT16, INT32, INT64 浮点数类型：FLOAT, DOUBLE 字符串：STRING，限制：STRING类型的值中不能包含\0字符 二进制：BINARY 3.1.4 条件 结构化数据存储支持在访问数据条件过滤。条件作用在属性值上，返回的一个布尔值。支持的操作符有：EQ（等于）、NE（不等于）、GT（大于）、GE（大于等于）、LT（小于）、LE（小于等于）。多个条件可以通过逻辑运算符组合成复杂条件表达式，支持的逻辑运算符有：AND、OR。后面会详细介绍如何在SDK中使用条件。 3.2 登录鉴权 结构化数据存储支持应用通过两种方式进行登录鉴权。 使用OAuth服务登录鉴权。目前已支持的有小米、新浪、腾讯开放平台和人人的OAuth帐号服务，开发者需要在管理平台应用配置界面上配置OAuth提供方的应用ID； 使用应用自己的服务器颁发token进行登录鉴权。流