国家标准 GB/T32908一2016 非结构化数据访问接口规范 Unstructureddataaecessinterfaeespeeifieationm 2016-08-29发布 2017-03-01实施国家质量监督检验检疫总局发布国家标准化管理委员会国家标准
GB/I32908一2016 目次前言范围术语和定义缩略语查询语言访问接口 4.1概述 4.2基本格式 4.3数据库连接接口 4.4执行查询语句接口 4.5批量执行查询语句接口 4.6结果集接口应用程序访问接口 1C 5.1概述 10 5.2基本格式 10 5.3集群配置管理接口模块 10 10o 5.3.I概述 5.3.2集群管理接口 10 11 5.3.3单个节点管理接口 5.3.4集群监控接口 12 13 5.3.5数据空间管理接口 1" 5.4任务管理接口模块 1" 5.4.1概述 1" 5.4.2任务状态 5.4.3任务接口 5.4.4 -致性控制接口 l9 20 5.5存储接口模块 20 5.5.1概述 20 5.5.2底层存储对象类型 21 5.5.3存储对象定义接口 22 5.5.4存储对象访问接口 24 5.5.5非结构化数据访问接口 33 5.6分析接口模块 33 5.6.1概述 --.- 33 5.6.2基本数据分析接口 34 5.6.3时间单位 35 5.6.4时序数据分析接口 5.7 35 索引接口模块
GB/T32908一2016 35 5.7.1概述 35 5.7.2通用向量接口 36 5.7.3特征抽取接口 39 5.7.4通用索引接口 42 5.8搜索接口模块 42 ? 5.8.1概述 42 5.8.2媒体数据类型 4" 5.8.3高维数据查询接口 4" 5.8.4关键字查询接口 Web服务访问接口 6.1概述 6.2基本格式 6.3HTTP请求格式 45 6.4HTTP状态码 6.5服务接口描述 45 6.5.1数据增加接口 45 6.5.2数据删除接口 46 6.5.3数据更新接口 46 6.5.！数据查询接口 48
GB/T32908一2016 前言本标准按照GB/T1.1一2009给出的规则起草请注意本文件的某些内容可能涉及专利本文件的发布机构不承担识别这些专利的责任本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口本标准起草单位:清华大学、电子技术标准化研究院,浙江大学、北京航空航天大学、人民大学本标准主要起草人:王朝坤,王建民、陈俊,高林,吴新松,刘贤刚、卫风林、李莹,庄越挺、,陈岭,那健、孙建伶、马殿高、郎波杜小勇,陈晋川. m
GB/I32908一2016 非结构化数据访问接口规范范围本标准规定非结构化数据管理系统的访问接口要求,包括查询语言访问接口、应用程序访问接口和 web服务访问接口本标准适用于非结构化数据管理系统产品的研制,开发和测试术语和定义下列术语和定义适用于本文件 unstructureddata 非结构化数据没有明确结构约束的数据,如文本,图像,音频视频等 2.2 非结构化数据管理系统unstrctureldatamanagementsystem 对非结构化数据进行管理,操作的大型基础软件,提供非结构化数据存储、特征抽取、索引和查询等管理功能缩略语下列缩略语适用于本文件 HrTP,超文本传输协议(hypertex ocol translerprotG JsON:JavaSeript对象标记(jia avascriptobjeet notation XML;可扩展置标语言(extensiblemarkupLanguage 查询语言访问接口概述本章描述查询语言访问接口,包括数据库连接接口、执行查询语句接口,批量执行查询语句接口和结果集接口 4.2基本格式查询语言访问接口包含以下5种元素 a)接口名;接口的名称; b)说明;对接口内容的描述继承;指明了该接口的父接口; c 属性:该接口全部的属性变量; 方法:该接口提供的所有函数的声明 e
GB/T32908一2016 4.3数据库连接接口接口名:Conneetionm 说明;数据库连接的接口继承;无属性;无方法 StatementcreateStatement( 说明:创建一个Statement对象参数;无返回:Statement对象 PreparedStatementprepareStatement(inStringql 说明;根据声明语句ql创建一个Preparedstatement对象参数;q为查询语句声明,其中允许含多个“?”占位符返回:PreparedStatemment voidcommit( 说明:将自上次提交或回滚之后的更新数据提交,并释放当前连接占用的资源参数;无返回:无 voidrollback( 说明;撤销自上次提交或回滚之后的更新操作,并释放当前连接占用的资源参数:无返回:无 oidrolback(inSavepointsp 说明:撤销自保存点sp之后的更新操作,并释放当前连接占用的资源参数;sp为保存点实例对象返回;无 boolisAutoCommit( 说明:获取当前连接是否为自动提交参数;无返回:是否自动提交 voidsetAutoCommit(inboolauto 说明设置当前连接的自动提交属性参数;auto为是否自动提交返回:无
GB/T32908一2016 SavepointsetSavepoint( 说明;设置当前时刻的一个保存点,并获取它参数;无返回:当前时刻的保存点 voidreleaseSavepoint(inSavepointsp) 说明释放保存点p占用的资源参数sp为保存点实例对象返回:无 voidclose( 说明:关闭当前连接参数;无返回;无 boolisClosed( 说明:当前连接是否已关闭参数;无返回:是否关闭 4.4执行查询语句接口接口名:Statement 说明执行查询语句的接口继承:无属性:;无方法: ResultSetexeeuteQuery(inStringql 说明执行数据查询语句参数:q为数据查询语句返回;查询结果对象ResultSet teUpdate(inStringql inteXecut 说明执行数据更新语句,如插人、删除、更新等参数:ql为数据更新语句返回;此次操作影响的行数 boolexecuteinStringql 说明执行语句q 参数为待执行的语句返回:执行是否成功
GB/T32908一2016 nmntectiongeComnectionO) 说明:获取当前的数据库连接参数;无返回:数据库连接 ResultSetgetResultSet( exccte方法执行后执行此方法说明:获取结果集对象ResultSet,通常在e 参数;无返回;结果集对象 intgetFetchSize() 说明;获取从查询结果中提取的缓存的行数参数;无返回;缓存行数 voidsetFetchSize(inintrows 说明:设置查询结果缓存行数参数;rows为缓存行数返回;无 voidclose( 说明;关闭当前Statement对象参数;无返回;无 boolisClosed() 说明:获取当前Statement是否已关闭参数;无返回;是否已关闭 4.5批量执行查询语句接口接口名.Prepardsue tatement 说明:执行查询语句的接口,支持批量查询继承Statement 属性;无方法: voidclearParameters( 说明清空所有PreparedStatement的参数值参数;无返回:无
GB/T32908一2016 voidsetBinaryStream(in ntindex，inIStreamis) 说明设置语句中第index个占位符的值为输人流is 参数:index为占位符的位置,is为输人流(引用,指针等) 返回;无 voidsetBlob(inintindex，inBobblob 说明;设置语句中第index个占位符的值为大对象blob 参数index为占位符的位置,blob为大对象返回:无 voidsetByteArray(inintindex，inByteArrayba) 说明;设置语句中第index个占位符的值为字节数组ba 参数index为占位符的位置,ba为字节数组返回;无 voidsetBoolinintindex，inboolb 说明;设置语句中第index个占位符的值为布尔值b 参数index为占位符的位置,b为布尔值返回;无 voidsetByte(inintindex，inbyte 说明;设置语句中第index个占位符的值为单字节数b 参数;index为占位符的位置,b为单字节数返回;无 voidsetDateTime(inintindex，inDateTimedatetime 说明;设置语句中第index个占位符的值为时间datetime 参数index为占位符的位置,datetime为时间返回;无 voidsetDate(inintindex，inDatedate 说明设置语句中第index个占位符的值为日期date 参数;index为占位符的位置,date为日期返回;无 voidsetDecimal(inintindex，inDecimaldec) 说明;设置语句中第index个占位符的值为Decimal数据参数index为占位符的位置.,dee为Deimal数据返回:无 voidsetDouble(inintindex，indoubled 说明设置语句中第index个占位符的值为双精度浮点数d. 参数;index为占位符的位置,d为双精度浮点数返回无
GB/T32908一2016 void etFloa(imn intindex，inloat) 说明:设置语句中第index个占位符的值为单精度浮点数f 参数;index为占位符的位置，为单精度浮点数返回;无 voidsetlnt(inintindex，ininti) 说明;设置语句中第index个占位符的值为整型数i 参数:index为占位符的位置，为整型数返回:无 voidsetlong(inintindex，inlongl 说明;设置语句中第index个占位符的值为长整型数1 参数;index为占位符的位置，l为长整型数返回;无 roidsetString(inintindex，inString str 说明设置语句中第index个占位符的值为字符串str 参数:index为占位符的位置,str为字符串返回;无 roidsetURI(inintindex，inURIuri) 说明;设置语句中第index个占位符的值为UR1类型数据参数;index为占位符的位置,uri为UR1类型数据返回:无 roidsetVector(inintindex，inIVectorObject vec 说明;设置语句中第index个占位符的值为向量类型数据参数;index为占位符的位置,vec为向量类型数据返回:无 ResultSetexecuteQuery rredStatement执行说明:执行PreparedStatement对象包含的q查询语句,此处的Prepar 的是查询操作,不涉及数据的更改参数;无返回;数据查询执行结果的ResultSet对象 intexecuteUpdate( 说明;执行PreparedStatement对象包含的q数据更新语句,此处的PreparedStatement 执行的是数据的更新操作参数:无返回:此次操作关联的行数
GB/T32908一2016 4.6结果集接口接口名;ResultSet 说明;查询结果集接口,是查询方法返回的结果的统一表示继承;无属性;无方法 boolabsolute(inintrows 说明:将指针移到第rows行,从第rows行开始读取数据参数;rows为开始读取的行序号返回:指针移动是否成功 boolbeforeFirst() 说明将指针移到第1行数据之前,即ResultSet数据最起始的地方参数;无返回指针移动是否成功 boolafterlas(O 说明:将指针移到第末行数据之后,即ResultSet数据最末尾的地方参数;无返回:指针移动是否成功 boolnext( 说明;移动指针到当前行的下一行参数:无返回:移动是否成功 boolprevious(O 说明移动指针到当前行的前一行参数;无返回移动是否成功 IStream gelBhnarystream(imString key) 说明:从key对应的位置获取输人流对象参数:key为属性的键返回;输人流对象(引用、指针等) BlobgetBlob(inStringkey 说明;从key对应的位置获取大对象参数;key为属性的健返回:大对象
GB/T32908一2016 ByteArraygetByteArray(inStringkey 说明,从ke对应的位置获取字节数组参数;key为属性的键返回;字节数组 boolgetBoolinStringkey 说明:从key对应的位置获取布尔值参数;key为属性的键返回:布尔值 bytegetByte(instringkey 说明;从key对应的位置获取单字节值参数;key为属性的键返回;单字节值 DateTimegetDateTime(inStringkey 说明:从key对应的位置获取时间数据参数;key为属性的健返回,时间数据 DaegetDae(insirngken) 说明;从key对应的位置获取日期数据参数;key为属性的键返回;日期数据 DeeimalgetDecimal(inStringkey 说明;从key对应的位置获取Deeimal数据参数:key为属性的键返回:Decimal数据 doublegetDouble(inStringkey) 说明:;从key对应的位置获取双精度浮点数值参数;key为属性的键返回;双精度浮点数值 floatgetFloat(inStringkey 说明:从key对应的位置获取单精度浮点数值参数;key为属性的健返回;单精度浮点数值 intgetlnt(inStringkey 说明;从key对应的位置获取整型数值参数;key为属性的键返回:整型数值
GB/T32908一2016 longel.ong(Ginsiringkey) 说明;从key对应的位置获取长整型值参数;key为属性的键返回:长整型值 StringgetString(inStringkey 说明;从key对应的位置获取字符串参数:key为属性的键返回字符串 URlgetURI(inStringkey 说明:从key对应的位置获取URI对象参数;key为属性的键返回;URI对象 IVector(ObjectgetVector(inStringkey 说明:从key对应的位置获取向量对象参数;key为属性的键返回;向量对象 !getFetchsie int 说明:获取从查询结果中提取的缓存的行数参数;无返回:缓存行数 voidsetFetchSize(inintrows 说明设置查询结果缓存行数参数;rows为缓存行数返回;无 statementgetsStatement 说明;获取当前ResultSet对象对应的Statement对象参数;无返回:Statement对象 voidclose(G 说明;释放当前ResultSet对象的资源参数;无返回;无
GB/T32908一2016 boolisClose( 说明;查看当前ResultSet对象的资源是否已经释放参数;无返回:资源是否已释放应用程序访问接口 5.1 概述本章描述非结构化数据管理系统各个模块中的访问接口,本章包含集群配置管理接口模块、任务管理接口模块、存储接口模块、分析接口模块、索引接口模块和搜索接口模块 5.2基本格式应用程序访问接口包含了以下5种元素 a)接口名;接口的名称,符号“:”之前的为模块名,模块名是按功能类型对接口进行分组后的组名 b)说明;对接口内容的描述; c)继承:指明了该接口的父接口; d)属性;包含了该接口全部的属性变量; 方法:包含了该接口提供的全部功能函数的声明,是接口的核心内容 e 5.3集群配置管理接口模块 5.3.1概述模块名;udms_management 说明;与集群配置管理相关的模块,包括了访问、控制集群,及其配置信息的所有接口该模块的使用对象为分布式非结构化数据访问系统,而对集中式系统而言,无需考虑该模块 5.3.2集群管理接口 ;lIClu rsMam 接口名;udms_managementa usters anagement 说明控制整个集群的接口,包括集群的启动、关闭、查看等继承;无属性;无方法: voidload( 说明导人集群节点信息,节点信息存储在缺省的路径下参数;无返回:无 oid startup() 说明启动集群,开始工作参数;无 10o
GB/T32908一2016 返回:无 oidshutdown( 说明:关闭集群,停止服务参数;无返回:无 MapListgetClustersInfoO) 说明:查看集群各节点的信息参数;无返回集群节点信息列表 MapgetNodelnfo(inintnodeld) 说明.查看单个节点信息参数;nodeld为节点的id 返回;节点信息列表 intaddNode(inNodenode 说明;向集群中动态添加新的节点参数;node为待添加的节点对象返回;新添加节点在集群中的id boolremoveNode(inintnodeld 说明;删除集群中的某个节点参数;nodeld指定待删除的节点返回节点删除是否成功 boolpingAlive(inStringhostaddr) 说明:查看某节点是否在正常工作参数;hostaddr为待检测的节点的地址返回:节点是否工作正常 5.3.3单个节点管理接口接口名;udms_management::INodeManagement 说明;控制集群中单个节点的接口,如单个节点的启动,关闭、修复等继承;无属性: 名称:node 定义:publieNodenode 说明:当前节点的对象方法: boolcommission( 11
GB/T32908一2016 说明:启动或重新启动当前节点的对外服务参数;无返回;是否成功 booldecommission( 说明解除当前节点的对外服务参数;无返回:是否成功 boolshutdown( 说明:关闭当前节点参数;无返回:是否成功 boolrepair( 说明;对节点上备份的数据进行错误恢复,保证节点持有最新版本的数据,以确保一致性参数:无返回;是否成功 boolflush( 说明停止接受写操作,将全部缓存的数据写人磁盘参数;无返回;是否成功 5.3.4集群监控接口接口名;udms_managenment:;lClustersMonitor 说明;监控集群运行情况的接口继承;无属性;无方法 JSONmonitorHardwareRes(O 说明:监控集群的硬件资源的使用情况参数;无返回:以JSON封装的集群硬件资源信息 JSONmonitorClustersConditionsO) 说明:监控集群的运行时参数参数;无返回:以JSON封装的集群运行时参数的信息 voidwriteToLogO 说明将监控数据写人日志 12
GB/T32908一2016 参数:无返回;无 voidcleanup( 说明清理监控数据日志参数;无返回:无 5.3.5数据空间管理接口 5.3.5.1表空间管理接口接口名;udms_managenment::IKeyspaceManagenment 说明;管理表空间的接口此处的表空间对应于关系型数据库中的数据库实例继承;无属性:无方法 List tgetkeypaeceNamelisto 说明;获取表空间的名称列表参数;无返回:表空间的名称列表 ksName ISsiring MapgetKeyspaceProperties(in 说明:获取表空间的配置参数和运行参数参数;ksName为表空间的名称返回:表空间的配置参数和运行参数 boolcreatekeyspace(inStringksName，inintbackup，inBackupStrategybks，inStringop tions) 说明;创建新的表空间参数;ksName为新的表空间的名称,backup为数据备份数,bks为数据备份的策略， options为备份选项返回:新的表空间是否创建成功 booldropKeyspace(inStringksName 说明;删除已有的表空间参数;ksName为待删除的表空间的名称返回;表空间是否删除成功 nsStringop oolupdateKeyspace(inStringksName，inintbackup，inBackupStrategybks， tions) 说明:更新表空间的信息参数:ksName为表空间的名称,backup为数据备份数,bks为数据备份的策略,options 13
GB/T32908一2016 为备份选项返回表空间是否更新成功 booluseKe se(inStringksName) eyspace 说明;使用指定的表空间参数:ksName为待使用的表空间的名称返回;表空间是否使用成功 5.3.5.2表管理接口接口名;udms_management:;ITableMan nagenment 说明,管理表各项操作的接口,如创建、更新、删除,查询表等继承:无属性;无名称:kspace 定义;pmbicKeySpaecekspace 说明当前所处的表空间的名称方法 LisgetTableNameList(O 说明:获取当前表空间内所有表的名称列表参数;无返回:表的名称列表 MapgetTableProperties(inStringtableName) 说明;获取表的配置参数,运行参数和索引信息参数;tableName为表的名称返回:表的配置参数、运行参数和索引信息 oolcreateTable(inStringtableName.optionalinTableTypettype optionalinComparatorTypectype optionalinfloatrowCache optionalinintrowTTL optionalinfloatkeyCache， ptionalinintkeyTTL optionalinfloatreadRepairFreq reeyecleFreq oDtionalinint optionalinComparatorTypevtype optionalinintminCompactTime eTime) optionalinintmaxCompact！说明:创建新的表参数:tableName为新的表的名称,其他可选参数包括 TableTypettype为表的类型; ComparatorTypectype为比较器类型， 14
GB/T32908一2016 floatrow wCache为行缓存大小 introwTT为行缓存保存时间 loatkeyCache为关键字缓存大小; intkeyTTI.为关键字缓存保存时间; loatreadRepairFreq为读修复几率 iintrecycleFreq为垃圾收集频率; 为验证器类型 ComparatorTypevtype inminCompacTime为最小压缩时间 intmaxCompactTime为最大压缩时间返回;新的表是否创建成功 loolupdateTable(inSiringtableName，optionalinTableTypettype. optionalinComparatorTypectype, oprtionalnloatt rowCache， optionalinintrowTTL optionalinfloatkeyCache, optionalinintkeyTTL optionalinfloatreadRepairFreg optionalinint recycleFreq inComparatorTypevtype, optional optionalinintminCompactTime， optionalinintmaxCompactTime 说明;更新表参数参数:tableName为表的名称,其他可选参数包括 TableTypettype为表的类型; ComparatorTypectype为比较器类型 loatrowCache为行缓存大小 introwTTL为行缓存保存时间， loatkeyCache为关键字缓存大小 keyTTI为关键字缓存保存时间 int floatreadRepairFreq为读修复几率; intreeycleFreq为垃圾收集频率; ComparatorTypevtype为验证器类型; intminCompactTime为最小压缩时间 intmaxCompactTime为最大压缩时间返回:表是否更新成功 ooldropTable(inStringtableName) 说明:删除已有的表参数;tableName为待删除的表的名称返回:表是否删除成功 15
GB/T32908一2016 oolemptyTable(inStringtableName' 说明;清空指定的表参数;tableName为待清空的表的名称返回:表是否清空成功 5.3.5.3列管理接口接口名:udms_management::IColumnManagement 说明管理列各项操作的接口,如增加,更新、删除,查询等继承;无属性: 名称;table 定义:publicTabletable 说明:当前列所在的表的对象方法: ListgetColumnNameList(G) 说明获取当前表内所有列的名称列表参数;无返回;列的名称列表 MapgetColumnProperies(inStringcolName) 说明:获取列的信息参数:colName为列的名称返回:列的信息 boolereateColumn(inStringcolName，inComparatorTypectype' 说明:添加新的列参数;coIName为新的列的名称，ctype为比较器类型返回:新的列是否添加成功 booldropColumn(inStringcolName) 说明;删除一个列参数:colName为待删除的列的名称返回:列是否删除成功 boolupdateColumn(inStringcolName，inComparatorTypectype' 说明;更新列参数:colName为待更新的列的名称,ctype为比较器类型返回:是否更新成功 16
GB/T32908一2016 5.4任务管理接口模块 5.4.1概述模块名:udms_tasks 说明:定义任务管理基本要素及操作的模块 5.4.2任务状态任务状态名:udms_tasks;TaskStatus 类型;枚举类型,取值可为: Preparing,任务准备中,尚不能被执行; Prepared,任务准备完毕,待执行; InAetion,正在执行中的任务; Completed,任务已执行完毕; Aborted,任务被终止 5.4.3任务接口接口名:udmstasks::ITask 说明;任务在系统中的统一表示继承:无属性名称;tid 定义;pbicStrimg" tid 说明:任务的标示符名称;:title 定义:publicStringtitle 说明:任务的名称名称:descC 定义:publicStringdesc 说明;任务的描述信息名称;timestamp 定义:;publielongtimestamp 说明;任务最近一次被更新的时间戳名称:status 定义;pubieTaskstatu usstatuS 说明:任务的状态名称:priority 定义:publici intpriority 17
GB/T32908一2016 说明:任务的优先级名称:parent 定义:publicITaskparent 说明当前任务的父级任务名称:childrer ectedITaskListchildren 定义:prot 说明当前任务的子级任务列表方法: voidschedule( 说明;调度该任务,并递归调度其子任务参数:无返回;无 voidexecute( 说明;执行当前任务,并递归执行其子任务参数;无返回;无 voidabort( 说明;终止并放弃当前任务参数;无返回;无 voidcleanup( 说明清空子任务列表中所有状态为Completed的子任务参数;无返回:无 voidaddChildinITaskchild) 说明;添加一个子任务参数:child为子任务返回;无 voidaddChildinITaskchild，intposition) 说明:在指定位置添加一个子任务参数;child为子任务,position为待添加的任务在子任务列表中的位置返回:无 void veChild(inITaskchild removG 说明;删除一个子任务 18
GB/T32908一2016 参数:child为子任务返回;无 voidremoveChild(intposition 说明;删除指定位置的一个子任务参数;position为待删除的任务在子任务列表中的位置返回:无 -致性控制接口 5.4.4 5.4.4.1协调器接口接口名;udms_tasks;;ICoordination 说明;提供统一的对数据和日志的读写操作继承;无属性名称:controller 定义;pubieIVersionControl controller 说明;版本控制器对象方法: boolwrite(inIStorageIDid,inanydata) 说明:对指定的对象执行写操作参数:id为存储对象的唯一标示符,data为待写人的数据返回:写操作是否成功 anyread(inIStorageIDid 说明;对指定的对象执行读操作参数;id为存储对象的唯一标示符返回;最新版本的数据 istgetLogNodeList(inIStorageIDid) 说明:根据数据备份规则计算出给定标示符对应的数据的多个日志存储器参数;id为存储对象的唯一标示符返回日志存储器列表 ListgetDataNodelist(inIStoragelDid 说明根据数据备份规则计算出给定标示符对应的数据的多个数据存储器参数;id为存储对象的唯一标示符返回:数据存储器列表 ydata，inListnodelist) voidwriteTol.ogNode(inIStoragelIDid，inany 说明:将日志和数据写人多个日志存储器中 19
GB/T32908一2016 参数;id为存储对象的唯一标示符,data为待写人的数据,nodelist为日志存储器列表返回:无 voidwriteToDataNode(inIStoragelDid.inanydata，inListnodelist， nLogPositionlp 说明;将数据和日志位置写人到nodelist指定的多个数据存储器中参数;id为存储对象的唯一标示符,data为待写人的数据,nodelist为数据存储器列表,lp 为日志写人位置返回无 5.4.4.2版本控制器接口 S 接口名:udms_tasks::IVersionContrc 说明版本控制器接口主要负责读写数据的版本,以位置Poion表示数据的版本,Poion越高表示版本越新,Position的实现策略不限继承;无属性;无方法 Positionget(inIStoragelDid)y 说明;获取指定对象的最新的日志位置参数;id为存储对象的唯一标示符返回:最新的日志位置 oidupdate(inIStoragelDid，Positionpos) 说明,更新指定的日志写人位登参数;id为存储对象的唯一标示符,pos为用以更新的日志位置返回;无 5.5存储接口模块 5.5.1概述模块名:udmms_store 说明:定义存储对象类型及存储操作的模块 5.5.2底层存储对象类型对象名:udms_store;;StorageType 类型;枚举类型,取值可为: FileID,唯一标识存储系统中的一个文件对象; FolderlD,唯一标识存储系统中的一个文件夹对象; TablelD,唯一标识存储系统中得一个表对象; RowID,唯一标识存储系统中表的一行 columnlD,唯一标识存储系统中表的一列心
GB/T32908一2016 5.5.3存储对象定义接口接口名:udms_store:;IStoragelD 说明:存储对象在系统中的统一表示继承:无属性:无方法 IStoragelDconstructFileID(inStrir ingpath) 说明;定义一个FileID对象参数;path为文件的存储路径返回:底层存储对象ID IStoragelIDconstructFolderID(inStringpath) 说明;定义一个FolderID对象参数:path为文件夹的存储路径返回;底层存储对象ID IStorageIDconstructTablelD(inStringtableName，inStringkeySpace) 说明;定义一个TablelD对象,标识一个表参数;tableName为表的名称,keyspace表示表空间名称返回;底层存储对象ID StoragelDconstructRowlD(inStringrowKey，inStringkeySpace) 说明;定义一个RowID对象,标识表的一行参数:rowKey为行键,keySpace为表空间的名称返回;底层存储对象ID IStorageIDconstructColumnID(inStringcolName，inStringkeySpace，inStringrowKey) 说明:构造一个ColumnID对象.标识表空间中的一列参数;colName为列的名称,keySpace为表空间的名称,rowKey为行键返回:底层存储对象ID storageTypegetIDType(O) 说明;获得当前IStoragelD的类型参数;无返回底层存储对象的类型 StringgetFilePath() 说明:获得文件路径,只有FilelD类型的IStoragelD才能够访问,其他类型的IStorageID 访问会抛出异常参数;无返回;文件路径 21
GB/T32908一2016 StringgetFolderPath() 说明:获得文件夹路径,只有FolderID类型的1StoragelID才能够访问,其他类型的1Stor agelD访问会抛出异常参数;无返回:文件夹路径 StringgetTableName( 说明:返回表的名称,只有TableID,ColumnFamilyID,RowID,ColumnlD类型的IStor agelD才能够访问,其他类型的IStoragelID访问会抛出异常参数;无返回:表名称 StringgetColumnName(O 说明;返回列的名称,只有ColumnD类型的IStoragelD才能够访问,其他类型的IStor ageID访问会抛出异常参数;无返回;列名称 getRowKeyC) String 说明;返回一个行的ID,只有ColumnFanmilylD,ColumnlD,RowID类型的IStoragelD才能够访问,其他类型的IStorageID访问会抛出异常参数;无返回行ID 5.5.4存储对象访问接口接口名;udms_store;;IStorageAccess 说明;定义了访问存储对象的基本操作继承;无属性;无方法 oolcreate(inIStoragelIDid) 说明创建一个存储对象,该方法仅支持对文件夹FolderlID和表TablelID的创建参数id为存储对象定义的ID 返回;创建是否成功 boolremove(inIStoragelDid) 说明;删除一个存储对象参数.id为存储对象定义的ID 返回;删除是否成功 boolremove e(inIStoragelIDListidList) 说明批量删除文件心
GB/T32908一2016 参数:idList表示存储对象的列表返回:无 oidput(inIStoragelIDid，inStringlocalpath) 说明:上传本地文件或文件夹参数localpath为本地文件或文件夹的路径,id为存储对象返回;无 lpu(inIsorageIDd. void inByteArr values，inbool lapend rray 说明;使用字节数组上传文件或列,如果id表示上传的列,则应保证其对应的keySpace、 columnFamily存在，否则会抛出siorsgeE:xceprtion异常,上传数据大小不能超过文件块的上限,文件块大小在配置文件中指定参数;value为上传的列的内容,或文件内容,d为使用StorageID包装的远程文件系统的路径.ppend为布尔类型.当append为re时,数据漆加在已有的列或文件的术尾,不删除已有的列或文件的数据;当append为false时,添加的数据将覆盖已有的列或文件返回:无 voidput(inIStoragelIDListidL.ist，inByteArrayListlist，inbool lappend 说明;批量使用字节数组上传文件或列,如果idList表示上传的列的列表,则应保证其各自对应的keySpace.ColumnFamily存在,否则会抛出StorageException异常.上传数据大小不能超过文件块的上限,文件块大小在配置文件中指定参数,dli表示远醒文件系统对应的对象的列表,i计为文件字节数组列表.ppwnd为布尔类型,当appemd为tre时,数据舔加在已有的列或文件的末尾,不制除已有的列或文件的数据;当append为false时,添加的数据将覆盖已有的列或文件返回:无 voidget(inIStoragelIDid，inStrniglocalpath 说明:下载文件或文件夹到本地参数;id表示文件或文件夹的存储对象,localpath表示本地路径返回;无 ByteArayget(inIStoragelDid 说明:获取列内容的字节数组参数id表示列的存储对象返回;列的字节数组 ByteArrayListget(in1StoragelIDListidList) 说明批量获取列内容的字节数组参数;idList表示列存储对象的列表返回:含多个列对象字节数组的列表 23
GB/T32908一2016 UploadsireampuusStream(inISorngelDid，inboolapend 说明;以数据流的方式上传列或文件,UploadStream是数据输出流的子类,提供以流的形式上传列和文件的方法如果id为列对象,则调用该方法时,需保证id对应的 leyspace和ColumnFamily存在,否则会抛出SorageException异常文件或列在上传结束后续执行lush方法将本地缓冲中的数据发送到服务器,如果上传的文件占用的内存比较大,在上传结束后需执行cdose方法,释放占用的内存资源参数id为待上传的列或文件对象,append为布尔类型,当append为true时,数据添加在已有的列或文件的末尾,不删除已有的列或文件的数据;当append为false时,添加的数据将覆盖已有的列或文件返回:上传的输出流对象 DownloadStreamgetStream(inIStorageIDid 说明:以流的方式下载列或文件,若下载的是列数据,则需保证id对应的keySpace ColumnFanmily存在,否则会抛出storageException异常 DownloadStream为数据输人流的子类,提供以流的形式下载列和文件的方法参数;id表示待下载的列或文件对象返回:下载的输人流对象 5.5.5非结构化数据访问接口 5.5.5.1图像存储与访问接口接口名:udms_store::ImageAecess 说明;存储及访问图像的接口在系统中,图像对应于lmage类继承;无属性;无方法 oidput(inIStoragelIDid inlmageimg 说明:上传图像数据参数;id表示图像的存储对象,img为图像的实例对象返回;无 roidputAtribute(inIStorigelDid，insirng" key，inanydata 说明:上传图像的元数据参数;id表示图像的存储对象,key为与id关联的图像的属性键,data为属性值返回;无 voidputFeature(inIStorageIDid，inStringkey，inanydata) 说明:上传图像的特征数据参数id表示图像的存储对象,key为与id关联的图像的特征的键,data为特征数据返回无 24
GB/T32908一2016 lmagegetinIStoragelDid 说明:获取指定的图像的实例对象参数;id表示图像的存储对象返回:图像实例 any getAttributeinIStoragelIDid，inStringkey?) 说明:获取指定的图像的属性值参数:id表示图像的存储对象,key为与id关联的图像的属性键返回属性值 anygetFeature(inIStorageIDid.inStringkey) 说明;获取指定的图像的特征数据参数;id表示图像的存储对象,key为与id关联的图像的特征的键返回;特征数据 boolremove inIStorageIDid 说明;删除指定的图像数据参数;id表示图像的存储对象返回:是否成功 boolremoveAttribute(inIStoragelDid，inStringkey 说明;删除指定的图像的属性参数id表示图像的存储对象,key为与id关联的图像的属性键返回:是否成功 oolremoveFeature(inIStoragelIDid，inStringkey) 说明;删除指定的图像的特征参数id表示图像的存储对象,key为与id关联的图像的特征的键返回:是否成功 5.5.5.2视频存储与访问接口接口名udms-storeIvideoAe ccess 说明:存储及访问视频的接口在系统中,视频对应于Video类继承:无属性;无方法: oidput(inIStoragelIDid，inVideovdo) 说明:上传视频数据参数:id表示视频的存储对象,vdo为视频的实例对象返回:无 25
GB/T32908一2016 data) oidputAttribute (inIsioragelDid，insitring" key，inany 说明:上传视频的元数据参数:id表示视频的存储对象,key为与id关联的视频的属性键,data为属性值返回;无 voidpuFeture(inIstorageIDid，instring" key，inany data 说明:上传视频的特征数据参数;id表示视频的存储对象,key为与id关联的视频的特征的键data为特征数据返回:无 vidcoget inIStoragelDid) 说明:获取指定的视频的实例对象参数;id表示视频的存储对象返回:视频实例 tAttribute in1storagelDid，inSstringkey) anygetl 说明;获取指定的视频的属性值参数;id表示视频的存储对象,key为与id关联的视频的属性键返回;属性值 anygetFreture(imISsioregelDdinSirngkey" 说明:获取指定的视频的特征数据参数;id表示视频的存储对象,key为与id关联的视频的特征的键返回:特征数据 boolremoveinISto1 ongelDid 说明;删除指定的视频数据参数;id表示视频的存储对象返回;是否成功 boolremoveAttributeinIStoragelDid，inStri .key) ing 说明;删除指定的视频的属性参数;id表示视频的存储对象,key为与id关联的视频的属性键返回;是否成功 boolremoveFeature (inIStorageIDid，inStringkey 说明;删除指定的视频的特征参数;id表示视频的存储对象,key为与id关联的视频的特征的键返回:是否成功 26

了解非结构化数据访问接口规范GB/T32908-2016

随着互联网的快速发展，非结构化数据的数量不断增加。如何高效地管理和利用这些大量的非结构化数据成为一个亟待解决的问题。

非结构化数据指的是没有固定格式和组织形式的数据，例如电子邮件、文档、图像、音频和视频文件等。这些数据通常以文本的形式存在，但由于缺乏统一的结构，难以被传统的数据库系统所处理。

为了解决这个问题，国家标准化管理委员会发布了《非结构化数据访问接口规范GB/T32908-2016》，旨在为非结构化数据的管理和利用提供技术支持。

什么是非结构化数据访问接口规范GB/T32908-2016？

非结构化数据访问接口规范GB/T32908-2016是由国家标准化管理委员会制定的一项技术标准。该标准为非结构化数据的访问和管理提供了统一的接口规范，使得非结构化数据可以被更加高效地处理。

该标准主要包括三个方面的内容：数据元模型、数据API和数据查询语言：

数据元模型：该模型定义了非结构化数据的数据元素和关系，描述了非结构化数据的存储结构。
数据API：该API定义了对非结构化数据进行操作的接口，包括数据的增删改查等基本操作。
数据查询语言：该语言定义了针对非结构化数据进行查询的语法和规则。

为什么需要非结构化数据访问接口规范GB/T32908-2016？

非结构化数据访问接口规范GB/T32908-2016的出现，主要是为了解决非结构化数据处理的难点问题。

传统的数据库系统只能处理格式固定的结构化数据，而对于非结构化数据的处理却存在很多难点。例如，如何从文本中提取有用信息、如何对图像进行分类、如何对音频进行分析等等。

非结构化数据访问接口规范GB/T32908-2016提供了统一的接口规范，使得不同的应用系统可以通过该标准对非结构化数据进行有效管理和利用。同时，该标准也为非结构化数据的交换和共享提供了便利。

如何使用非结构化数据访问接口规范GB/T32908-2016？

使用非结构化数据访问接口规范GB/T32908-2016，需要遵循以下步骤：

定义数据元模型，包括数据元素和关系等。
实现数据API，包括数据的增删改查等基本操作。
实现数据查询语言，包括查询语法和规则和查询结果的表达方式等。
集成非结构化数据访问接口规范GB/T32908-2016到应用系统中，从而可以对非结构化数据进行有效管理和利用。

需要注意的是，在使用该标准的过程中，要充分考虑不同类型的非结构化数据的特点和实际应用需求。只有根据具体情况进行灵活应用，才能更好地发挥其作用。

总结

非结构化数据访问接口规范GB/T32908-2016是一项重要的技术标准，为非结构化数据的管理和利用提供了统一的接口规范。通过该标准，不同的应用系统可以对非结构化数据进行有效管理和利用，为非结构化数据的交换和共享提供了便利。

在实际应用过程中，需要充分考虑不同类型的非结构化数据的特点和实际应用需求，以便更好地发挥该标准的作用。