Historique de branche Adaptation (Gestion des données)

Synthèse

Supprime les enregistrements d’archive retirés des jeux de données en branche versionnés.

En savoir plus sur le nettoyage de l’historique des données en branche

Utilisation

  • Lorsqu’aucune valeur n’est spécifiée pour le paramètre Nettoyer les éléments antérieurs à (date/heure), l’outil nettoie l’historique d’archivage autant que possible en fonction des moments référencés. Lorsqu’une valeur est spécifiée pour le paramètre Nettoyer les éléments antérieurs à (date/heure), toutes les lignes sont supprimées jusqu’à ce moment.

  • Si la valeur du paramètre Nettoyer les éléments antérieurs à (date/heure) n’est pas valide car une version ou un réplica référence un moment antérieur à la date et à l’heure de nettoyage demandées, un message d’avertissement est émis. Le journal en sortie indique le moment le plus ancien pouvant être utilisé ainsi que le moment et la version qui ont bloqué l’outil.

    En savoir plus sur les moments référencés

  • Le type de versionnement de la connexion de géodatabase indiqué par la valeur du paramètre Jeu de données en entrée doit être branche.

  • Le jeu de données doit être inscrit en tant que jeu de données en branche versionné.

  • L’outil ne peut être exécuté que par le propriétaire des données.

  • La valeur du paramètre Jeu de données en entrée peut être une classe d’entités, un jeu de classes d’entités ou une table. Lorsque l’entrée est un jeu de classes d’entités, toutes les classes d’entités dans le jeu de données ainsi que les données associées hors du jeu de classes d’entités sont traitées, sauf les données qui se trouvent dans un autre jeu de classes d’entités.

  • Si une classe d’entités se trouve dans un jeu de classes d’entités, utilisez le jeu de classes d’entités comme entrée.

  • Un verrou de structure exclusif est requis pour exécuter l’outil. Les services qui référencent les données en entrée doivent être arrêtés à l’aide de ArcGIS Server Manager.

Paramètres

ÉtiquetteExplicationType de données
Jeu de données en entrée

Classe d’entités, jeu de classes d’entités ou table à nettoyer.

Table View; Feature Dataset
Fichier journal en sortie

Fichier journal indiquant les classes d’entités et les tables qui ont été nettoyées ou qui vont être nettoyées. Le fichier en sortie répertorie également les réplicas et les versions qui ont empêché l’utilisation du paramètre Nettoyer les éléments antérieurs à (date/heure) spécifié.

File
Consigner uniquement
(Facultatif)

Indique si les enregistrements d’archive éligibles doivent être consignés ou nettoyés.

  • Option sélectionnée : le nombre d’enregistrements d’archive éligibles sera consigné dans le fichier journal. Ces enregistrements ne seront pas nettoyés. Il s’agit de l’option par défaut.
  • Option non sélectionnée : les enregistrements d’archive éligibles seront nettoyés.
Boolean
Nettoyer uniquement les tables système

Indique si seules les tables internes éligibles doivent être consignées ou nettoyées

  • Option sélectionnée : seules les tables internes éligibles des jeux de données d’extension seront nettoyées ou consignées dans le fichier journal.
  • Option non sélectionnée : toutes les tables éligibles seront nettoyées ou consignées dans le fichier journal. Il s’agit de l’option par défaut.
Boolean
Nettoyer les éléments antérieurs à (date/heure)
(Facultatif)

Les enregistrements d’archive antérieurs à la date et à l’heure spécifiées seront nettoyés. La date et l’heure doivent être exprimées en UTC. Si aucune date n’est indiquée, le moment le plus ancien référencé dans la base de données est utilisé.

Date

Sortie obtenue

ÉtiquetteExplicationType de données
Jeu de données en sortie

Jeu de données mis à jour.

Table View; Feature Dataset

arcpy.management.PruneBranchHistory(in_dataset, out_log, {report_only}, system_tables_only, {prune_before_date})
NomExplicationType de données
in_dataset

Classe d’entités, jeu de classes d’entités ou table à nettoyer.

Table View; Feature Dataset
out_log

Fichier journal indiquant les classes d’entités et les tables qui ont été nettoyées ou qui vont être nettoyées. Le fichier en sortie répertorie également les réplicas et les versions qui ont empêché l’utilisation du paramètre Nettoyer les éléments antérieurs à (date/heure) spécifié.

File
report_only
(Facultatif)

Indique si les enregistrements d’archive éligibles doivent être consignés ou nettoyés.

  • REPORT_ONLYLes enregistrements d’archive éligibles seront consignés dans le fichier journal. Ils ne seront pas nettoyés. Il s’agit de l’option par défaut.
  • PRUNELes enregistrements d’archive éligibles seront nettoyés.
Boolean
system_tables_only

Indique si seules les tables internes éligibles doivent être consignées ou nettoyées.

  • SYSTEM_ONLYSeules les tables internes éligibles des jeux de données d’extension seront nettoyées ou consignées dans le fichier journal.
  • ALL_TABLESToutes les tables éligibles seront nettoyées ou consignées dans le fichier journal. Il s’agit de l’option par défaut.
Boolean
prune_before_date
(Facultatif)

Les enregistrements d’archive antérieurs à la date et à l’heure spécifiées seront nettoyés. La date et l’heure doivent être exprimées en UTC. Si aucune date n’est indiquée, le moment le plus ancien référencé dans la base de données est utilisé.

Date

Sortie obtenue

NomExplicationType de données
out_dataset

Jeu de données mis à jour.

Table View; Feature Dataset

Exemple de code

Exemple d’utilisation de la fonction PruneBranchHistory (fenêtre Python)

Nettoyer les enregistrements de l’archive d’une classe antérieurs à une date et une heure spécifiques.

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"
)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Rubriques connexes