数据服务功能是将数据服务化,通过接口将数据库中的数据提供给上层应用。 数据服务的使用需要拥有空间管理员权限或者赋予了数据服务权限的用户或者角色才能使用。该功能仅适用于私有化版本。
设置流程
1、数据服务权限
数据服务权限可以在「系统设置 -> 用户管理 -> 权限配置」中进行设置(也可以设置角色的数据服务权限使角色中所有用户拥有数据服务权限)。
2、在「数据管理 -> 数据服务 -> 新增数据服务」中添加数据服务
3、在新增数据服务页面可以配置数据服务名称、选择使用的数据模型、请求参数、返回参数等
注:
-
请求参数即为请求接口中需要传递的参数,当数据服务的请求参数为必填时且未传入此必填参数时就会使用默认值做为此参数的值;当接口中传入了此必填参数就会使用传入的值。
-
当数据返回类型为汇总并且请求参数为 int/float 类型字段时支持选择筛选方式,当选择「聚合后筛选-having」方式时此时为 having 筛选,筛选的聚合方式与返回字段一致,当返回字段没有此字段时不参与 having 筛选;当为「聚合前筛选-WHERE」时为 where 筛选。
-
返回参数即为接口需要返回哪些字段,当返回参数为度量并且数据返回类型为汇总时可以选择度量聚合方式。
-
当打开调试时会返回查询数据生成的 sql(默认为关闭状态)。
调用方式
创建数据服务ak/sk
在使用数据服务接口获取计算结果前需要先通过「系统设置 -> 空间Access Key -> 数据服务」创建aksk然后通过创建的aksk计算签名信息,用于访问数据服务接口时的权限认证,签名的计算方式和openAPI一致。
然后携带签名信息通过「openAPI -> V2」中的数据服务接口进行调用:数据服务