Résumé
Ajoute un index attributaire à une table, une classe d'entités, un fichier de formes, une couverture, ou une classe de relations attribuées.
ArcGIS utilise des index attributaires pour localiser rapidement les enregistrements qui répondent à une requête attributaire. Pour obtenir des informations sur les index attributaires des géodatabases, reportez-vous à la rubrique Création d'index attributaires.
Utilisation
Les fichiers de formes et la géodatabase fichier ne prennent pas en charge les index multiples. Les champs supplémentaires font partie d'un index composite (c.-à-d. un index créé sur plusieurs champs dans une table).
Un nouvel index est ajouté pour chaque nom d'index unique dans les géodatabases personnelles, fichier ou d'entreprise. Si un nom d'index existe déjà, il doit être supprimé pour pouvoir être mis à jour.
Les index uniques et croissants ne sont pas pris en charge pour les fichiers de formes ou géodatabases fichiers. Ces paramètres sont ignorés lorsque l'outil est exécuté sur un fichier de formes ou des données de géodatabase fichier.
Le bouton Ajouter un champ du paramètre Champs à indexer est utilisé uniquement dans ModelBuilder. Dans ModelBuilder, lorsque l'outil précédent n'a pas été exécuté ou si ses données dérivées n'existent pas, le paramètre Champs à indexer peut ne comporter aucun nom de champ. Le bouton Ajouter un champ permet d'ajouter des champs attendus pour continuer à renseigner la boîte de dialogue Ajouter un index attributaire et poursuivre la construction du modèle.
Syntaxe
arcpy.management.AddIndex(in_table, fields, {index_name}, {unique}, {ascending})
Paramètre | Explication | Type de données |
in_table | Table contenant les champs à indexer. | Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View |
fields [fields,...] | Liste des champs qui participeront à l'index. Vous pouvez indiquer autant de champs que vous voulez. | Field |
index_name (Facultatif) | Nom du nouvel index. Un nom d'index est nécessaire lors de l'ajout d'un index à des tables et classes d'entités de géodatabase. Pour d'autres types d'entrée, le nom est ignoré. | String |
unique (Facultatif) | Précise si les valeurs de l'index sont uniques.
| Boolean |
ascending (Facultatif) | Indique si les valeurs sont indexées dans l'ordre croissant.
| Boolean |
Sortie dérivée
Nom | Explication | Type de données |
out_table | Table en entrée mise à jour. | Vue tabulaire, couche raster, couche de mosaïque |
Exemple de code
Exemple 1 d'utilisation de l'outil AddIndex (fenêtre Python)
Le code suivant montre comment utiliser la fonction AddIndex dans une fenêtre interactive Python.
import arcpy
arcpy.env.workspace = "C:/data/input/indices.sde"
arcpy.AddIndex_management("gdb.USER1.lakes", ["NAME", "geocompID"], "NGIndex", "UNIQUE", "ASCENDING")
Exemple 2 d'utilisation de l'outil AddIndex (script autonome)
Le script autonome suivant illustre la création d'un index attributaire pour les champs spécifiés.
# Name: AddAttIndex.py
# Description: Create an attribute Index for specified fields
# Import system modules
import arcpy
# Set a default workspace
arcpy.env.workspace = "c:/data"
# Create an attribute index for the few fields listed in command.
arcpy.AddIndex_management("counties.shp", ["NAME", "STATE_FIPS", "CNTY_FIPS"], "#", "NON_UNIQUE", "NON_ASCENDING")
arcpy.AddIndex_management("mexico.gdb/land/lakes", ["NAME", "geocompID"], "NGIndex", "NON_UNIQUE", "NON_ASCENDING")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui