表比较 (数据管理)

摘要

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

使用情况

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

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

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

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

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

  • 输出比较文件将包含输入基础表输入测试表之间的所有异同点。该文件是一个以逗号分隔的文本文件,在 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'

布尔型

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_tablein_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)