ブランチ履歴の切り取り (Prune Branch History) (データ管理)—ArcGIS AllSource

サマリー

ブランチバージョン対応のデータセットから、廃止されたアーカイブレコードを削除します。

使用法

[日付より前をプルーン] パラメーター値が指定されていない場合、ツールは、基準となるモーメントに基づき、可能な限り多くのアーカイブ履歴をプルーンします。 [日付より前をプルーン] パラメーター値が指定されている場合、そのモーメントまでのすべての行が削除されます。
バージョンまたはレプリカが、指定されたプルーン日以前のモーメントを参照しているために [日付より前をプルーン] パラメーター値が無効な場合は、警告メッセージが表示されます。出力ログには、使用できる最も古いモーメントが示され、ツールをブロックしたモーメントとバージョンが含まれます。
参照したモーメントの詳細
[入力データセット] パラメーター値のジオデータベース接続のバージョニングタイプをブランチに設定する必要があります。
入力データセットはブランチバージョン対応登録されている必要があります。
ツールは、データ所有者のみが実行できます。
[入力データセット] パラメーター値には、フィーチャクラス、フィーチャデータセット、またはテーブルを指定できます。入力がフィーチャデータセットの場合、そのデータセットのすべてのフィーチャクラスと、フィーチャデータセット外の関連データが処理されます。ただし、別のフィーチャデータセットのデータは処理されません。
フィーチャクラスがフィーチャデータセットにある場合、フィーチャデータセットを入力として使用します。
このツールを実行するには、排他スキーマロックが必要です。入力データを参照するサービスは、ArcGIS Server Manager を使用して停止する必要があります。

パラメーター

ラベル	説明	データタイプ
入力データセット	プルーンされるフィーチャクラス、フィーチャデータセット、またはテーブル。	Table View; Feature Dataset
出力ログファイル	プルーンされた、またはプルーンされるフィーチャクラスとテーブルを示すログファイル。出力ファイルには、リクエストされた「日付より前をプルーン」を使用できないようにしたレプリカとバージョンも表示されます。	File
レポートのみ (オプション)	対象のアーカイブレコードがレポートされるか、プルーンされるかを指定します。オン - 対象のアーカイブレコードの数がログファイルに示され、プルーンされません。これがデフォルトです。オフ - 対象のアーカイブレコードはプルーンされます。	Boolean
システムテーブルのみをプルーン	対象の内部テーブルのみをレポートするか、プルーンするかを指定します。オン - エクステンションデータセットで、対象となる内部テーブルのみがプルーンされるか、ログファイルに示されます。オフ - 対象となるすべてのテーブルがプルーンされるか、ログファイルに示されます。これがデフォルトです。	Boolean
日付より前をプルーン (オプション)	所定の日付と時刻より古いアーカイブレコードをプルーンします。この日時は UTC で指定する必要があります。日付が指定されていない場合、データベースにおいて、参照された最も古いモーメントが使用されます。	Date

派生した出力

ラベル	説明	データタイプ
出力データセット	更新されたデータセット。	Table View; Feature Dataset

arcpy.management.PruneBranchHistory(in_dataset, out_log, {report_only}, system_tables_only, {prune_before_date})

名前	説明	データタイプ
in_dataset	プルーンされるフィーチャクラス、フィーチャデータセット、またはテーブル。	Table View; Feature Dataset
out_log	プルーンされた、またはプルーンされるフィーチャクラスとテーブルを示すログファイル。出力ファイルには、リクエストされた「日付より前をプルーン」を使用できないようにしたレプリカとバージョンも表示されます。	File
report_only (オプション)	対象のアーカイブレコードがレポートされるか、プルーンされるかを指定します。 REPORT_ONLY—対象のアーカイブレコードがログファイルに示され、プルーンされません。これがデフォルトです。 PRUNE—対象のアーカイブレコードはプルーンされます。	Boolean
system_tables_only	対象の内部テーブルのみをレポートするか、プルーンするかを指定します。 SYSTEM_ONLY—エクステンションデータセットで、対象となる内部テーブルのみがプルーンされるか、ログファイルに示されます。 ALL_TABLES—対象となるすべてのテーブルがプルーンされるか、ログファイルに示されます。これがデフォルトです。	Boolean
prune_before_date (オプション)	所定の日付と時刻より古いアーカイブレコードをプルーンします。この日時は UTC で指定する必要があります。日付が指定されていない場合、データベースにおいて、参照された最も古いモーメントが使用されます。	Date

派生した出力

名前	説明	データタイプ
out_dataset	更新されたデータセット。	Table View; Feature Dataset

コードのサンプル

PruneBranchHistory の例 (Python ウィンドウ)

所定の日付と時刻より古いクラスのアーカイブレコードをプルーンします。

import arcpy
arcpy.management.PruneBranchHistory(
    in_dataset="feature_class",
				out_log=r"C:Projects\prune_data\testing",
    trim_before_date="1/15/2025 10:46:25 AM",
    report_only=False,
				system_tables_only="SYSTEM_ONLY"
)

環境

このツールは、ジオプロセシング環境を使用しません。

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

関連トピック

このトピックの内容