テーブル比較 (Table Compare) (データ管理)

サマリー

2 つのテーブルおよびテーブル ビューを比較して、比較結果を返します。

使用法

• このツールは、比較結果を示すメッセージを返します。 デフォルトでは、ツールは入力間の最初の相違点を検出した後に実行を停止します。 相違点をすべてレポートする場合は、[比較を継続] パラメーターをオンにします。

• 入力データセット間でレポートされた相違点の原因がレコードの追加または削除である場合、最初にレポートされた相違点のみが有効です。 追加または削除後にレポートされたすべての相違点は、比較の順序が間違っていることが原因となります。 比較ツールは、追加または削除されたレコードを検出した後、次の一致するレコード セットを検出しようとはしません。

• このツールは、テーブル値とフィールド定義の相違点をレポートできます。

• 複数の並べ替えフィールドを指定できます。 指定するフィールドに基づいて、[入力ベース テーブル] パラメーター値および [入力テスト テーブル] パラメーター値が並べ替えられます。 最初のフィールドが並べ替えられたら、2 番目のフィールドが並べ替えられ、以降、昇順で並べ替えが行われます。 ベース テーブルとテスト テーブルの両方にある共通フィールドで並べ替えることにより、各入力データセットの同じ行を比較することができます。

• デフォルトでは、[比較するタイプ] パラメーターは [すべて] に設定されます。 つまり、フィールドのプロパティや属性などを含め、比較されるテーブルのすべてのプロパティがオンになります。 特定のプロパティを比較するには、異なる比較タイプを指定します。

• [比較対象外のプロパティ] パラメーターは、比較からプロパティを除外する柔軟性を提供します。 これらのプロパティには、拡張プロパティ、サブタイプ、およびリレーションシップ クラスが含まれます。

• フィールド数の比較に含まれていないフィールドを除外すると、これらのフィールドのフィールド定義とテーブル値は無視されます。

• 属性許容値は、数値フィールド タイプにのみ指定できます。

• [出力比較ファイル] パラメーター値には、[入力ベース テーブル] パラメーター値および [入力テスト テーブル] パラメーター値の間のすべての類似点と相違点が含まれます。 このファイルは、ArcGIS でテーブルとして表示および使用できる、カンマ区切りテキスト ファイルです。 たとえば、これを検索して、差異のあるすべての行のすべての ObjectID 値を取得できます。

• このツールを Python で使用する場合、1 のインデックス位置 (result[1]) を使用して、返された Result オブジェクトから比較状況を取得します。 相違点が検出されない場合は値が '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: Yes
• Standard: Yes
• Advanced: Yes