Describe

Synthèse

Renvoie un dictionnaire avec plusieurs propriétés, telles que le type de données, les champs, les index et bien d’autres encore. Les clés du dictionnaire sont dynamiques, ce qui signifie que différentes propriétés pourront être utilisées en fonction du type de données décrit.

Les clés Describe sont organisées dans une série de groupes de propriétés. Tout jeu de données particulier acquiert les propriétés d'au moins un de ces groupes. Par exemple, lors de la description d’une classe d’entités de géodatabase, vous pouvez accéder aux propriétés à partir des groupes de propriétés Geodatabase Feature Class (Classe d’entités de géodatabase), Feature Class (Classe d’entités), Table et Dataset (Jeu de données). Toutes les données, quel que soit leur type, acquièrent toujours les propriétés générales de l’objet Describe.

Discussion

De nombreux types de données comprennent des propriétés d'autres groupes de propriétés. Par exemple, lors de la description d’une classe d’entités de géodatabase, vous pouvez accéder aux propriétés à partir des groupes de propriétés Geodatabase Feature Class (Classe d’entités de géodatabase), Feature Class (Classe d’entités), Table et Dataset (Jeu de données).

Syntaxe

Describe (value, {datatype})
ParamètreExplicationType de données
value

The specified data element or geoprocessing object to describe.

String
datatype

The type of data. This is only necessary when naming conflicts exists, for example, if a geodatabase contains a feature dataset (FeatureDataset) and a feature class (FeatureClass) with the same name. In this case, the data type is used to clarify which dataset you want to describe.

(La valeur par défaut est None)

String
Valeur renvoyée
Type de donnéesExplication
Dictionary

Renvoie un dictionnaire avec des clés détaillant l'élément de données décrit.

Exemple de code

Exemple 1 d’utilisation de la fonction Describe

Accédez à une propriété spécifique à l’aide de la valeur de clé.

import arcpy

path = "C:\\Data\\Venice.gdb\\VeniceStructures"
desc = arcpy.da.Describe(path)
field_names = [field.name for field in desc["fields"]]

if "YEAR_BUILT" not in field_names:
    arcpy.management.AddField(path, "YEAR_BUILT", "SHORT")
Exemple 2 d’utilisation de la fonction Describe

Affichez le dictionnaire Describe renvoyé pour examiner toutes les propriétés disponibles.

import arcpy
from pprint import pprint 

path = "C:\\Data\\Venice.gdb\\VeniceStructures"
desc = arcpy.da.Describe(path)
pprint(desc)

Rubriques connexes


Dans cette rubrique