Comparar tabla (Administración de datos)

Resumen

Compara dos tablas o vistas de tabla y devuelve los resultados de la comparación.

Uso

  • Esta herramienta devuelve mensajes que muestran el resultado de la comparación. La ejecución de la herramienta se detendrá de forma predeterminada cuando encuentre la primera diferencia entre las entradas. Para informar de todas las diferencias, active el parámetro Continuar comparación.

  • Si las diferencias notificadas entre los datasets de entrada se deben a la adición o eliminación de registros, solo es válida la primera diferencia notificada. Todas las diferencias que se notifiquen después de la adición o eliminación se deberán a la comparación carente de secuencia. Las herramientas de comparación no intentan encontrar el siguiente conjunto de registros coincidentes después de que se encuentre un registro agregado o eliminado.

  • Esta herramienta puede informar diferencias y similitudes con valores tabulares y definiciones de campo.

  • Se pueden especificar múltiples campos de ordenamiento. Tanto los valores del parámetro Tabla base de entrada como del parámetro Tabla test de entrada se ordenan en función de los campos que especifica. Se ordena el primer campo, luego el segundo campo, y así sucesivamente, en orden ascendente. El ordenamiento por campo común en la tabla base y la tabla test asegura que se está comparando la misma fila de cada dataset de entrada.

  • De forma predeterminada, el parámetro Tipo de comparación se establece en Todo. Esto significa que se verificarán todas las propiedades de las tablas que se están comparando, incluidos atributos y propiedades de campo. Especifique un tipo de comparación diferente para comparar propiedades concretas.

  • El parámetro Ignorar opciones proporciona la posibilidad de omitir propiedades de la comparación. Éstas incluyen propiedades de extensión, subtipos y clases de relación.

  • Cuando se omiten campos que no están incluidos en la comparación de recuento de campo, se ignoran las definiciones de campo y los valores tabulares para esos campos.

  • Las tolerancias de atributos sólo se pueden especificar para los tipos de campos numéricos.

  • El valor del parámetro Archivo de comparación de salida tendrá registradas todas las similitudes y diferencias entre los valores de los parámetros Tabla base de entrada y Tabla test de entrada. Este archivo es un archivo de texto delimitado por comas que se puede ver y utilizar como una tabla en ArcGIS. Por ejemplo, se puede consultar para obtener todos los valores de Id. de objeto para todas las filas que sean diferentes.

  • Cuando utilice esta herramienta en Python, obtenga el estado de la comparación a partir del objeto Result devuelto mediante el empleo de la posición de índice de 1 (result[1]). El valor será 'true' si no se encuentra ninguna diferencia y 'false' si se detecta alguna diferencia.

    Más información sobre el uso de herramientas en Python

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla base de entrada

Datos que se compararán con el valor del parámetro Tabla test de entrada. El valor de este parámetro son los datos que ha declarado válidos. Estos datos base tienen el contenido y la información correctos.

Table View; Raster Layer
Tabla test de entrada

Datos que se compararán con el valor del parámetro Tabla base de entrada. El valor de este parámetro son los datos que modificó al editar o compilar información nueva.

Table View ; Raster Layer
Campo de ordenamiento

Campo o campos que se utilizarán para ordenar registros en las entradas. Los registros se clasifican en orden ascendente. El ordenamiento por campo común en ambas entradas asegura que se está comparando la misma fila de cada dataset de entrada.

Value Table
Comparar tipo
(Opcional)

Especifica el tipo de comparación que se utilizará.

  • TodoSe compararán todas las propiedades. Esta es la opción predeterminada.
  • Solo atributosSólo se compararán los atributos y sus valores.
  • Solo esquemaSolo se comparará el esquema.
String
Ignorar opciones
(Opcional)

Especifica las propiedades de la tabla que no se compararán.

  • Ignorar propiedades de extensiónLas propiedades de extensión no se compararán.
  • Ignorar subtiposLos subtipos no se compararán.
  • Ignorar clases de relaciónLas clases de relación no se compararán.
  • Ignorar alias de campoLos alias de campo no se compararán.
String
Tolerancia de atributo
(Opcional)

Valor numérico que determinará el rango en el cual los valores de atributos se consideran iguales. Este parámetro solo se aplica a los tipos de campos numéricos.

