ブランチ履歴のプルーン

ArcGIS Pro では、ブランチ履歴という概念は、ジオデータベース内でブランチバージョン対応登録されたデータセットに加えられた変更の詳細な記録を表します。それぞれの変更 (挿入、更新、削除) は、ビジネステーブルに新しいエントリーとして記録されます。このように変更を綿密に追跡することで、変更履歴が確実に保持され、時間経過に伴うデータの進化を効果的に管理および確認できるようになります。ただし、データが編集されるにつれて、編集内容が累積し、アーカイブが大幅に拡大し、ストレージキャパシティーに負担をかける可能性があります。

ブランチバージョン対応登録されたデータセットのブランチ履歴の詳細

ブランチ履歴のプルーンツール

これに対処するために、ブランチ履歴のプルーン ジオプロセシングツールが利用できます。このツールは、ブランチバージョニング履歴の管理とクリーンアップに役立つよう設計されていますプルーンのプロセスには、バージョンやレプリカから参照されなくなった、リタイアされた履歴管理レコードの削除が含まれています。このツールは、特定の条件に基づいて安全にプルーンできるレコードを特定し、必要な履歴データを保持しながら該当するエントリーのみを確実に削除します。

ブランチ履歴のプルーンジオプロセシングツール

ブランチ履歴のプルーンツールを使用するときのベストプラクティス

ブランチ履歴のプルーン ツールは、不要な履歴データを削除することで、ブランチバージョン対応のデータセットのサイズを管理するための貴重なリソースです。以下のベストプラクティスに従うことで、このツールを使用した円滑な操作を最適化および保証し、効率的で整理されたジオデータベースを維持できるようになります。

定期的な保守の実施 - 変更を定期的 (理想的には毎日または毎週) にリコンサイルおよびポストして、編集内容をデフォルトバージョンにマージする必要があります。リコンサイルされていないバージョン、未解決の競合、およびリコンサイル後に削除されていないバージョンは、行のプルーンを妨げる可能性があります。

ブランチバージョンシナリオとブランチバージョンへの編集内容のリコンサイルおよびポストの詳細
プルーン条件の設定 - 特定の日付やパフォーマンス要件など、プルーンの条件を明確に定義すると、より効果的なプルーンワークフローを作成できます。
プルーンするデータの特定 - ワークフローのニーズと履歴データの重要性に基づいて、プルーンするデータのカットオフ日付を決定します。
テスト実行の実施 - レポートのみ オプションを有効にしてツールを使用します。この方法では、データはプルーンされません。単に、出力ログファイル の結果に、プルーンできる履歴管理レコードの数に関するレポートが出力されます。
ログファイルの確認 - ツールを実行した後、作成された 出力ログファイル の結果を調べて、プルーンの対象となるアーカイブレコードの数を確認します。ログファイルを監視して、プルーンプロセスに関連する警告やエラーがないか確認し、適切なアクションを実行します。
データのバックアップ - ブランチ履歴のプルーン ツールを使用する前に、必ずデータベース全体をバックアップします。このバックアップによって、必要に応じてデータを復元できます。
ツールを実行するタイミング - システムへの影響を軽減するために、ピーク時間を避けて、週末やブランチバージョン対応のデータセットを参照しているフィーチャサービスを停止できる時間にツールを実行することをおすすめします。
参照モーメントの回避 - 未処理のバージョンがリコンサイルされていることを確認します。

注意:

ブランチ履歴のプルーン ツールを使用するときに、参照モーメントに関連するエラーが発生する場合があります。

参照モーメントの詳細
監視と確認 - ブランチバージョンを定期的に評価して、プルーンする必要がある可能性のある履歴データを特定します。さらに、ブランチバージョン対応のデータセットのサイズを追跡し、必要に応じて ブランチ履歴のプルーン ツールを実行して、ストレージを効果的に管理します。

ブランチ履歴のプルーンツールを使用するための前提条件

ブランチ履歴のプルーン ジオプロセシングツールを使用する前に、以下の前提条件を満たしている必要があります。

注意:

このツールを使用する際の前提条件と条件の完全なリストについては、ブランチ履歴のプルーン トピックの「使用法」セクションをご参照ください。

このツールは、入力データセット で指定したデータセットの所有者のみが実行できます。

ヒント:

すべてのプライベートバージョンを表示できるのはジオデータベース管理者のみであるため、データセットの所有者はジオデータベース管理者に相談して、日付より前をプルーン を設定するために最も古い参照モーメントを見つける必要があります。
入力データセット の値は、ブランチバージョン対応登録されているテーブル、フィーチャクラス、またはフィーチャデータセットである必要があります。これは、トポロジー、パーセルファブリック、またはユーティリティーネットワークを除くコントローラーデータセットには参加できません。
入力データセット の値を指定する前に、所有者は ジオデータベースコネクションプロパティ ダイアログで バージョニングタイプ が ブランチ に設定されていることを確認する必要があります。

