数据

作为 GIS 门户软件平台，SuperMap iPortal 支持整合 SuperMap GIS 格式、常见 GIS 格式以及含地理位置坐标的 Excel、CSV 等传统数据，也支持接入 HDFS 和数据库数据。除 GIS 数据外，也以 REST API 的方式支持添加音视频、图片等非 GIS 数据。添加到门户中的 GIS 数据可在内置 WebApps 中直接采用地图或多种图表进行可视化表达、深度分析。也可发布成服务后，以服务的形式供各内置 WebApps 使用或供其他 Web GIS 应用系统调用。下面分别详细介绍在门户中添加数据的两种方式：上传数据和注册数据，以及如何使用 iPortal 中添加的数据。注意：若管理员开启了数据审核功能，新添加到门户中的数据审核通过后，才能在门户中搜索与使用。

• 上传数据
• 注册数据
• 注册数据库
• 使用 iPortal 中添加的数据

上传数据

在 iPortal 中上传数据要求用户是“创建者”类型且拥有上传数据和发布服务权限的角色，如 DATA_CENTER（iPortal 的用户类型及权限划分，详见：角色、用户类型和权限）。此外，需要管理员进行托管数据存储配置，并指定托管服务器用于发布服务。

iPortal 支持配置二进制和关系型的托管数据存储，默认使用二进制存储。若管理员同时配置了关系型存储，系统将优先使用关系型存储，同时也会在二进制存储中备份上传的数据。但也有一些数据如缓存切片仅支持存储在二进制中。上传数据支持的数据类型、发布服务类型及下载格式如表1所示。

表1 上传数据支持的数据类型、数据文件、支持发布的服务类型及下载格式的对应关系

注1： 表示此服务类型或数据下载格式在配置关系型存储后才支持

若您有管理非 GIS 数据，如音视频等资源的需求，可通过 REST API 的形式上传 ，详情请参阅：myDatas 资源的 POST 请求。

此外，iPortal 对上传到门户中的数据容量有大小限制，默认您可上传的最大容量为2048MB，管理员可修改此项配置，详见：上传数据容量配置。

上传步骤：

1. 在 iPortal 首页，点击“资源中心”>“数据”进入数据资源页面，右侧点击“上传数据”（需登录）进入上传数据页面；
2. 选择“数据类型”，指定要上传的“数据文件”，设置“数据名称”及“标签”后，点击“上传”，完成数据上传；点击“上传并发布”，可将数据上传并发布为服务，若使用共享存储发布服务，请参考：使用共享存储发布服务；
3. 若选择的是“上传并发布”，将进入发布服务页面，勾选要发布的服务类型，点击“下一步”，进行服务参数配置；
4. 当选择发布为交通网络分析服务时，参数说明请参考：交通网络分析服务提供者配置参数 ；选择发布为三维网络分析服务时，参数说明请参考：三维网络分析服务提供者配置参数；
5. 等待上传结束、服务发布成功，即可完成此流程；若在上传数据时未选择“上传并发布”而选择直接“上传”，您也可以等待上传完成后，在“资源中心”>“数据”>“我的数据”页面执行发布操作。

注意：若上传 Shapefile 类型的数据，还需选择文件编码格式： UTF-8/GBK。

上传成功后，系统会自动跳转到该项数据资源的详情页面，您可查看或编辑相关信息、已发布的服务（若勾选了发布），也可下载数据。若有共享的需求，您可切换到该项数据资源的“共享设置”面板修改共享信息，详见：共享数据。

上传后的数据均显示在“资源中心”>“数据”>“我的数据”页面。除了发布、编辑、下载、共享等功能，在“我的数据”页面，您还可进行更新数据、删除数据、预览pdf数据的操作。

• 若待更新数据的数据已发布了服务，更新数据后服务会重新发布，但服务名称会保持不变。
• 若删除数据后，发布的服务也会同步删除。注意：若数据有关联的地图、洞察、大屏等应用，删除数据会导致这些关联资源不能正常访问。更多关于删除，详见：删除资源。

