不同存储媒介的影像添加方式

影像集合支持添加多种存储媒介中的影像文件，并支持.tif、.img、.ecw和.pix多种影像文件格式。下文详细介绍不同存储媒介的影像适合哪种“添加影像数据方式”以及如何配置。

影像文件可以来源于以下存储媒介：

• 本地存储，包括Windows和Linux系统；
• NAS网络存储，支持FTP、NFS、SMB访问协议；
• 对象存储，包括：华为OBS对象存储服务、阿里OSS对象存储服务、S3简单存储服务，既支持HTTP访问协议；也可以通过GDAL的vsis3和vsioss文件系统处理程序来访问AWS S3和阿里OSS对象存储桶中的影像文件；
• FTP服务器；
• 远程共享目录(NFS)。

本地存储

本地存储的影像可以通过下面任意方式添加到集合：

• 通过“影像数据目录”方式，将指定目录路径下的影像添加到集合。本地目录路径写法：Linux系统：/home/data/images/；Windows系统： E:\data\imageChina。
• 通过“清单文件”方式，清单文件（.txt文件）中一行记录为一个影像文件的全路径，路径写法：Linux系统：/home/data/images/H48C002002.tif；Windows系统： E:\data\imageChina\H48C002002.tif。
• 添加本地存储的单个影像文件，通过"单个影像文件"的方式，指定影像文件的全路径，写法同上。

远程共享目录

远程共享目录中的影像可以通过下面任意方式添加到集合：

• 通过“影像数据目录”的方式，将指定远程目录的影像添加到集合。

  远程共享目录路径写法：Windows系统：\\172.16.120.34\imageChina。

  对于Linux系统，需要将共享目录进行挂载，使用挂载后的目录路径（挂载命令行为：mount -t cifs //{ip}/share /mnt/share，其中：ip为共享目录的IP地址，/mnt/share为挂载后的目录，例如：mount -t cifs //172.16.120.34/imageChina /mnt/share）

• 通过“清单文件”的方式，清单文件（.txt文件）中一行记录为一个影像文件的全路径，路径写法：Windows系统：\\172.16.120.34\imageChina\H48C002002.tif。对于Linux系统，需要将共享目录进行挂载，然后使用挂载后的文件路径，参见上文。
• 添加远程共享目录中的单个影像文件，则可以通过"单个影像文件"的方式，指定影像文件的全路径，写法同上。

FTP服务器

FTP服务器上的影像添加到集合，只能通过“清单文件”方式，清单文件（.txt文件）中一行记录为一个影像文件的FTP全路径，路径写法：ftp://172.16.120.34/imageChina/H48C002002.tif。

注意：

FTP路径中包含非英文字符，如：ftp://127.0.0.1/影像数据/dem30米分辨率.tif，添加影像可能失败，原因是FTP客户端的编码与服务器所使用的编码不一致，FTP服务器路径经过转码后导致路径错误，无法访问到影像文件。

解决方法：获得转码后的FTP服务器影像路径，例如：FTP服务器路径为：ftp://127.0.0.1/影像数据/dem30米分辨率.tif，它转码后载路径为：ftp://127.0.0.1/%E5%BD%B1%E5%83%8F%E6%95%B0%E6%8D%AE/dem30%E7%B1%B3%E5%88%86%E8%BE%A8%E7%8E%87.tif。

转码后的路径，可以通过下面的方式获得：将影像文件的FTP服务器路径输入到浏览的地址栏，回车即可。此外，还可以通过转码（decode）的方式。

挂载远程目录

• 针对Linux系统，通过NFS协议挂载远程目录，再将其中的影像添加到集合。

  挂载命令行为：mount -t cifs //{ip}/share /mnt/share，其中：ip为共享目录的IP地址，/mnt/share为挂载后的目录，例如：mount -t cifs //172.16.120.34/imageChina /mnt/share）

  挂载后的目录访问方式同Linux系统的本地存储，将其中的影像添加到集合，请参见：本地存储

