Comparaison de tables (Gestion des données)
Récapitulatif
Compare deux tables ou vues tabulaires et renvoie les résultats de la comparaison. Cet outil peut signaler les différences et similitudes présentes sur le plan des valeurs tabulaires et des définitions de champs.
Utilisation
-
L'outil renvoie des messages qui affichent le résultat de la comparaison. Par défaut, l'outil cesse de s'exécuter dès lors qu'il rencontre la première erreur de comparaison. Pour rapporter toutes les différences, activez l'option Continuer la comparaison.
-
Plusieurs champs de tri peuvent être spécifiés. La Table de base en entrée et la Table test en entrée sont triées toutes les deux selon les champs que vous spécifiez. Le premier champ est trié, puis le deuxième champ, et ainsi de suite, dans l'ordre croissant. Le fait de spécifier un champ de tri commun à la table de base et à la table test vous garantit de comparer la même ligne de chaque jeu de données en entrée.
-
Par défaut, le type de comparaison est défini sur ALL (tout). Cela signifie toutes les propriétés des tables qui sont comparées seront activées, y compris les propriétés du champ et les attributs. Toutefois, vous pouvez choisir un type de comparaison différent pour activer uniquement des propriétés spécifiques des tables comparées.
-
L'option Ignorer les options permet d'omettre certaines propriétés dans la comparaison. Ces propriétés comprennent les propriétés d'extension, les sous-types et les classes de relations.
-
Lorsque vous omettez des champs qui ne sont pas inclus dans le compte des champs de la comparaison, les définitions de champ et les valeurs tabulaires pour ces champs sont ignorées.
-
Les tolérances attributaires ne peuvent être spécifiées que pour les types de champ numérique.
-
Le Fichier de comparaison en sortie contiendra toutes les similitudes et toutes les différences trouvées entre la Table de base en entrée et la Table test en entrée. Il s'agit d'un fichier texte délimité par des virgules qui peut être visualisé et utilisé comme table dans ArcGIS. Par exemple, cette table peut être interrogée pour obtenir toutes les valeurs ObjectID de tous les enregistrements différents.
-
L'objet de résultat des outils de comparaison sera 'vrai' lorsque aucune différence n'est trouvée, et 'faux' lorsque des différences sont détectées.
Syntaxe
| Paramètre | Explication | Type de données |
in_base_table |
La Table de base en entrée est comparée à la Table test en entrée. La Table de base en entrée est celle qui contient vos données tabulaires déclarées valides. Les définitions de champs et les valeurs d'attributs de cette table de base sont correctes. | Table View; Raster Layer |
in_test_table |
La Table test en entrée est comparée à la Table de base en entrée. La Table test en entrée contient vos données modifiées par l'ajout de nouveaux champs, de nouveaux enregistrements ou de nouvelles valeurs attributaires. | Table View ; Raster Layer |
sort_field [sort_field,...] |
Le ou les champs utilisés pour trier les enregistrements de la Table de base en entrée et de la Table test en entrée. Les enregistrements sont triés dans l'ordre croissant. Le fait de spécifier un champ de tri commun à la Table de base en entrée et à la Table test en entrée vous garantit de comparer la même ligne de chaque jeu de données en entrée. | Value Table |
compare_type (Facultatif) |
Type de comparaison. ALL est le format par défaut. Cette option par défaut compare toutes les propriétés des tables concernées.
| String |
ignore_options (Facultatif) |
Ces propriétés ne seront pas comparées lors du processus de comparaison.
| String |
attribute_tolerances [[Field, {Tolerance}],...] (Facultatif) |
Valeur numérique déterminant la plage dans laquelle les valeurs attributaires sont considérées comme égales. Ce paramètre s'applique uniquement aux champs numériques. | Value Table |
omit_field [omit_field,...] (Facultatif) |
Champ(s) à omettre lors de la comparaison. Les définitions et valeurs tabulaires de ces champs seront ignorées. | String |
continue_compare (Facultatif) |
Indique s'il faut comparer toutes les propriétés dès lors qu'une première erreur de correspondance est rencontrée.
| Boolean |
out_compare_file (Facultatif) |
Ce fichier contiendra toutes les similitudes et différences entre la Table de base en entrée et la Table test en entrée. Il s'agit d'un fichier texte délimité par des virgules qui peut être visualisé et utilisé comme table dans ArcGIS. | File |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction TableCompare dans une table en mode immédiat.
import arcpy from arcpy import env 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' )
Exemple d'utilisation de la fonction TableCompare dans un script autonome.
# Name: TableCompare.py
# Description: Compare two dBASE tables and return comparison result.
# Author: ESRI
# import system modules
import arcpy
try:
# 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)
print compare_result
print arcpy.GetMessages()
except:
# Print error message if an error occurs
print arcpy.GetMessages()