|
|
(未显示6个用户的220个中间版本) |
第1行: |
第1行: |
− | '''使用说明'''
| |
| | | |
− | 1.请先了解名词意义: “位置数据表(geotable)”、 “自定义扩展列(column)”、“位置数据(poi) ”概念的意义,更有助于开发。
| |
− |
| |
− | 2.云存储接口功能:支持单个geotable亿级数据及数百G大小的存储,每天支持百万量级读写,每秒支持万量级读写。
| |
− |
| |
− | 3.批量操作说明:
| |
− |
| |
− | V2版本,引入“批量操作”概念。通过批量操作接口操作,您可实现对一个位置数据表(geotable)进行如下操作:
| |
− |
| |
− | 批量上传多条数据;
| |
− | 批量删除多条数据;
| |
− | 批量删除1个或者多个自定义扩展列(column);
| |
− | 批量更新数据(如字段、字段属性、字段对应的值等)等操作<br/>
| |
− | '''“批量操作”接口原理及使用说明如下:'''
| |
− |
| |
− | “批量操作”接口是采用异步服务形式,您可使用此接口对一个位置数据表(geotable)同时执行各种批量操作,服务将在并发数范围内同时处理多个请求任务,超出并发数的请求任务将以消息队列形式进入处理等待状态。<br/>
| |
− | 当您使用批量操作接口时,服务将先发送批量操作请求,若请求成功,系统将锁定对应的位置数据表(geotable),即用户可对此表进行可读操作,不能进行任何写操作,直到此次批量操作任务完成(即任务进度状态码Status = 3 完成时)自动解锁,恢复可写。同时,系统会返回状态码Status =21和此操作(Job id),Status值用于标识您的操作为批量操作, Job id用于查询此批量操作的任务进度。(Status = 0 表示非批量操作的普通操作)。
| |
− | 查询某个批量操作任务进度,即根据上述返回的Job id,使用批量操作任务查询进度接口进行查询。根据返回的任务进度状态码值(1、2、3)确认批量操作的进度(新增操作,消息队列中等待处理;正在处理;完成)。
| |
− | ==云存储字段定义方式==
| |
− | ===位置数据表(geotable)实体字段定义===
| |
− | {|
| |
− | !colspan="4" |geotable 字段说明
| |
− | |-
| |
− | |字段名称
| |
− | |字段含义
| |
− | |类型
| |
− | |备注
| |
− | |-
| |
− | |id
| |
− | |id,记录唯一的标识
| |
− | |uint32 |
| |
− | |-
| |
− | |geotype
| |
− | |geotable包含的数据类型,包含点、线、面三种类型
| |
− | |uint32
| |
− | |1:点;2:线;3:面。默认为1(当前只<br/>支持点)
| |
− | |-
| |
− | |modify_time
| |
− | |记录最后一次被修改的时间
| |
− | |datetime
| |
− | |
| |
− | |-
| |
− | |create_time
| |
− | |记录被创建的时间
| |
− | |datetime
| |
− | |
| |
− | |-
| |
− | |user_id
| |
− | |创建此记录的用户标识
| |
− | |uint64
| |
− | |
| |
− | |}
| |
− | ===1.2 自定义扩展列(column)实体字段定义===
| |
− | {|
| |
− | !width="100"|字段名
| |
− | !含义
| |
− | !width="80"|类型
| |
− | !width="60"|是否必须
| |
− | !width="50"|默认值
| |
− | !备注
| |
− | |-
| |
− | |id || 唯一标识 || uint64 || 是 || 无 ||
| |
− | |-
| |
− | |key || 存储在geotable<br/>的key标识 || string(64) || 是 ||无 || 在同一geotable内唯一正则:[a-zA-Z][0-9a-zA-Z_]*
| |
− | |-
| |
− | |name || 对key的描述 || string(128) || 否 || 无 ||
| |
− | |-
| |
− | |type || 字段类型 || int32 || 是 || 无 || 1:Int64, 2:double, 3:string, 4:在线图片url,LBS图片存储
| |
− | |-
| |
− | |max_length || 最大长度 || int32 ||否 ||无 ||1,针对String是必须<br/>2,最大值不超过2048
| |
− | |-
| |
− | |default_value ||默认值 ||string(32) ||否 ||无 ||1,如果此列被设置成排序筛选字段,则default_value必须进行设置.否则默认为0
| |
− | |-
| |
− | |is_sortfilter_field ||是否将字段设置为云检索时的排序筛选字段 ||uint32 ||是 || ||1代表是,0代表否。设置后效果详见http://developer.baidu.com/map/lbs-geosearch.htm#.search.nearby 最多只能设置15个
| |
− | |-
| |
− | |sortfilter_id ||排序筛选字段id ||uint32 ||否 || ||1-15,在同一geotable内不能重复.
| |
− | |-
| |
− | |is_search_field ||是否设置为检索时的文本检索字段 ||uint32 ||是 || ||1代表是,0代表否。设置后可根据对该字段的内容要求进行检索<br/> 只能针对String类型的字段,最大<br/>设置大小不超过2048,最多不超过4个
| |
− | |-
| |
− | |is_index_field ||是否将字段设置为索引字段。 ||uint32 ||否 || || 1代表是,0代表否。设置后可实现方便快速查询。最多设置2个 <br/>注:is_index_field=1 时才能在根据该列属性值检索到数据,设置后对应功能: http://developer.baidu.com/map/lbs-geodata.htm#.column.manage3.2
| |
− | |-
| |
− | |is_unique_field ||是否将字段设置为唯一索引字段。 ||uint32 ||否 || ||1代表是,0代表否。设置后方便更新,删除,查询。最多设置1个
| |
− | |-
| |
− | |create_time ||创建时间 ||uint32 ||是 || ||Unix时间戳
| |
− | |-
| |
− | |modify_time ||修改时间 ||uint32 ||是 || Unix时间戳
| |
− | |}
| |