数据目录服务功能介绍

数据目录服务提供了便捷的数据组织与管理方式。通过数据目录服务，可以将 SuperMap iServer 托管的数据和用户自管理的数据进行集中统一管理，强大的数据管理能力支持管理多个 iServer DataStore，进而支持管理几千个关系型数据集、时空数据集。数据目录服务为普通用户提供了查看、检索各类数据的入口，包含关系型数据、二进制数据、大数据文件共享数据、瓦片数据和时空大数据。此外，数据目录服务还支持向 iServer 托管数据库中创建和删除数据集，以及上传和下载数据。对于已注册到 iServer 的数据库以及 iServer DataStore 管理的数据库，还可以通过发布数据目录发布为服务。注册到 iServer 的数据库以及 iServer DataStore 管理的数据库支持导入的数据类型、支持发布的服务类型请参考下表：

数据目录服务中管理/注册的数据库

支持导入的数据类型

支持发布的服务类型

UDB

CSV

SMWU

SXWU

Excel

geojson

shp

SMTiles

GeoPackage

REST-map

REST-data

REST-spatialAnalysis

关系型数据

PostGIS（数据注册）

√

PostgreSQL（数据注册）

√

PostgreSQL（Datastore）

√

Oracle（数据注册）

√

达梦（数据注册）

√

瀚高（数据注册）

√

人大金仓（数据注册）

√

HDFS（数据注册）

√

二进制数据

MongoDB（Datastore）

不支持从 iServer 导入数据

不支持发布为服务

时空型数据

Elasticsearch（Datastore）

不支持从 iServer 导入数据

不支持发布为服务

切片缓存数据

MongoDB（数据注册）

不支持从 iServer 导入数据

不支持发布为服务

MongoDB（Datastore）

√

关系型数据

数据目录服务中管理的关系型数据，是依托 iServer DataStore 的管理能力，将数据集存储在其内置的 postgresql 数据库中。数据目录服务对关系型数据的功能包括：查看数据集、创建/删除数据集、上传数据、下载数据、支持发布为GIS服务。

查看数据集

在 relationship/datasets 资源的数据集列表下，可以查看到当前 iServer 托管在 iServer DataStore 中所有的关系型数据集和注册的空间数据库下的所有关系型数据集。数据集的来源有以下几种：1.iServer DataStore 中已有的数据集；2.通过数据目录服务创建的数据集；3.通过数据集导入功能导入的数据集；4.注册的空间数据库中已有的数据集。

注：暂不支持查看视频数据集、拓扑数据集。

创建/删除数据集

在 relationship/datasets 资源下，支持创建数据集和删除数据集。

创建数据集：

传入数据集的名称和数据集类型，即可在 iServer DataStore 的关系型数据源中创建一个空数据集。也支持传入 prjCoordSys 信息，创建一个带坐标信息的空数据集。数据集创建成功后，会得到数据集资源，url 为 relationship/datasets/{datasetName} 。
目前支持创建的数据集类型包括：POINT、POINTEPS、LINE、LINEEPS、REGION、REGIONEPS、TEXT、TEXTEPS、CAD、TABULAR

删除数据集

对数据集资源 relationship/datasets/{datasetName} 发送 Delete 请求，即可以删除对应的数据集。

上传数据

在 relationship/dataimport 资源下，可以上传数据集。支持上传的文件类型包括：UDB数据源、CSV文件、工作空间、Excel 文件、 GeoJson 文件和Shapefile文件，且 udb 数据源、Shapefile文件与工作空间导入格式需要压缩为 *.zip 的格式。

数据集上传成功后，会返回一个唯一的 dataID，用于代表该上传文件的数据包。通过访问 relationship/datas/{dataID} 资源，可获得该数据包的详细描述信息。
上传成功的数据集，也会出现在 relationship/datasets 资源的数据集列表中。
DataStore已向iserver注册的情况下，若已注册可编辑的空间数据库，优先选择可编辑的空间数据库用于存储；若没有注册可编辑的数据库，则优先选择DataStore用于存储。
若注册多个可编辑的空间数据库，上传数据时优先选择数据集较少的数据库。

下载数据

在 relationship/datas 资源下，可以下载数据集。支持下载的格式包括：udb和 Shapefile文件。若上传的数据是工作空间类型，则支持下载的格式还包括工作空间；若上传的数据是Shapefile类型，则仅支持下载的格式为Shapefile文件。

支持发布为GIS服务

iServer 管理模块中的“快速创建服务”功能，支持将数据目录服务中的关系型数据发布为地图服务、数据服务和空间分析服务。

发布的时候需要指定数据目录服务的数据地址，格式为：http://{ip}:{port}/iserver/services/datacatalog/rest/datacatalog/relationship/datas/{dataID}

二进制数据

数据目录服务中管理的二进制数据，是依托 iServer DataStore 的管理能力，将数据文件以二进制流的方式存储在已关联的 MongoDB 数据库中，MongoDB 数据库的版本需要为 3.2 以上。数据目录服务对二进制数据的功能包括：查看数据列表、上传/下载/删除数据。

查看数据ID列表

在 binary/datas 资源下，可以查看数据目录服务中上传成功的的二进制数据 ID。通过点击数据ID的链接，可以查看该数据的详细信息。

上传/下载/删除数据

在 binary/dataimport 资源下，支持将各种类型的数据文件，以二进制流的形式上传存储到 iServer DataStore 关联的 MongoDB 数据库中。

数据上传成功后，会返回一个唯一的 dataID，用于代表该上传文件的数据包。通过访问 binary/datas/{dataID} 资源，可获得该数据包的详细描述信息。
在 binary/datas/{dataID} 资源页面，点击数据信息列表框中的“删除”，即可在 MongoDB 中删除对应的数据文件；点击“下载”，浏览器将会自动下载该数据文件。

共享文件

数据目录服务中的 sharefile 资源管理的数据集，是 iServer 管理员通过“集群”“数据注册”功能注册到 iServer 中的大数据文件共享。数据注册功能可以将 HDFS 目录和共享目录中的 CSV 文件和 UDB 数据源注册成为其相对应的数据集。

通过点击 sharefile 资源页面上列出的数据集名称，可以查看数据集详细信息。

切片缓存数据

数据目录服务中管理的切片缓存数据，是依托 iServer DataStore 的管理能力，将数据文件以切片的方式存储在已关联的 MongoDB 数据库中，MongoDB 数据库的版本需要为 3.2 以上。数据目录服务对切片缓存数据的功能包括：查看数据列表、上传/下载/删除数据。

查看数据ID列表

在 tiles/datas 资源下，可以查看数据目录服务中导入成功的的切片缓存数据 ID。通过点击数据ID的链接，可以查看该数据的详细信息。

导入切片

在 tiles/dataimport 资源下，支持将 SMTiles 和 GeoPackage 格式的瓦片包，导入存储到 iServer DataStore 关联的 MongoDB 数据库中。

数据上传成功后，会返回一个唯一的 dataID，用于代表该上传文件的数据包。通过访问 tiles/datas/{dataID} 资源，可获得该数据包的详细描述信息。

支持发布为地图服务

iServer 管理模块中的“快速创建服务”功能，支持将数据目录服务中的切片缓存数据发布为地图服务。

发布的时候需要指定数据目录服务的数据地址，格式为：http://{ip}:{port}/iserver/services/datacatalog/rest/datacatalog/tiles/datas/{dataID}

时空数据

查看数据集

在 spatiotemporal/datasets 资源的数据集列表下，可以查看到当前 iServer 托管在 iServer DataStore 中所有的时空数据集。