Value Table
Omitir campos
(Opcional)

El campo o los campos que se omitirán durante la comparación. Se ignorarán las definiciones de campo y los valores tabulares para estos campos.

String
Continuar comparación
(Opcional)

Especifica si la comparación continuará tras encontrar la primera diferencia entre las entradas.

  • Desactivado: la herramienta se detendrá tras encontrar la primera diferencia. Esta es la opción predeterminada.
  • Activado: la herramienta continuará tras encontrar la primera diferencia.

Boolean
Archivo de comparación de salida
(Opcional)

Archivo de salida que contendrá todas las similitudes y diferencias entre las entradas. Este archivo es un archivo de texto delimitado por comas que se puede ver y utilizar como una tabla en ArcGIS.

Archivo de salida que contendrá todas las similitudes y diferencias entre las entradas. Este archivo es un archivo de texto delimitado por comas que se puede ver y utilizar como una tabla en ArcGIS.

File

Salida derivada

EtiquetaExplicaciónTipo de datos
Estado de comparación

El estado de comparación será 'true' cuando no se encuentren diferencias y 'false' cuando se encuentren diferencias.

Boolean

arcpy.management.TableCompare(in_base_table, in_test_table, sort_field, {compare_type}, {ignore_options}, {attribute_tolerances}, {omit_field}, {continue_compare}, {out_compare_file})
NombreExplicaciónTipo de datos
in_base_table

Datos que se compararán con el valor del parámetro in_test_table. El valor de este parámetro son los datos que ha declarado válidos. Estos datos base tienen el contenido y la información correctos.

Table View; Raster Layer
in_test_table

Datos que se compararán con el valor del parámetro in_base_table. El valor de este parámetro son los datos que modificó al editar o compilar información nueva.

Table View ; Raster Layer
sort_field
[sort_field,...]

Campo o campos que se utilizarán para ordenar registros en las entradas. Los registros se clasifican en orden ascendente. El ordenamiento por campo común en ambas entradas asegura que se está comparando la misma fila de cada dataset de entrada.

Value Table
compare_type
(Opcional)

Especifica el tipo de comparación que se utilizará.

  • ALLSe compararán todas las propiedades. Esta es la opción predeterminada.
  • ATTRIBUTES_ONLYSólo se compararán los atributos y sus valores.
  • SCHEMA_ONLYSolo se comparará el esquema.
String
ignore_options
[ignore_options,...]
(Opcional)

Especifica las propiedades de la tabla que no se compararán.

  • IGNORE_EXTENSION_PROPERTIESLas propiedades de extensión no se compararán.
  • IGNORE_SUBTYPESLos subtipos no se compararán.
  • IGNORE_RELATIONSHIPCLASSESLas clases de relación no se compararán.
  • IGNORE_FIELDALIASLos alias de campo no se compararán.
String
attribute_tolerances
[[Field, {Tolerance}],...]
(Opcional)

Valor numérico que determinará el rango en el cual los valores de atributos se consideran iguales. Este parámetro solo se aplica a los tipos de campos numéricos.

Value Table
omit_field
[omit_field,...]
(Opcional)

El campo o los campos que se omitirán durante la comparación. Se ignorarán las definiciones de campo y los valores tabulares para estos campos.

String
continue_compare
(Opcional)

Especifica si la comparación continuará tras encontrar la primera diferencia entre las entradas.

  • NO_CONTINUE_COMPARELa herramienta se detendrá tras encontrar la primera diferencia. Esta es la opción predeterminada.
  • CONTINUE_COMPARELa herramienta continuará tras encontrar la primera diferencia.
Boolean
out_compare_file
(Opcional)

Archivo de salida que contendrá todas las similitudes y diferencias entre las entradas. Este archivo es un archivo de texto delimitado por comas que se puede ver y utilizar como una tabla en ArcGIS.

File

Salida derivada

NombreExplicaciónTipo de datos
compare_status

El estado de comparación será 'true' cuando no se encuentren diferencias y 'false' cuando se encuentren diferencias.

Boolean

Muestra de código

Ejemplo 1 de TableCompare (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función TableCompare de modo inmediato.

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')
Ejemplo 2 de TableCompare (script independiente)

El siguiente ejemplo muestra cómo utilizar la función TableCompare en un script independiente.

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

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados