数据目录服务功能介绍 |
数据目录服务提供了便捷的数据组织与管理方式。通过数据目录服务，可以将 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文件。
iServer 管理模块中的“快速创建服务”功能，支持将数据目录服务中的关系型数据发布为地图服务、数据服务 和 空间分析服务。
发布的时候需要指定数据目录服务的数据地址，格式为：http://{ip}:{port}/iserver/services/datacatalog/rest/datacatalog/relationship/datas/{dataID}
数据目录服务中管理的二进制数据，是依托 iServer DataStore 的管理能力，将数据文件以二进制流的方式存储在已关联的 MongoDB 数据库中，MongoDB 数据库的版本需要为 3.2 以上。数据目录服务对二进制数据的功能包括：查看数据列表、上传/下载/删除 数据。
在 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 以上。数据目录服务对切片缓存数据的功能包括：查看数据列表、上传/下载/删除 数据。
在 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 中所有的时空数据集。