导入条件值 (数据管理)

摘要

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

使用情况

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

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

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

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

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

• 字段组 .csv 文件包括 NAME、IS_RESTRICTIVE 和 FIELD 列。FIELD 列名称将根据需要进行递增，以包含字段组中的所有字段，例如 FIELD1、FIELD2、FIELD3 等等。

  字段组 .csv 列

  列	描述	示例
  NAME	字段组名称	AnimalCategories
  IS_RESTRICTIVE	指定字段组是否具有限制性	TRUE
  FIELD1	字段的名称	类别

• 条件值 .csv 文件包括以下列：CAV_ID、 IS_RETIRED、FIELD_GROUP、SUBTYPE、SUBTYPE_NAME、CV_TYPE、CV_VALUE 和 DESCRIPTION。

  根据需要，会有足够多的 CV_TYPE、CV_VALUE 和 DESCRIPTION 列与条件值定义的结构进行匹配。这些列名称将根据需要进行递增（例如 CV_TYPE1、CV_VALUE1、DESCRIPTION1、CV_TYPE2、CV_VALUE2、DESCRIPTION2 等等）并将与字段组 .csv 文件中字段的顺序相对应。例如，条件值 .csv 文件中的 CV_TYPE1、CV_VALUE1 和 DESCRIPTION1 将与字段组 .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

派生输出

标注	说明	数据类型
已更新的表	包含所导入的字段组和条件值的已更新目标表。	表视图；栅格图层；镶嵌图层

Python

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	包含所导入的字段组和条件值的已更新目标表。	表视图；栅格图层；镶嵌图层

代码示例

ImportContingentValues 示例（Python 窗口）

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

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

环境

当前工作空间

特殊情况

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是