导入条件值 (数据管理)

摘要

将多个条件值和字段组从逗号分隔值文件 (.csv) 导入到数据集中。

使用情况

  • 此工具会将条件值和字段组导入到数据集中,并可选择替换值或将新值与现有值进行组合。

  • 目标表的方案必须与要导入的值匹配。 如果 .csv 文件中指定的字段或值在目标数据集中并不存在,则不会导入字段组或条件值。

  • 如果目标表存储在企业级地理数据库中,则必须以数据所有者的身份运行此工具。

  • 此工具可以与导出条件值工具一起使用。

  • 将字段组添加到数据集之后,数据集版本将设置为 ArcGIS Pro 2.3。 这意味着该数据集将不再可用于 ArcMap

  • 字段组 .csv 文件包括 NAMEIS_RESTRICTIVEFIELD 列。 FIELD 列名称将根据需要进行递增,以包含字段组中的所有字段,例如 FIELD1FIELD2FIELD3 等。

    字段组 .csv 列

    描述示例

    NAME

    字段组名称

    AnimalCategories

    IS_RESTRICTIVE

    指定字段组是否具有限制性

    TRUE

    FIELD1

    字段的名称

    category

  • 条件值 .csv 文件包含以下列:CAV_ID IS_RETIREDFIELD_GROUPSUBTYPESUBTYPE_NAMECV_TYPECV_VALUEDESCRIPTION

    根据需要,会有足够多的 CV_TYPECV_VALUEDESCRIPTION 列与条件值定义的结构进行匹配。 这些列名称将根据需要进行递增(例如 CV_TYPE1CV_VALUE1DESCRIPTION1CV_TYPE2CV_VALUE2DESCRIPTION2 等)并将与字段组 .csv 文件中字段的顺序相对应。 例如,条件值 .csv 文件中的 CV_TYPE1CV_VALUE1DESCRIPTION1 将与字段组 .csv 文件中的 FIELD1 相对应。

    条件值 .csv 列

    描述示例

    CAV_ID

    条件值的 ID。

    1

    IS_RETIRED

    此布尔值用于定义条件值是否已停用。

    False

    FIELD_GROUP

    条件值所对应的字段组的名称。

    AnimalCategories

    SUBTYPE

    如果数据集具有子类型且子类型已用于条件值定义,则此字段是应用此规则的子类型代码。

    2

    SUBTYPE_NAME

    如果数据集具有子类型且子类型已用于条件值定义,则此字段为子类型代码的文本描述。

    Cold blooded

    CV_TYPE1

    条件值的类型。 类型值将存储为整数,如下所示:

    • 1 - 任意
    • 2 - 空
    • 3 - 编码值
    • 4 - 范围

    3

    CV_VALUE1

    特定字段值。 如果类型为任意或空,则 .csv 文件中的值为空。

    1

    DESCRIPTION1

    如果条件值类型为编码值,则此为编码值的文本描述。

    Fish

参数

标注说明数据类型
目标表

将向其中导入字段组和条件值的输入地理数据库表或要素类。

Table View
字段组输入文件 (.csv)

带有包含字段组相关信息的指定列名称.csv 文件。

File
条件值输入文件 (.csv)

带有包含条件值相关信息的指定列名称.csv 文件。

File
替换现有条件值
(可选)

指定导入时将替换还是合并现有值。

  • 选中 - 目标表的现有值将被替换为输入 .csv 文件中的值。
  • 未选中 - 现有值将与输入 .csv 文件中的值合并。 任何重复项都将被排除。 这是默认设置。

Boolean

派生输出

标注说明数据类型
已更新的表

包含所导入的字段组和条件值的已更新目标表。

Table View; Raster Layer; Mosaic Layer

arcpy.management.ImportContingentValues(target_table, field_group_file, contingent_value_file, {import_type})
名称说明数据类型
target_table

将向其中导入字段组和条件值的输入地理数据库表或要素类。

Table View
field_group_file

带有包含字段组相关信息的指定列名称.csv 文件。

File
contingent_value_file

带有包含条件值相关信息的指定列名称.csv 文件。

File
import_type
(可选)

指定导入时将替换还是合并现有值。

  • REPLACE目标表的现有值将被替换为输入 .csv 文件中的值。
  • UNION现有值将与输入 .csv 文件中的值合并。 任何重复项都将被排除。 这是默认设置。
Boolean

派生输出

名称说明数据类型
updated_table

包含所导入的字段组和条件值的已更新目标表。

Table View; Raster Layer; Mosaic Layer

代码示例

ImportContingentValues 示例(Python 窗口)

在 GasPipes 数据集中导入字段组和条件值,并替换现有值。

import arcpy
arcpy.management.ImportContingentValues("C:\\MyProject\\myConn.sde\\pro.USER1.Animals",
                                        "C:\\MyProject\\MyFieldGroups.csv",
                                        "C:\\MyProject\\MyContingentValues.csv",
                                        "REPLACE")

相关主题