dataset-创建数据集

http://172.16.1.44:9800

POST

/rest/services/common/commondata/dataset

创建数据集。

// 创建数据集或矢量数据表
{
    "request": "dataset",
    "Request-Method":"POST",
    "datasourceName":"china",
    "parentDatasetName": "parentName", // 父数据集
    "datasetName":"name", // 名称
    "datasetAliasName": "aliasName", // 别名
    "datasetType":"featureClass", // 矢量数据表
    "geometryType": "point",    // 几何字段类型
    "referenceScale":121211.121, // 参考比例尺，注记表的时候需要使用
    "hasZ": false,
    "hasM":false,
    "boundary": [minx,miny, maxx, maxy], 数据范围
    "srs":"epsg:4326",
    "fields":  [
        {
            field object
        },{
            field object
        }
    ]
}

// 创建一个可以包含子数据集的父数据集
{
    "request": "dataset",
    "Request-Method":"POST",
    "datasourceName":"china",
    "datasetName":"pointDataset",
    "datasetAliasName": "点数据集合",
    "datasetType":"featureDataset",
    "srs":"epsg:4326"
}

// 创建一个可以被其他数据集包含的子数据集
{
    "request": "dataset",
    "Request-Method":"POST",
    "datasourceName":"china",
    "parentDatasetName": "pointDataset", // 父数据集
    "datasetName":"facilityPoint",
    "datasetAliasName": "设施点",
    "datasetType":"featureClass",
    "srs":"epsg:4326",
    "geometryType": "Point",    // 几何字段类型
    "fields":  [
        {
            field object // 必须项，不然会失败
        },{
            field object
        }
    ]
}
// 通过已有数据表创建一个新的表，具体的数据不会复制，只会复制其字段，空间参考等信息
{
    "request": "dataset",
    "Request-Method":"POST",
    "datasourceName":"china",
    "datasetName": "name", // 要被复制的表的名称
    "destDatasetName" "name_copy",
    "destDatasetAliasName": "新拷贝的表", // 别名
    "srs":"epsg:4326",
}

请求参数

Header 参数

ua_token

string

可选

默认值:

Body 参数application/json

request

string

必需

处理方法 dataset

Request-Method

string

必需

http请求方法 POST

datasourceName

string

数据源名称

必需

parentDatasetName

string

可选

父数据集名称，如果创建featureDataset的话，则不需要

datasetName

string

数据集名称

必需

datasetAliasName

string

数据集别名

可选

datasetType

string

必需

数据集类型。具体支持的类型

geometryType

string

可选

几何类型，点（point),线（polyline), 面（polygon)

referenceScale

number

可选

参考比例尺，注记表需要，不能小于等于0

hasZ

boolean

可选

是否需要保存Z值,默认不保存

hasM

boolean

可选

是否需要保存M值，3D需要，默认不保存

extend

number

可选

范围，[minx, miny, max, maxy]

srs

string

可选

置数据集空间参考信息，如果没有，采用父数据集的或者采用epsg:4326

fields

object

可选

字段数据集信息，需开发补充对应底层字段的信息，可在创建数据集时创建字段，也可在数据集创建之后添加修改字段；如果datasetType是featureDataset，则不需要

connInfo

object (ConnectionInfo)

可选

数据源连接信息，动态打开数据源，功能和其他datasourceID和datasourceName、destDatasetName、datasetName等参数的组合类似，互斥关系，且优先级优先级高于其他组合。该参数用于全局通用数据服务，根据临时连接信息动态打开数据源或数据集

connecttype

string

必需

数据源类型，支持 Folder,RelationalDB_Access,KQSpatialDB,KQPostgisDB,RelationalDB_PostgreSQL,RelationalDB_Kingbase8,RelationalDB_MySql,RelationalDB_SQL,RelationalDB_OCI11,RelationalDB_DM,S57,GDB,GeoJSON。

filepath

string

可选

文件路径，当数据源为文件或文件目录时有效，数据源类型为Folder,RelationalDB_Access,KQSpatialDB为文件型数据源。

folderpath

string

可选

文件夹路径，当数据源为文件或文件目录时有效，数据源类型为Folder

server

string

可选

数据库服务器地址(IP或机器名)

instance

string

可选

数据库实例名或端口

database

string

数据库名称

可选

user

string

数据源用户名

可选

password

string

数据库密码

可选

dataset_name

string

表名

可选

示例

{
    "request": "dataset",
    "Request-Method": "POST",
    "datasourceName": "china",
    "parentDatasetName": "parentName",
    "datasetName": "name",
    "datasetAliasName": "aliasName",
    "datasetType": "featureClass",
    "geometryType": "point",
    "referenceScale": 121211.121,
    "hasZ": false,
    "hasM": false,
    "boundary": "[minx,miny, maxx, maxy]",
    "srs": "epsg:4326",
    "fields": [
            "field object"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://172.16.1.44:9800/rest/services/common/commondata/dataset' \
--header 'ua_token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request": "dataset",
    "Request-Method": "POST",
    "datasourceName": "china",
    "parentDatasetName": "parentName",
    "datasetName": "name",
    "datasetAliasName": "aliasName",
    "datasetType": "featureClass",
    "geometryType": "point",
    "referenceScale": 121211.121,
    "hasZ": false,
    "hasM": false,
    "boundary": "[minx,miny, maxx, maxy]",
    "srs": "epsg:4326",
    "fields": [
            "field object"
    ]
}'

返回响应

🟢200成功

application/json

Body

resultcode

string

可选

示例

{
    "resultcode": "success",
    "datasetID": "资源ID"
}

修改于 2023-06-07 05:45:43

deleteDatasource

dataset