field

http://172.16.1.44:9800

PUT

/rest/services/{servicename}/data/field

修改字段元数据信息，支持批量操作。仅当空数据集时可用。风险较高，建议配合权限使用。

请求参数

Path 参数

servicename

string

必需

Header 参数

ua_token

string

可选

默认值:

Body 参数application/json

request

string

必需

处理方法 field

Request-Method

string

必需

http请求方法PUT

datasourceName

string

数据源名称

必需

datasourceID

string

可选

数据源ID ，和datasourceName功能相同，用于确定数据源。服务重启（持久化后再加载）保证一致性。二选一。

datasetID

string

可选

每个数据集对应一个唯一标识ID，可替换数据源名称+数据集名称确定一个唯一数据集。效果可数据源名称+数据集名称相同。二选一，优先级高。

datasetName

string

数据集名称。

必需

fieldNames

array[string]

必需

修改前的属性字段的名称，与下面fields的数组个数对应。

fields

array[object (Field) {15}]

必需

修改后的字段信息参数说明。

name

string

必需

字段名称。唯一标识一个字段，没有重名。

alias

string

必需

字段别名，不同的字段可以有相同的别名。

type

enum<string>

字段类型。

必需

枚举值:

UnknownInt8Int16Int32Int64FloatDoublestringDateBlobFIDGUIDXMLGeometryANSIString

length

string

可选

字段长度。默认为0

isNullable

boolean

是否可为空。

可选

isEditable

boolean

可选

是否可编辑。默认为true

isRequired

boolean

可选

是否为必填字段。true 表示是必填字段，false 表示非必填字段。

presicion

integer

字段精度。

可选

defaultValue

string

字段的默认值。

可选

isSystemField

boolean

可选

是否为系统字段,，一般几何字段，ID字段才为必须字段。

comment

string

字段注释。

可选

isGeoField

boolean

可选

是否为图形字段，默认为false。

isRegisteredRenderIndex

boolean

可选

字段是否为渲染索引字段，默认为false。

constraints

object

字段约束。

可选

domain

object

字段属性域。

可选

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

表名

可选

示例

{
    "datasourceName": "OrclData",
    "datasetName": "QQ",
    "fieldNames": [
        "A",
        "B",
        "C"
    ],
    "fields": [
        {
            "name": "A",
            "alias": "字段A",
            "type": "String",
            "length": 100,
            "isRequired": true,
            "isNullable": true,
            "isEditable": true
        },
        {
            "name": "B",
            "alias": "字段B",
            "type": "Double",
            "isRequired": true,
            "isNullable": true,
            "isEditable": true,
            "precision": 4
        },
        {
            "name": "C",
            "alias": "字段C",
            "type": "Int16",
            "isRequired": true,
            "isNullable": true,
            "isEditable": true
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'http://172.16.1.44:9800/rest/services//data/field' \
--header 'ua_token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasourceName": "OrclData",
    "datasetName": "QQ",
    "fieldNames": [
        "A",
        "B",
        "C"
    ],
    "fields": [
        {
            "name": "A",
            "alias": "字段A",
            "type": "String",
            "length": 100,
            "isRequired": true,
            "isNullable": true,
            "isEditable": true
        },
        {
            "name": "B",
            "alias": "字段B",
            "type": "Double",
            "isRequired": true,
            "isNullable": true,
            "isEditable": true,
            "precision": 4
        },
        {
            "name": "C",
            "alias": "字段C",
            "type": "Int16",
            "isRequired": true,
            "isNullable": true,
            "isEditable": true
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

resultcode

string

必需

示例

{
    "resultcode": "success"
}

修改于 2023-06-06 02:03:23

field

statistic