dataImport

URI

<relationship_uri>/dataimport[.<format>]？dataType=UDB

<relationship_uri>/dataimport[.<format>]？dataType=CSV

<relationship_uri>/dataimport[.<format>]？dataType=WORKSPACE

<relationship_uri>/dataimport[.<format>]？dataType=EXCEL

<relationship_uri>/dataimport[.<format>]？dataType=GEOJSON

支持的方法

POST、HEAD

父资源

relationship

介绍

dataImport 资源。通过对 dataImport 资源执行POST请求可以导入数据集。支持导入的文件格式有 csv文件 和 zip压缩文件(可包含udb、smwu)、EXCEL、GEOJSON。

支持的方法：

支持的表述格式：RJSON、JSON、HTML、XML。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson？dataType=UDB

http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson？dataType=CSV&separator={separator}&xIndex={xIndex}&yIndex={yIndex}

http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson？dataType=WORKSPACE

http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson？dataType=EXCEL&xIndex={xIndex}&yIndex={yIndex}

http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson？dataType=GEOJSON

POST 请求

通过 Web 页面执行一次上传，即将文件上传到DataStore中。但当您通过 API 构造请求时，请提前将文件上传到抓包工具(如 fiddler)中，再执行 POST 请求将文件上传到 DataStore。

请求参数

URI 中包含以下参数：

名称 类型 含义
dataType String 【必填参数】
包含以下五种类型文件，其中CSV和EXCEL只支持点数据集。
UDB、CSV、WORKSPACE、EXCEL、GEOJSON

    如果dataType为CSV或EXCEL时，URI 中还需传以下参数：

名称 类型 含义
separator String 分隔符（CSV数据时必填）
xIndex String x所在列（CSV或EXCEL数据时必填）
yIndex String y所在列（CSV或EXCEL数据时必填）
fieldTypes String[] 设置字段类型（CSV或EXCEL数据时可选填）。默认类型为：WTEXT。该参数按照CSV文件字段顺序从左到右依次设置，其中默认字段类型可省略不设置。例如，CSV文件中有10个字段，如果只需设定第1，2，4个字段，可设置为[a,b,,c]。
firstRowIsHead boolean 是否带表头（CSV数据时必填）

响应结构

对 dataImport 资源执行 POST 请求，响应参数如下：

字段 类型 说明
newResourceID String 导入的数据集获取的id。
newResourceLocation String 导入的数据集所在的URL。
succeed String 导入数据是否成功。

响应示例

对 dataImport 资源：http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson?dataType=UDB 执行 POST 请求，返回 rjson 格式的资源描述如下：

{

"newResourceID": "840893780_b1b50538_15a9_46c6_8d29_c0349fc0d587"

"newResourceLocation": "http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datas/840893780_b1b50538_15a9_46c6_8d29_c0349fc0d587"

"succeed": True

}

对 dataImport 资源：http://supermapiserver:8090//iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson?dataType=CSV&separator=,&xIndex=10&yIndex=11执行 POST 请求，返回 rjson 格式的资源描述如下：

{

"newResourceID": "-2056616596_62de25f2_90b9_4afe_81f9_d62a77b618d4"

"newResourceLocation": "http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datas/-2056616596_62de25f2_90b9_4afe_81f9_d62a77b618d4"

"succeed": True

}

对 dataImport 资源：http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson?dataType=WORKSPACE执行 POST 请求，返回 rjson 格式的资源描述如下：

{

"newResourceID": "894459517_b33b2a20_ae01_42c6_a57d_3c4780183cc4"

"newResourceLocation": "http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datas/-894459517_b33b2a20_ae01_42c6_a57d_3c4780183cc4"

"succeed": True

}

对 dataImport 资源：http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson?dataType=EXCEL&xIndex=10&yIndex=11 执行 POST 请求，返回 rjson 格式的资源描述如下：

{

"newResourceID": "1115150101_40119aaa_e277_4e19_abe8_829b5e4e585b"

"newResourceLocation": "http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datas/-1115150101_40119aaa_e277_4e19_abe8_829b5e4e585b"

"succeed": True

}

对 dataImport 资源：http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.json?dataType=CSV&separator=,&xIndex=1&yIndex=2

&firstRowIsHead=false&fieldTypes=[DOUBLE,DOUBLE,DOUBLE,DATETIME] 执行 POST 请求，返回 rjson 格式的资源描述如下：

{

"newResourceID": "080cb5283ab1388755390b5f1ac1627f_e87ab380_6662_4306_b6ba_505baa2c6b5e"

"newResourceLocation": "http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datas

/080cb5283ab1388755390b5f1ac1627f_e87ab380_6662_4306_b6ba_505baa2c6b5e"

"succeed": True

}

对 dataImport 资源：http://supermapiserver:8090//iserver/services/datacatalog/rest/datacatalog/relationship/dataimport.rjson?dataType=GEOJSON执行 POST 请求，返回 rjson 格式的资源描述如下：

{

"newResourceID": "1679763739_457185c0_c5d2_440f_8d63_a46c35716d66"

"newResourceLocation": "http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/relationship/datas/-1679763739_457185c0_c5d2_440f_8d63_a46c35716d66"

"succeed": True

}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 dataImport 资源是否存在，或者客户端是否有权限访问 dataImport 资源。通过对加.<format>的URI 执行 HEAD 请求，还可以快速判断 dataImport 资源是否支持<format>格式的表述。

请参见