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 indiqué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 indiqué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.

• La valeur du paramètre Jeu de données en entrée doit être une table, une classe d’entités ou un jeu de classes d’entités qui est inscrit en tant que branche versionnée. Ce type de jeu peut participer à aucun jeu de données de contrôleur, à l’exception d’une topologie ou d’un réseau de distribution.

  Remarque :

  Lorsque vous utilisez cet outil, si un message d’erreur indique qu’une mise à niveau est nécessaire, mettez à niveau votre géodatabase vers la version la plus récente. Lisez cet article de la base de connaissances pour plus de détails.

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

• Lorsque la valeur du paramètre Jeu de données en entrée est un jeu de classes d’entités, toutes les classes d’entités dans ce 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

Boîte de dialogue

Étiquette	Explication	Type 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. Activé : seules les tables internes éligibles des jeux de données d’extension seront nettoyées ou consignées dans le fichier journal. Désactivé : 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 indiqué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

Étiquette	Explication	Type de données
Jeu de données en sortie	Jeu de données mis à jour.	Table View; Feature Dataset

Python

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

Nom	Explication	Type 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_ONLY—Les 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. PRUNE—Les 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_ONLY—Seules les tables internes éligibles des jeux de données d’extension seront nettoyées ou consignées dans le fichier journal. ALL—Toutes 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 indiqué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

Nom	Explication	Type 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.

Informations de licence

• Basic: Non
• Standard: Oui
• Advanced: Oui