表比较 (数据管理)

摘要

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

使用情况

• 此工具将返回显示比较结果的消息。 默认情况下，在找到输入之间的第一个差异时，该工具将停止运行。 要报告所有差异，请选中继续比较参数。

• 如果报告的输入数据集差异由记录的增加或删除导致，则仅报告的第一个差异有效。 在此工具遇到增加或删除的记录后，报告的所有差异均由比较错位导致。 比较工具在遇到新增或删除的记录后，不会尝试查找下一组匹配的记录。

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

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

• 默认情况下，比较类型参数设置为全部。 这表示进行比较的表的所有属性都将被选中，包括字段属性和特性。 指定不同的比较类型，以对特定属性进行比较。

• 忽略选项参数提供了更大的灵活性，它允许在比较时忽略某些属性。 这些属性包括扩展属性、子类型和关系类。

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

• 仅可为数值字段类型指定属性容差。

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

• 在 Python 中使用此工具时，通过返回的 Result 对象（使用索引位置 1）获取比较状态。(result[1])。 此工具未检测到差异时将显示 'true' 值，检测到差异时将显示 'false' 值。

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

参数

对话框

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

派生输出

标注	说明	数据类型
比较状态	未找到差异时，比较状态将为 'true'，找到差异时，比较状态将为 'false'。	Boolean

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	这是将与 in_test_table 参数值进行比较的数据。 此参数值是您已声明为有效的数据。 此基础数据包含正确的内容和信息。	Table View; Raster Layer
in_test_table	这是将与 in_base_table 参数值进行比较的数据。 此参数值是因编辑或编译新信息而进行更改的数据。	Table View ; Raster Layer
sort_field [sort_field,...]	这是将用于对输入记录进行排序的一个或多个字段。 记录将以升序进行排序。 在两个输入中均按公用字段进行排序，可确保对每个输入数据集中相同的行进行比较。	Value Table
compare_type (可选)	指定将使用的比较类型。 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 (可选)	该输出文件将包含输入之间的所有异同点。 该文件是一个以逗号分隔的文本文件，在 ArcGIS 中可以表的形式对其进行查看和使用。	File

派生输出

名称	说明	数据类型
compare_status	未找到差异时，比较状态将为 'true'，找到差异时，比较状态将为 'false'。	Boolean

代码示例

TableCompare 示例 1（Python 窗口）

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

import arcpy
arcpy.management.TableCompare(
    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.management.TableCompare(
    base_table, test_table, sort_field, compare_type, ignore_option, 
    attribute_tolerance, omit_field, continue_compare, compare_file)

环境

当前工作空间

许可信息

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