注1：若 iPortal 管理员开启了服务审核功能（默认未开启），数据在发布服务完成后，自动注册到 iPortal 中的这些托管服务会进入“待审核”状态，需要管理员审核通过才能注册成功。对未审核通过的服务设置共享不会生效。用户可在“我的服务”页面通过缩略图查看服务是否审核通过。待审核的服务，缩略图会标识“授权审核中，敬请期待”，审核未通过的服务会显示“审核未通过”字样。

注2：在数据上图 WebApp中通过文件添加的数据、通过添加标注图层生成的点线面数据，在数据洞察 WebApp中添加数据，均会保存到“我的数据”中。

注3：如果您可发布的服务数量已达上限，请联系管理员为您更新配额。

注册数据

在 iPortal 中注册数据同样要求用户是“创建者”类型且拥有上传数据和发布服务权限的角色，如 DATA_CENTER（iPortal 的用户类型及权限划分，详见：角色、用户类型和权限）。此外，需要管理员指定托管服务器。iPortal 支持注册以下格式的数据：

•  Hadoop 分布式文件系统（HDFS）中的 CSV 格式数据

注册 HDFS 数据：

1. 在 iPortal 首页，点击“资源中心”>“数据”进入数据资源页面，右侧点击"注册数据"（需登录）进入注册页面，设置如下信息项：

2. 数据类型：注册的数据类型，选择 HDFS
3. HDFS 目录：填写 HDFS 路径+CSV 名称，如：hdfs://{ip}:9000/data/newyork_taxi_2013-01_14k.csv
4. 名称：填写自定义的数据名称
5. 标签：填写自定义的数据标签

2. 点击“注册”，系统会自动解析该数据的相关配置信息，需要您手动进行数据配置信息的校验：

3. X 索引：选择数据中对应 X 坐标所在的列
4. Y 索引：选择数据中对应 Y 坐标所在的列
5. EpsgCode：数据的投影坐标系对应的EPSG Code
6. 分隔符：CSV 文件中的分隔字符
7. 包含表头：根据注册的 CSV 数据中是否包含表头进行勾选

3. 点击“校验数据”按钮，进行数据配置信息的确认：如您暂不能确认相关信息，可单击“暂不校验”按钮，之后您可以随时在该数据项或在详情页点击 按钮，完成数据的校验。

注册数据库

• PostGIS 数据库中的数据
• PostgreSQL 数据库中的数据
• MySQL 数据库中的数据

若您希望自定义数据库连接信息加密密钥，具体配置请参见：iPortal 配置文件说明。

注：支持查询空间数据的数据库，需满足 MySQL 5.7.4及以上版本，PostGIS 需安装在 PostgreSQL 9.6及以上版本。

注册 PostGIS 数据库：

1. 在 iPortal 首页，点击“资源中心”>“数据”进入数据资源页面，右侧点击"注册数据"（需登录）进入注册页面，设置如下信息项：

2. 数据类型：选择 数据库存储
3. 数据名称：填写自定义的数据名称
4. 数据库类型：选择 POSTGIS
5. 服务器地址：填写数据库的服务地址，格式为1.IP地址，如：192.168.1.1，2.主机地址，如：supermap.com
6. 端口：填写数据库的端口
7. 数据库名称：填写将使用的数据库名称
8. 用户名：该数据库所有者的用户名
9. 密码：该数据库所有者的密码
10. 模式：默认为public，需与创建数据库设置的schema名称一致
11. 表名：默认注册所有表，勾选后可指定一个或多个表
12. 连接参数：填写连接参数，格式为 option1=value1&option2=value2
13. 标签：填写自定义的数据标签

2. 点击“注册”按钮，即可将 PostGIS 中的数据注册到 iPortal 中。

注册 PostgreSQL 数据库：

1. 在 iPortal 首页，点击“资源中心”>“数据”进入数据资源页面，右侧点击"注册数据"（需登录）进入注册页面，设置如下信息项：

