アーカイブ履歴の切り取り (Trim Archive History) (データ管理)

サマリー

バージョン非対応の履歴管理が有効なデータセットから、廃止されたアーカイブ レコードを削除します。

編集履歴は保持されるため、テーブルのアーカイブ履歴は時間の経過に伴い指数的に増大します。 これは、ストレージとバックアップの管理に関する意思決定に影響します。また、システムに対してデータが非常に大きくなると、パフォーマンスに影響する可能性があります。 一部の組織は、バージョン非対応の履歴管理を使用しています。これは、特定の機能に必要ではあるが、履歴レコードの必要がないか重要でなくなった古いデータを削除したいためです。 このツールを使用すると、すべての廃止された行、または指定した日付より古い行を削除できます。

アーカイブ履歴の切り取りの詳細

使用法

  • このツールは、エンタープライズまたはモバイル ジオデータベースに格納されたデータセットのみをサポートしています。 以下のデータベースがサポートされています。

    • IBM Db2
    • Microsoft SQL Server
    • Oracle
    • PostgreSQL
    • SAP HANA

  • 入力テーブルは、履歴管理が有効である必要があります。

  • 入力テーブルは、バージョン非対応である必要があります。 バージョン対応テーブルはサポートされていません。

  • このツールを実行するには、データ所有者としてジオデータベースに接続する必要があります。

  • データセットが最後に切り取られた日付には、フィーチャクラスまたはテーブルのプロパティ ダイアログ ボックスからアクセスできます。

  • [入力テーブル] パラメーター値がフィーチャ サービスとして公開されて、オフラインでの使用が有効化され、[指定日よりも前を切り取り] パラメーター値が指定されていない場合、およびいずれかの行がそれらの行を同期処理していないレプリカによって参照されている場合、ツールは失敗します。 [指定日よりも前を切り取り] パラメーター値が指定されている場合、および廃止された行がそれらの行を同期処理していないレプリカによって参照されている場合は、[指定日よりも前を切り取り] 値より古い日付を指定するか、レプリカの登録を解除する必要があります。

パラメーター

ラベル説明データ タイプ
入力テーブル

切り取るアーカイブ履歴があるバージョン非対応の履歴管理が有効なテーブル。

Table View
切り取りモード

アーカイブ履歴の切り取りに使用される切り取りモードを指定します。

  • 削除アーカイブ レコードが削除されます。
注意:

現在のバージョンの ArcGIS Pro では、削除切り取りモードのみが使用できます。

String
指定日よりも前を切り取り
(オプション)

この日付と時刻より古いアーカイブ レコードが削除されます。 この日時は UTC で指定する必要があります。 日付が指定されていない場合は、すべてのアーカイブ レコードが削除されます。

Date

派生した出力

ラベル説明データ タイプ
出力テーブル

アーカイブ履歴が切り取られた状態の、更新された入力テーブル。

Table

arcpy.management.TrimArchiveHistory(in_table, trim_mode, {trim_before_date})
名前説明データ タイプ
in_table

切り取るアーカイブ履歴があるバージョン非対応の履歴管理が有効なテーブル。

Table View
trim_mode

アーカイブ履歴の切り取りに使用される切り取りモードを指定します。

注意:

現在のバージョンの ArcGIS Pro では、削除切り取りモードのみが使用できます。

  • DELETEアーカイブ レコードが削除されます。
String
trim_before_date
(オプション)

この日付と時刻より古いアーカイブ レコードが削除されます。 この日時は UTC で指定する必要があります。 日付が指定されていない場合は、すべてのアーカイブ レコードが削除されます。

Date

派生した出力

名前説明データ タイプ
out_table

アーカイブ履歴が切り取られた状態の、更新された入力テーブル。

Table

コードのサンプル

TrimArchiveHistory (アーカイブ履歴の切り取り) の例 (Python ウィンドウ)

指定した日付と時刻より古いテーブルのアーカイブ レコードを削除します。

import arcpy
arcpy.management.TrimArchiveHistory("C:\\MyProject\\myGdb.sde\\mydatabase.user1.Parcels", 
                                    "DELETE", "2020/03/10 10:28:56 AM")

環境

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

ライセンス情報

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

関連トピック