ICS35.100.05 L79 中华人民共和国国家标准 GB/T31916.5—2015 信息技术 云数据存储和管理 第5部分:基于键值(Key-Value)的 云数据管理应用接口 Informationtechnology—Clouddatastorageandmanagement— Part5:Key-Valuebasedclouddatamanagementapplicationinterface 2015-09-11发布 2016-05-01实施 中华人民共和国国家质量监督检验检疫总局 中国国家标准化管理委员会发布目 次 前言 Ⅲ ………………………………………………………………………………………………………… 1 范围 1 ……………………………………………………………………………………………………… 2 规范性引用文件 1 ………………………………………………………………………………………… 3 术语、定义和缩略语 1 ……………………………………………………………………………………… 3.1 术语和定义 1 ………………………………………………………………………………………… 3.2 缩略语 1 ……………………………………………………………………………………………… 4 Key-Value数据模型 1 …………………………………………………………………………………… 5 基于Key-Value的云数据管理应用接口通用要求 2 …………………………………………………… 5.1 概述 2 ………………………………………………………………………………………………… 5.2 数据一致性要求 2 …………………………………………………………………………………… 5.3 补充出错信息 3 ……………………………………………………………………………………… 5.4 公共请求头 3 ………………………………………………………………………………………… 5.5 公共响应头 3 ………………………………………………………………………………………… 6 基于Key-Value的云数据管理应用接口定义 3 ………………………………………………………… 6.1 概述 3 ………………………………………………………………………………………………… 6.2 列出账号所有表 4 …………………………………………………………………………………… 6.3 创建表 5 ……………………………………………………………………………………………… 6.4 删除表 6 ……………………………………………………………………………………………… 6.5 获取元数据 7 ………………………………………………………………………………………… 6.6 添加/更新元数据 10 ………………………………………………………………………………… 6.7 插入/更新数据 11 …………………………………………………………………………………… 6.8 删除数据 14 …………………………………………………………………………………………… 6.9 获取数据 16 …………………………………………………………………………………………… 6.10 条件表达式查询数据 19 …………………………………………………………………………… 附录A(规范性附录) 补充出错信息 24 …………………………………………………………………… ⅠGB/T31916.5—2015 前 言 GB/T31916《信息技术 云数据存储和管理》分为六部分: ———第1部分:总则; ———第2部分:基于对象的云存储应用接口; ———第3部分:分布式文件存储应用接口; ———第4部分:基于块的云存储应用接口; ———第5部分:基于键值(Key-Value)的云数据管理应用接口; ———第6部分:分布式关系数据库应用接口。 本部分为GB/T31916的第5部分。 本部分按照GB/T1.1—2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本部分由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。 本部分起草单位:东北大学软件学院、中国移动通信有限公司研究院、中国电子技术标准化研究 院、东软集团、用友软件股份有限公司、上海计算机软件技术开发中心、浪潮(北京)电子信息产业有限公 司、华为技术有限公司、开普互联信息有限公司、华中科技大学、北京邮电大学。 本部分主要起草人:宋杰、杜宇健、王洁萍、蔡立志、余祥、颜秉珩、李海波、何光宇、陈岭、郑峻、田忠、 丁蔚、周可、吴涛、刘建毅、陈志峰、王卫国、丛培勇、杨丽蕴、朱志良。 ⅢGB/T31916.5—2015 信息技术 云数据存储和管理 第5部分:基于键值(Key-Value)的 云数据管理应用接口 1 范围 GB/T31916的本部分给出了键值数据模型,规定了键值的云数据管理应用接口通用要求和接口定义。 本部分适用于基于键值的云数据管理系统的设计、开发和使用。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文 件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T7408—2005 数据元和交换格式 信息交换 日期和时间表示法 GB/T18793—2002 信息技术 可扩展置标语言(XML)1.0 GB/T31916.1 信息技术 云数据存储和管理应用接口 第1部分:总则 RFC2616 超文本传输协议(HTTP)1.1(HypertextTransferProtocolHTTP/1.1) 3 术语、定义和缩略语 3.1 术语和定义 GB/T31916界定的以及下列术语和定义适用于本文件。 3.1.1 基于键值的云数据管理 Key-Valuebasedclouddatamanagement 一种以键值数据模型组织数据,以服务的方式对外提供对键值数据模型中各种数据对象操作的数 据管理方式。 3.2 缩略语 下列缩略语适用于本文件。 ACID 原子性、一致性、隔离性、持久性(Atomicity,Consistency,Isolation,Durability) API 应用程序编程接口(ApplicationProgrammingInterface) BASE 基本可用、软状态、最终一致(BasicallyAvailable,Softstate,EventualConsistency) CURD 创建、更新、读取、删除(Create,Update,Read,Delete) HTTP 超文本传输协议(HypertextTransferProtocol) JSON JavaScript对象标记(JavaScriptObjectNotation) XML 可扩展置标语言(ExtensibleMarkupLanguage) 4 Key-Value数据模型 Key-Value数据模型的组成如图1所示。 1GB/T31916.5—2015 图1 Key-Value数据模型 Key-Value数据模型用来描述实体及其属性。 注1:实体是现实世界中任何可区分、可识别的客观事物、抽象事件,以及事物与事物之间的联系。 注2:属性是实体的特征,一个实体可用若干属性来描述。属性包括属性名和属性值。 Key-Value数据模型的组成元素包括表、行、列和时间戳。表是由行组成的数据集合。每行描述一 个实体。不同的行由不同的行键(R)来唯一标识。行中的数据由三元组(K,V,T)组成。其中,“K”代 表列名,“V”代表列值,“T”代表时间戳。列名描述实体的属性名,列值描述实体的属性值。时间戳用来 标记列值的版本信息。通过三元组(R,K,T)可以唯一地标识实体属性值。 5 基于Key-Value的云数据管理应用接口通用要求 5.1 概述 基于Key-Value的云数据管理应用接口通用要求包括接口协议、身份安全管理、数据一致性要求、 状态码信息描述、补充出错信息、公共请求头、公共响应头和出错信息描述要求8项内容。其中,接口协 议、身份安全管理、状态码信息描述和出错信息描述要求4项内容见GB/T31916.1中相应部分。 5.2 数据一致性要求 云数据管理为保证数据的BASE特性,应满足数据的最终一致性要求。基于Key-Value的云数据 管理宜满足数据强一致性要求。在可用性、容错性占主导时可降低为数据最终一致性要求。 注:数据管理系统存在强一致性和最终一致性两种一致性要求。关系数据库管理系统为保证数据的ACID特性, 应满足数据的强一致性要求。强一致性指在数据更新完成后,任何后续访问都将返回更新过的值;最终一致 性:存储系统保证如果对象没有新的更新,最终(在不一致窗口关闭之后)所有访问都将返回最后更新的值。 ACID的概念引用GB/T17173.1—1997。 2GB/T31916.5—2015 5.3 补充出错信息 基于Key-Value的云数据管理发生的出错响应较为复杂,需要对HTTP(见RFC2616)状态码进 行补充出错信息描述。 补充出错信息描述见附录A。 5.4 公共请求头 公共请求头应包括信息见表1。 表1 公共请求头信息 名称 描述 选择状态 Host 主机信息,如:example.clouddb.cn 必选 Accept text/xml 可选 Content-Type text/xml或*/* 可选 Authorization