• 针对Windows系统，通过SMB协议挂载远程目录，再将其中的影像添加到集合。

  挂载后的目录访问方式同Windows系统的本地存储，将其中的影像添加到集合，请参见：本地存储

对象存储

对象存储中的影像可以通过下面任意方式添加到集合：

• 添加对象存储中的单个影像文件，则可以通过"单个影像文件"的方式，指定影像文件的全路径，写法同下。
• 通过“清单文件”的方式，清单文件（.txt文件）中一行记录为一个影像文件的全路径，路径写法如下：

集合支持添加华为OBS对象存储服务、阿里OSS对象存储服务、S3简单存储服务中的影像。

关于对象存储服务中影像文件的全路径写法：

• HTTP访问协议：路径： /vsicurl/http://1.1.1.1:80/mybucket/L51C001003.tif，其中：“/vsicurl/”是http协议的必须前缀；“mybucket”为桶名。
• HTTPS访问协议：路径： /vsicurl/https://1.1.1.1:443/mybucket/L51C001003.tif，其中：“/vsicurl/”是http协议的必须前缀；“mybucket”为桶名。
• GDAL的vsis3文件系统程序访问（推荐）：路径：/vsis3/mybucket/L51C001003.tif，其中，“/vsis3/”是必须前缀；“mybucket”为桶名。

访问对象存储的服务器环境配置

影像服务能够成功访问对象存储中的影像，还需要进行服务器环境的配置，如下：

1. 配置对象存储的访问协议

默认访问协议为 HTTPS。

新建名为“AWS_HTTPS”的系统环境变量。

“AWS_HTTPS”变量的值设置为NO，采用HTTP访问协议；“AWS_HTTPS”设置为TRUE，采用HTTPS访问协议。

2. 指定对象存储的URI

新建名为“AWS_S3_ENDPOINT”的系统环境变量，变量值为对象存储的访问地址，支持域名和“IP+端口”两种地址形式。

例如：

AWS_S3_ENDPOINT=obs.cn-north-4.myhuaweicloud.com

AWS_S3_ENDPOINT=1.1.1.1:80

AWS_S3_ENDPOINT=1.1.1.1:443

备注说明：关于端口的说明，若对象存储采用HTTPS协议访问，默认端口为443；若采用HTTP协议访问，默认端口为80。

3. 对象存储的访问密钥AK\SK

新建名为“AWS_ACCESS_KEY_ID”和“AWS_SECRET_ACCESS_KEY”的系统环境变量，变量值为密钥AK\SK值。

备注说明：如果使用域名访问对象存储，只需要设置AWS_S3_ENDPOINT、AWS_ACCESS_KEY_ID”和“AWS_SECRET_ACCESS_KEY 三个环境变量。

4. 配置对象存储桶的访问方式

访问公有云对象存储时无需设置该环境变量，访问私有云对象存储时必须配置。

新建名为“AWS_VIRTUAL_HOSTING”的系统环境变量，变量值为FALSE。

“AWS_VIRTUAL_HOSTING”默认值为TRUE，此时，桶的访问方式为桶名+HostName，例如：mybucket.cname.domain,com；而SuperMap支持桶的访问方式为桶作为对象存储URI的顶级目录，即cname.domain,com/mybucket，因此，需要将“AWS_VIRTUAL_HOSTING”设置为FALSE。

5. 无需签名的配置

访问公有云对象存储时无需设置该环境变量，访问私有云对象存储时必须配置。

新建名为“AWS_NO_SIGN_REQUEST”的系统环境变量，变量的值设置为YES。

当访问私有云对象存储中的数据时，如果遇到如下所示的错误信息（The request signature we calculated dose not match the signature you provided. Check your key and signing method.），可以将“AWS_NO_SIGN_REQUEST”系统环境变量设置为YES。

6. 配置CURL SSL证书

当访问对象存储中的数据失败时，错误信息如下：（CURL error: SSL certificate problem:），需要下载一个CURL SSL证书并完成配置。