非结构化文件转移服务器,非结构化数据管理平台-常见问题FAQ

常见问题指南(FAQ)

1. 请求接口需要在Header中加入Authorization, 该如何生成?

答： 德拓开放平台对所有请求的API要求在Header中加入授权信息，

具体步骤如下：

1,在开发之前首先要确保服务器已经进行了开发授权， 开发授权可以向德拓官方申请， 打开授权页面

http://您的IP地址/devauth , 使用管理员登陆， 可以看到当前机器的机器码， 发给DATATOM

收到一个accesskey.dtlic授权文件，点击【导入授权文件】 即可完成

添加成功后，可以查看自己的 AccessKey, SecretKey 值

2， 接下来，授权生成按照一定的算法计算， 详细参考： 授权接入指南

2. 返回格式支持XML吗？

目前只支持 JSON数据格式

3. 文件数量和单个文件大小有限制吗?

数量没有任何限制， 文件大小受限于设备的存储空间，一般单个物理文件的大小 < 48TB 即可

4. DANA 支持https安全网络连接吗?

DANA支持https网络连接

5. DANA 的URI段是否区分大小写？还有参数是否也区分大小写？

DANA中的URI和参数传递都是严格控制区分大小写的，注意不要写错。

6. DANA 里元数据的使用有限制么？文件、资料集、目录是不是都可以设元数据？

目前DANA只可以对文件和资料集设置元数据，目录暂不支持元数据设置。

7.上怎样用这些API实现一个上传操作？

文件上传简介：

文件上传数据块限制大小为4M，超出 4M的文件应该采用分块上传机制(每次上传小于4M)

调用此接口前必须保证文件已经创建， 下图是文件上传的一般流程

(1) 创建文件 --/api/v2/core/object/create

(2) 上传数据块 --/api/v2/core/object/write

(3) 大于4M的文件重复 (2)的步骤，上传时指定 offset, len

(4) 上传完成后调用 finish 接口，通知服务器上传完成 --/api/v2/core/object/finish

(5) 服务器后台会自动对文件进行索引等操作。

8.文件的元数据最多可以设置多少个？有没有限制？

理论上每个文件的元数据可以设置 2的32次方个，即4294967296(40亿+)，几乎可以无限个数的设置。

9.数据在传输过程中是否有数据压缩和数据加密操作？

因为一般Rest 的请求都是网页请求，数据本身不会太大，另为保证数据的正确性没有采取数据压缩技术，也没有相关的加密操作。

10.登录成功后返回的 Access-Token 什么时候过期？

用户登录成功后  Access-Token默认有效时间为1小时，但只要在一小时内再访问DANA服务即可刷此Access-Token有效时间，重置回一小时。同时开发者也可以通过调用session管理相关接口来控制指定每次访问后Access-Token的有效时间。

11.那些文件的转码、截图之类的文件占用的空间，属于系统空间还是用户空间？

像是文件转码后的低码流文件、截图、封面等文件属于源文件的附属文件即子文件，此类文件时不占用用户的存储空间的，都属于系统空间内的内容。

12.搜索引擎的索引库有没有备份？

索引库目前不提供备份的接口， 后续会根据用户需求，考虑是否加上此接口。

13.在遇到索引库故障或错误时怎样触发重建？

遇到索引库故障时，用户可调用相关API完成重建操作。

(1) 启动重建的API：/api/data/index/rebuild

(2) 查看重建进度的API：/api/data/index/rebuild/task/info

14.重建索引库采用什么机制？时间开销如何？

索引库重建是由后台任务调度系统异步进行的， 通过遍历文件基本信息和元数据，对所有文件重新索引。重建时会先重建到其他临时目录， 不影响当前索引的使用，完成后再替换旧版索引。

索引时间开销跟原文件内容和元数据信息量成正比。若不开启全文索引，只需索引基本信息和元数据，一分钟重建 5k ~ 1w个文件左右；若开启全文索引，则涉及到一些数据处理， 比如文本提取，格式转换等，时间会大大增加。