Сводка
Сравнивает две таблицы или два представления таблицы.
Использование
Этот инструмент выдает сообщение с результатами сравнения. По умолчанию этот инструмент завершает работу и выдает результат после обнаружения первого несоответствия при сравнении. Чтобы получить информацию о всех различиях, отметьте параметр Продолжить сравнение.
Сравнить таблицы может сообщать о различиях и сходствах в табличных значениях и определениях полей.
Могут быть определены несколько полей для сортировки. И Исходная таблица и Тестовая таблица сортируются на основе заданных полей. Сортируется первое поле, затем второе, и т.д. в порядке возрастания. Сортировка по общему полю и в исходной и в тестовой таблице гарантирует, что вы сравниваете ту же строку из каждого набора данных.
-
По умолчанию установлен тип сравнения All (ALL в Python). Это означает, что будут проверены все свойства сравниваемых таблиц, включая такие, как свойства и атрибуты полей. Однако, вы можете выбрать другой тип сравнения, чтобы проверять только конкретные свойства сравниваемых таблиц.
Параметр Игнорировать позволяет пропускать определенные свойства при сравнении. К ним относятся свойства расширения, подтипы и классы отношений.
При пропуске, поля, которые не включены в сравнение подсчета полей, а также определения полей и табличные значения для этих полей игнорируются.
Атрибутивные допуски могут быть определены только для числовых типов полей.
Выходной файл сравнения будет содержать все сходства и различия между Исходной таблицей и Тестовой таблицей. Это текстовый файл с запятой в качестве разделителя, который можно просмотреть и использовать как таблицу в ArcGIS. Например, эта таблица может требоваться для получения значений ObjectID для всех строк, которые различаются.
При использовании этого инструмента в Python вы можете получить статус инструмента, используя синтаксис result.getOutput(1). Значение будет равно '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})| Parameter | Объяснение | Тип данных |
in_base_table | С Исходной таблицей сопоставляется Тестовая таблица. Исходная таблица соответствует данным, которые считаются корректными. Исходная таблица – это таблица, имеющая корректный набор атрибутивных полей и их значений. | Table View; Raster Layer |
in_test_table | Тестовая таблица сопоставляется с Исходной таблицей. Тестовая таблица соответствует данным, в которые внесены изменения при редактировании или компиляции новых полей, новых записей или новых значений атрибутов. | Table View ; Raster Layer |
sort_field [sort_field,...] | Одно или несколько полей, используемые для сортировки записей в Исходной таблице и Тестовой таблице. Записи сортируются по возрастанию. Сортировка по общему для обеих таблиц (Исходной таблицы и Тестовой таблицы) полю гарантирует, что сравнивается одна и та же строка из каждой входной базы данных. | Value Table |
compare_type (Дополнительный) | Тип сравнения. ВСЕ используется по умолчанию. По умолчанию будут сравниваться все свойства таблиц.
| String |
ignore_options [ignore_options,...] (Дополнительный) | Эти свойства не будут сравниваться.
| String |
attribute_tolerances [[Field, {Tolerance}],...] (Дополнительный) | Диапазон, в котором значения будут считаться идентичными. Используется только для числовых полей. | Value Table |
omit_field [omit_field,...] (Дополнительный) | Одно или несколько полей, которые будут пропущены в процессе сравнения. Свойства и значения данных полей будут проигнорированы. | String |
continue_compare (Дополнительный) | Определяет необходимость продолжения сравнения после обнаружения первого несовпадения.
| Boolean |
out_compare_file (Дополнительный) | Данный файл будет хранить информацию обо всех совпадениях и отличиях Исходного файла (in_base_table) и Тестового файла (in_test_table). Это текстовый файл с запятой в качестве разделителя, который можно просмотреть и использовать как таблицу в ArcGIS. | File |
Производные выходные данные
| Name | Объяснение | Тип данных |
| compare_status | Статус сравнения будет равно 'true', если не было найдено различий, и 'false' – если различия были обнаружены. | Boolean |
Пример кода
Пример скрипта окна 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 в автономном скрипте.
# 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)Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да