写出SDX表结构

使用说明

根据输入的数据表结构信息,向SDX数据库中创建或更新对应的数据表及其属性结构。


输入数据

参数名 参数释义 参数类型
输入 含有表结构信息的数据源,通常由其他转换器的输出提供。 IFeatureCollection

参数说明

参数名 参数释义 参数类型
写出路径

指定数据写出的SuperMap SDX引擎支持的数据库型数据源。

String
写出方式 指定数据表操作方式:
  • 创建:数据源中无同名表时,创建新表作为目标表。存在同名表时,执行失败。
  • 更新:数据源中有同名表时,更新同名表,反之忽略更新。可更新的内容有数据表别名和字段别名。
WriterType
数据表名 指定数据表名所在的列,将自动读取该列的值作为创建或更新的数据表名称。数据表名需遵循写出路径中所选择数据库的相关命名规范。 String
数据表别名

可选参数,指定数据表别名所在的列,将自动读取该列的值作为创建或更新的数据表别名。

  • 若不指定此列或此列的值为空,且选择的写出方式为创建,则结果数据表的别名与数据表名一致。
  • 若不指定此列或此列的值为空,且选择的写出方式为更新,则结果数据表的别名将不被更新。
String
数据表类型

指定数据表类型(几何类型)所在的列,支持的值有table、point、piontz、line、linez、linem、polygon、polygonz、text、model、cad。

若此列的值为空,或含有其他值,则执行失败。

String
字段名称

指定字段名称所在的列,将自动读取该列的值作为创建或更新的字段名称。字段名称需遵循写出路径中所选择数据库的相关命名规范。

String
字段别名

可选参数,指定字段别名所在的列,将自动读取该列的值作为创建或更新的字段别名。

  • 若不指定此列或此列的值为空,且选择的写出方式为创建,则结果字段的别名与字段名称一致。
  • 若不指定此列或此列的值为空,且选择的写出方式为更新,则结果字段的别名将不被更新。
String
字段类型

指定字段类型所在的列。支持的类型有如下,不区分大小写。

  • 16位整型:整数型字段,值域范围是[-32768,32767]。该列中的值为“INT16”或“16位整型”时,均可被识别为16位整型。
  • 32位整型:整数型字段,值域范围是[-2147483648,2147483647]。该列中的值为“INT32”或“32位整型”时,均可被识别为32位整型。
  • 64位整型:整数型字段,值域范围是[-9223372036854775808, 9223372036854775807]。该列中的值为“INT64”或“64位整型”时,均可被识别为64位整型。
  • 双精度:双精度浮点型数值,允许的值是-1.7976931348623157E+308到-2.2250738585072014E-308,0和2.2250738585072014E-308到1.7976931348623157E+308。该列中的值为“DOUBLE”或“双精度”时,均可被识别为双精度。
  • 单精度:单精度浮点型数值,允许的值是-3.402823466E+38到-1.175494351E-38,0 和 1.175494351E-38到3.402823466E+38。该列中的值为“SINGLE”或“单精度”时,均可被识别为单精度。
  • 文本型:可变长度的文本型字段,最大长度为255(2^8-1)个字符。该列中的值为“TEXT”、“文本”或“文本型”时,均可被识别为文本型。
  • 字符型:最大长度为65535(2^16-1)个字符。该列中的值为“CHAR”或“字符型”时,均可被识别为字符型。
  • 布尔:字段值为True或False。该列中的值为“BOOLEAN”或“布尔”时,均可被识别为布尔。
  • 日期:日期时间型字段,显示格式为YY/MM/DD hh:mm:ss,例如:2020/11/19 14:54:10。该列中的值为“DATETIME”、“DATE”或“日期”时,均可被识别为日期。
  • 字节:byte数据类型,值域为[0,255]。该列中的值为“BYTE”或“字节”时,均可被识别为字节。
  • 二进制型:二进制类型,有字符集的概念。该列中的值为“LONGBINARY”或“二进制型”时,均可被识别为二进制型。
String
字段长度

可选参数,用于指定文本型或字符型字段的长度所在列。如未指定或该列值为空,则采用默认字段长度,文本型和字符型字段的默认长度将分别设为255和1。

对于16位整型、32位整型、64位整型、双精度、单精度、布尔、日期、字节及二进制类型字段,此设置不适用,其长度始终采用程序预设值。

String
字段默认值 可选参数,指定字段默认值的列。例如,Education_P数据表中Province字段的默认值为“四川省”,成功创建表结构后,向该表创建对象时,Province字段的值都会自动填充为“四川省”。 String
字段必填

可选参数,指定字段是否为必填的列。

  • 该列中的值为“是”、“Y”或“YES”或“TRUE”时,均可被识别为必填。
  • 若不指定或该列的值为上述以外的其他值,则默认为非必填。
String
字段顺序 可选参数,指定字段在数据表中的排列顺序。若不指定或该列的值为空,则根据该列的顺序创建字段。 String

输出结果

参数名 参数释义 参数类型
统计数据 统计成功写出的数据信息。 IFeatureCollection
无效数据 当前转换器无法处理的记录。 IFeatureCollection