表比较 (数据管理)

摘要

对两个表或表视图进行比较并返回比较结果。

使用情况

• 此工具将返回显示比较结果的消息。默认情况下，此工具将在遇到第一个比较不匹配后停止执行。要报告所有差异，请选中继续比较参数。

• 表比较可以对表格值和字段定义方面存在的异同进行报告。

• 可以指定多个排序字段。输入基础表和输入测试表都根据指定的字段进行排序。先排序第一个字段，然后排序第二个字段，依此类推（以升序排列）。在基础表和测试表中均按共用字段进行排序，可确保对每个输入数据集中相同的行进行比较。

• 如果忽略未包含在字段计数比较中的字段，则会忽略这些字段的字段定义和表格值。

• 只能为数值字段类型指定属性容差。

• 输出比较文件将包含输入基础表和输入测试表之间的所有异同点。该文件是一个以逗号分隔的文本文件，在 ArcGIS 中可以表的形式对其进行查看和使用。例如，可通过查询该表获得存在差异的所有行的所有 ObjectID 值。

• 在 Python 中使用此工具时，可通过 result.getOutput(1) 获取此工具的状态。未检测到差异时将显示 'true' 值；检测到差异时将显示 'false' 值。

  了解有关在 Python 中使用工具的详细信息

参数

对话框

标注	说明	数据类型
输入基础表	将输入基础表与输入测试表进行比较。输入基础表是指已被声明为有效的表格数据。该基础数据具有正确的字段定义和属性值。	Table View; Raster Layer
输入测试表	将输入测试表与输入基础表进行比较。输入测试表是指已通过编辑或编译新的字段、新的记录或新的属性值而进行更改的数据。	Table View ; Raster Layer
排序字段	用于在输入基础表和输入测试表中对记录进行排序的一个或多个字段。记录将以升序进行排序。在输入基础表与输入测试表中均按公用字段进行排序，可确保对每个输入数据集中相同的行进行比较。	Value Table
比较类型 (可选)	比较类型。默认设置为 ALL。该默认设置将对要比较的表中的所有属性进行比较。 ALL—比较所有属性。这是默认设置。 ATTRIBUTES_ONLY—仅比较属性及其值。 SCHEMA_ONLY—仅比较方案。	String
忽略选项 (可选)	不会对这些属性进行比较。 IGNORE_EXTENSION_PROPERTIES—不比较扩展属性。 IGNORE_SUBTYPES—不比较子类型。 IGNORE_RELATIONSHIPCLASSES—不比较关系类。 IGNORE_FIELDALIAS—不比较字段别名。	String
属性容差 (可选)	在该数值范围内的属性值将被视作相同。它仅适用于数值字段类型。	Value Table
忽略字段 (可选)	在比较过程中将被忽略的一个或多个字段。这些字段的字段定义和表格值将被忽略。	String
继续比较 (可选)	指示在遇到第一个不匹配项后是否继续比较所有属性。 未选中 - 在遇到第一个不匹配项后即停止比较。这是默认设置。 选中 - 在遇到第一个不匹配项后继续比较其他属性。	Boolean
输出比较文件 (可选)	该文件将包含输入基础表和输入测试表之间的所有异同点。该文件是一个以逗号分隔的文本文件，在 ArcGIS 中可以表的形式对其进行查看和使用。	File

派生输出

标注	说明	数据类型
比较状态	未检测到差异时比较状态将为 'true'；检测到差异时比较状态将为 'false'。	布尔型

Python

arcpy.management.TableCompare(in_base_table, in_test_table, sort_field, {compare_type}, {ignore_options}, {attribute_tolerances}, {omit_field}, {continue_compare}, {out_compare_file})

名称	说明	数据类型
in_base_table	将输入基础表与输入测试表进行比较。输入基础表是指已被声明为有效的表格数据。该基础数据具有正确的字段定义和属性值。	Table View; Raster Layer
in_test_table	将输入测试表与输入基础表进行比较。输入测试表是指已通过编辑或编译新的字段、新的记录或新的属性值而进行更改的数据。	Table View ; Raster Layer
sort_field [sort_field,...]	用于在输入基础表和输入测试表中对记录进行排序的一个或多个字段。记录将以升序进行排序。在输入基础表与输入测试表中均按公用字段进行排序，可确保对每个输入数据集中相同的行进行比较。	Value Table
compare_type (可选)	比较类型。默认设置为 ALL。该默认设置将对要比较的表中的所有属性进行比较。 ALL—比较所有属性。这是默认设置。 ATTRIBUTES_ONLY—仅比较属性及其值。 SCHEMA_ONLY—仅比较方案。	String
ignore_options [ignore_options,...] (可选)	不会对这些属性进行比较。 IGNORE_EXTENSION_PROPERTIES—不比较扩展属性。 IGNORE_SUBTYPES—不比较子类型。 IGNORE_RELATIONSHIPCLASSES—不比较关系类。 IGNORE_FIELDALIAS—不比较字段别名。	String
attribute_tolerances [[Field, {Tolerance}],...] (可选)	在该数值范围内的属性值将被视作相同。它仅适用于数值字段类型。	Value Table
omit_field [omit_field,...] (可选)	在比较过程中将被忽略的一个或多个字段。这些字段的字段定义和表格值将被忽略。	String
continue_compare (可选)	指示在遇到第一个不匹配项后是否继续比较所有属性。 NO_CONTINUE_COMPARE—在遇到第一个不匹配项后即停止比较。这是默认设置。 CONTINUE_COMPARE—在遇到第一个不匹配项后继续比较其他属性。	Boolean
out_compare_file (可选)	该文件将包含 in_base_table 与 in_test_table 之间所有的异同处。该文件是一个以逗号分隔的文本文件，在 ArcGIS 中可以表的形式对其进行查看和使用。	File

派生输出

名称	说明	数据类型
compare_status	未检测到差异时比较状态将为 'true'；检测到差异时比较状态将为 'false'。	布尔型

代码示例

TableCompare 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 TableCompare 函数。

import arcpy
arcpy.TableCompare_management(
    r'c:\Workspace\wells.dbf', r'c:\Workspace\wells_new.dbf', 'WELL_ID', 
    'ALL', 'IGNORE_EXTENSION_PROPERTIES', 'WELL_DEPTH 0.001', '#', 
    'CONTINUE_COMPARE', r'C:\Workspace\well_compare.txt')

TableCompare 示例 2（独立脚本）

如何在独立脚本中使用 TableCompare 工具的示例。

# Name: TableCompare.py
# Description: Compare two dBASE tables and return comparison result.
# import system modules 
import arcpy
# Set local variables
base_table= "C:/Workspace/wells.dbf"
test_table = "C:/Workspace/wells_new.dbf"
sort_field = "WELL_ID"
compare_type = "ALL"
ignore_option = "IGNORE_EXTENSION_PROPERTIES"
attribute_tolerance = "WELL_DEPTH 0.001"
omit_field = "#"
continue_compare = "CONTINUE_COMPARE"
compare_file = "C:/Workspace/well_compare.txt"
# Process: FeatureCompare
compare_result = arcpy.TableCompare_management(
    base_table, test_table, sort_field, compare_type, ignore_option, 
    attribute_tolerance, omit_field, continue_compare, compare_file)

环境

当前工作空间