ブランチバージョニング用のデータベースコネクションを構成する方法の詳細
入力データセット としてフィーチャデータセットを選択した場合、ツールはその中にあるすべてのフィーチャクラスとそのデータセットの外部にある関連データを処理し、別のフィーチャデータセット内のものは除外します。

ヒント:

フィーチャクラスがフィーチャデータセットから削除されている場合は、入力データセット にフィーチャデータセット自体を使用することをおすすめします。
マルチユーザー環境で一貫性を確保するには、入力データセット のデータに対する排他スキーマロックが必要です。このロックによって、他のユーザーがそのデータセットにアクセスしている間も、スキーマが変更されなくなります。慎重な計画が不可欠です。たとえば、スキーマ変更のスケジュールをユーザーがオフラインのときに設定すると、ユーザーの作業への影響を回避できます。データセットがサービスとして公開されている場合は、スキーマを変更する前に ArcGIS Server Manager を使用してサービスを停止します。

データセットのロックを表示および管理する方法の詳細

ブランチ履歴のプルーンツールの使用

ブランチ履歴のプルーン ツールを使用して、ブランチバージョン対応のデータセットからリタイアされた履歴管理レコードを削除するには、次の手順を実行します:

ヒント:

ブランチ履歴のプルーン ツールは、デフォルトバージョンからのみ履歴管理レコードをプルーンします。

ブランチ履歴のプルーン ジオプロセシングツールを開くには、解析タブを参照し、ジオプロセシング グループの ツール をクリックします。または、バージョン ツールボックスの データ管理ツール ツールセットでツールを検索します。

ブランチ履歴のプルーン ジオプロセシングツールダイアログボックスが開き、デフォルト設定が表示されます。
入力データセット で、ドロップダウンメニューから 1 つのデータセットを選択するか、参照ボタンを使用して、プルーンするブランチバージョン対応データが含まれているフィーチャデータセット、フィーチャクラス、またはテーブルを選択します。

注意:

入力データセット に必要な前提条件の詳細
出力ログファイル で、参照ボタンを使用して、出力ログファイルを保存する場所を指定します。
必要に応じて、レポートのみ パラメーターをオンにして、対象となるアーカイブレコードの数のレポートのみを取得するか、オフのままにしてプルーンを続行します。
- レポートのみ パラメーターをオンにした場合、対象となるレコードの合計数のみが 出力ログファイル の結果に報告され、レコード自体はプルーンされません。 レポートのみ オプションは、デフォルトでオンになっています。
- レポートのみ パラメーターがオフの場合、対象となるアーカイブレコードがプルーンされます。
必要に応じて、内部テーブルのみを対象とする場合は、システムテーブルのみをプルーン パラメーターをオンにします。

オンにすると、コントローラーデータセットの対象となる内部システムテーブルのみがリストされるかプルーンされます。
- システムテーブルのみをプルーン パラメーターがオンの場合、コントローラーデータセットの対象となる内部システムテーブルのみがプルーンされるか、ログファイルに報告されます。
- デフォルトでは、この システムテーブルのみをプルーン パラメーターはオフになっており、対象となるすべてのテーブルが含められます。
注意:

ArcGIS Pro 3.5 では、内部システムテーブルとは、特に接続性や格納などのすべての関連付けを格納するユーティリティーネットワークのネットワークトポロジーテーブルを表します。
必要に応じて、日付より前をプルーン パラメーターに値を設定して、指定した日時より前の日付の履歴管理レコードをプルーンします。

ヒント:

参照を一貫して管理するために、日付が UTC (世界協定時) であることを確認します。
- 日付より前をプルーン フィールドが空の場合、ツールは、基準となるモーメントに基づき、対象のアーカイブ履歴を可能な限り多くプルーンします。
- 日付より前をプルーン フィールドに、指定した日付が含まれている場合、そのモーメントまでの履歴管理が有効化されたデータのみが削除されます。
  
  注意:
  
  バージョンまたはフィーチャサービスレプリカが、リクエストされたプルーン日付より前の参照モーメントを使用しているために 日付より前をプルーン 値が無効である場合、ツールは警告を表示して、使用できる最も古いモーメントと、ブロックしているバージョンの詳細を示します。
  
  参照モーメント、バージョンビューを開く、ブランチバージョンの管理、フィーチャサービスレプリカの管理の詳細
実行をクリックして、指定したブランチバージョン対応のデータセットのブランチ履歴を報告またはプルーンします。

注意:

実行ボタンの横にあるドロップダウンメニューを使用して、スケジュール実行 を選択し、必要に応じた頻度でツールを後で実行することもできます。

ジオプロセシングツールのスケジューリングの詳細