2. 数据类型：选择 数据库存储
3. 数据名称：填写自定义的数据名称
4. 数据库类型：选择 POSTGRESQL
5. 服务器地址：填写数据库的服务地址，格式为1.IP地址，如：192.168.1.1，2.主机地址，如：supermap.com
6. 端口：填写数据库的端口
7. 数据库名称：填写将使用的数据库名称
8. 用户名：该数据库所有者的用户名
9. 密码：该数据库所有者的密码
10. 模式：默认为public，需与创建数据库设置的schema名称一致
11. 表名：默认注册所有表，勾选后可指定一个或多个表
12. 连接参数：填写连接参数，格式为 option1=value1&option2=value2
13. 标签：填写自定义的数据标签

2. 点击“注册”按钮，即可将 PostgreSQL 中的数据注册到 iPortal 中。

注册 MySQL 数据库：

1. 在 iPortal 首页，点击“资源中心”>“数据”进入数据资源页面，右侧点击"注册数据"（需登录）进入注册页面，设置如下信息项：

2. 数据类型：选择 数据库存储
3. 数据名称：填写自定义的数据名称
4. 数据库类型：选择 MYSQL
5. 服务器地址：填写数据库的服务地址，格式为1.IP地址，如：192.168.1.1，2.主机地址，如：supermap.com
6. 端口：填写数据库的端口
7. 数据库名称：填写将使用的数据库名称
8. 用户名：该数据库所有者的用户名
9. 密码：该数据库所有者的密码
10. 表名：默认注册所有表，勾选后可指定一个或多个表
11. 连接参数：填写连接参数，格式为 option1=value1&option2=value2
12. 标签：填写自定义的数据标签

2. 点击“注册”按钮，即可将 MySQL 中的数据注册到 iPortal 中。

注册成功后，系统会自动跳转到该项数据资源的详情页面，您可查看或编辑相关信息。若有共享的需求，您可切换到该项数据资源的“共享设置”面板修改共享信息，详见：共享数据。

注册后的数据均显示在“资源中心”>“数据”>“我的数据”页面。注意：注册到 iPortal 中的数据不占用数据存储容量，不支持发布和下载。仅支持编辑数据详情、共享数据、删除数据的操作。

使用 iPortal 中添加的数据

添加到门户中的 GIS 数据可在内置 WebApps 中直接采用地图或多种图表进行可视化表达、深度分析。也可发布成服务后，以服务的形式供各内置 WebApps 使用或供其他 Web GIS 应用系统调用。具体地讲：

• 在数据上图 WebApp 中：

• 1. 可直接将 Excel、CSV、GeoJSON 和 Shapefile 数据通过文件添加为要素图层叠加到底图上；
  2. 也可将数据发布的REST 地图服务或 REST 数据服务添加为图层；
  3. 此时，即可利用数据结合您的需求制作丰富的专题图。

• 在数据洞察 WebApp 中：

• 1. 可将 Excel、CSV、GeoJSON、Shapefile 或注册的 HDFS 数据添加进来；
  2. 也可将数据发布的 REST 地图服务或 REST 数据服务添加进来；
  3. 此时基于添加进来的数据或服务，结合您的需求即可使用地图或图表进行可视化表达；此外，在地图视图中，您可进一步使用提供的分析功能深层次地发掘数据蕴藏的规律与价值。

注：添加进来的 HDFS 数据暂不支持可视化显示，仅用于分布式分析功能。

• 在三维地球 WebApp 中：您可将托管数据发布后的REST 三维服务以图层的形式添加到场景中，基于此场景添加点线面要素，或在场景中量算、查询功能，或三维分析等。

• 在地图大屏 WebApp 中，支持将公开的数据、我的数据、iServer REST 服务等作为可视化组件的数据源，详见：添加可视化组件。

• 在您开发的 Web GIS 系统中调用 iPortal 中的服务资源，详见：使用 iCient JavaScript 访问 iPortal 中的资源。