Tronquer une table (Gestion des données)

Synthèse

Supprime tous les enregistrements d’une table de base de données ou d’une classe d’entités à l’aide de procédures de troncature dans la base de données.

Utilisation

    Attention :

    Si une sélection est appliquée à une couche ou à une vue tabulaire, la sélection sera ignorée et tous les enregistrements seront tronqués.

  • Les types de données pris en charge sont les points, lignes ou polygones simples stockés dans une base de données. Les types de données complexes tels que les MNT, les topologies et les jeux de données réseau ne peuvent pas être utilisés en entrée.

  • La table de base de données ou la classe d’entités en entrée doit provenir d’une connexion à une base de données établie en tant que propriétaire des données.

  • Les données versionnées ne sont pas prises en charge en entrée. L’inscription des données comme versionnées doit être annulée afin que l’outil s’exécute correctement.

  • Si l’archivage est activé pour la table en entrée, les enregistrements existent toujours dans la table d’historique après l’exécution de l’outil. Pour les supprimer, vous pouvez désactiver l’archivage, exécuter l’outil, puis réactiver l’archivage.

  • Les commandes de troncature n’utilisent pas de transactions de base de données et sont définitives. Cela améliore les performances par rapport à la suppression enregistrement par enregistrement.

  • Utilisez cet outil pour les processus dans lesquels tous les enregistrements sont supprimés d’une table ou d’une classe d’entités et où il n’est pas nécessaire de sauvegarder les transactions, comme le rechargement nocturne des données.

  • Cet outil prend en charge une couche de service d’entités en entrée si l’utilisateur connecté peut administrer le service et si la propriété de service supportsTruncate a pour valeur true.

  • Cet outil ne prend pas en charge les classes d’entités comportant des pièces jointes. Pour supprimer des enregistrements d’une classe d’entités comportant des pièces jointes, utilisez l’outil Supprimer des enregistrements.

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

Table de base de données ou classe d’entités en entrée à tronquer.

Table View

Sortie obtenue

ÉtiquetteExplicationType de données
Table tronquée

Table tronquée.

Table View

arcpy.management.TruncateTable(in_table)
NomExplicationType de données
in_table

Table de base de données ou classe d’entités en entrée à tronquer.

Table View

Sortie obtenue

NomExplicationType de données
out_table

Table tronquée.

Table View

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction TruncateTable en mode immédiat.

import arcpy
arcpy.TruncateTable_management("neil/whistler.sde/function.junction.table")
Exemple 2 d’utilisation de la fonction TruncateTable (script autonome)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction TruncateTable.

# Name: TruncateTable_Example2.py
# Description: Truncates all tables in a file geodatabase.

# Import system modules
import arcpy

# Set the workspace.
arcpy.env.workspace = "C:/work/vancouver.gdb"

# Get a list of all the tables.
tableList = arcpy.ListTables()

# Loop through the list and run truncate
for table in tableList:
    arcpy.TruncateTable_management(table)

Informations de licence

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

Rubriques connexes