{"title":"Référence des index de modèle","version":"5.2","locale":"fr","docname":"ref/models/indexes","url":"/fr/5.2/ref/models/indexes/","canonical":"https://djangodocs.dev/fr/5.2/ref/models/indexes/","summary":"Les classes d’index facilitent la création d’index de base de données. Elles peuvent être ajoutées avec l’option Meta.indexes . Ce document détaille les références…","html":"

Référence des index de modèleLien vers cette rubrique#

\n

Les classes d’index facilitent la création d’index de base de données. Elles peuvent être ajoutées avec l’option Meta.indexes. Ce document détaille les références d’API de Index ce qui inclut les options d’index.

\n\n
\n

Options d”IndexLien vers cette rubrique#

\n
\n
\nclass Index(*expressions, fields=(), name=None, db_tablespace=None, opclasses=(), condition=None, include=None)Lien vers cette définition#
\n

Crée un index (B-Tree) dans la base de données.

\n
\n\n
\n

expressionsLien vers cette rubrique#

\n
\n
\nIndex.expressionsLien vers cette définition#
\n
\n\n

L’argument positionnel *expressions permet de créer des index fonctionnels sur des expressions et des fonctions de base de données.

\n

Par exemple :

\n
Code
Index(Lower("title").desc(), "pub_date", name="lower_title_date_idx")\n
\n

crée un index sur la valeur en minuscules du champ title dans l’ordre alphabétique inverse et le champ pub_date dans l’ordre alphabétique par défaut.

\n

Un autre exemple :

\n
Code
Index(F("height") * F("weight"), Round("weight"), name="calc_idx")\n
\n

crée un index sur le résultat de la multiplication des champs height et weight avec le champ weight arrondi à l’entier le plus proche.

\n

Index.name est obligatoire quand on utilise *expressions.

\n\n\n\n
\n
\n

fieldsLien vers cette rubrique#

\n
\n
\nIndex.fieldsLien vers cette définition#
\n
\n\n

Une liste ou un tuple de noms de champs sur lesquels l’index doit porter.

\n

Par défaut, les index sont créés avec un tri croissant sur chaque colonne. Pour définir un index avec un tri décroissant sur une certaine colonne, ajoutez un tiret devant le nom du champ.

\n

Par exemple, Index(fields=['headline', '-pub_date']) créerait du SQL contenant (headline, pub_date DESC).

\n\n
\n
\n

nameLien vers cette rubrique#

\n
\n
\nIndex.nameLien vers cette définition#
\n
\n\n

Le nom de l’index. Si name n’est pas fourni, Django va générer automatiquement un nom. Par compatibilité avec les différentes bases de données, les noms d’index ne peuvent pas être plus longs que 30 caractères et ne doivent pas commencer par un nombre (0-9) ni par un soulignement (_).

\n\n
\n
\n

db_tablespaceLien vers cette rubrique#

\n
\n
\nIndex.db_tablespaceLien vers cette définition#
\n
\n\n

Le nom de l’espace de tables de base de données à utiliser pour cet index. Pour les index sur un seul champ et si db_tablespace n’est pas indiqué, l’index est créé dans l’espace db_tablespace du champ.

\n

Si Field.db_tablespace n’est pas présent (ou si l’index utilise plusieurs champs), l’index est créé dans l’espace de tables défini dans l’option db_tablespace dans la classe Meta du modèle. Si aucun de ces espaces n’est défini, l’index est créé dans le même espace de tables que la table.

\n\n
\n
\n

opclassesLien vers cette rubrique#

\n
\n
\nIndex.opclassesLien vers cette définition#
\n
\n\n

Les noms des classes d’opérateurs PostgreSQL à utiliser pour cet index. Si vous nécessitez une classe d’opérateur personnalisée, vous devez en fournir une pour chaque champ de l’index.

\n

Par exemple, GinIndex(name='json_index', fields=['jsonfield'], opclasses=['jsonb_path_ops']) crée un index gin pour le champ jsonfield en utilisant les classes d’opérateurs jsonb_path_ops.

\n

opclasses est ignoré pour les bases de données autres que PostgreSQL.

\n

Index.name est obligatoire quand on utilise opclasses.

\n
\n
\n

conditionLien vers cette rubrique#

\n
\n
\nIndex.conditionLien vers cette définition#
\n
\n\n

Si la table est très grande et que vos requêtes ciblent principalement un certain sous-ensemble de lignes, il peut être utile de restreindre l’index à ce sous-ensemble. Indiquez une condition sous forme de Q. Par exemple, condition=Q(pages__gt=400) va indexer les lignes dont le champ pages est plus grand que 400.

\n

Index.name est obligatoire quand on utilise condition.

\n\n\n\n\n
\n
\n

includeLien vers cette rubrique#

\n
\n
\nIndex.includeLien vers cette définition#
\n
\n\n

Une liste ou un tuple de noms de champs à inclure dans l’index couvrant, représentant des colonnes qui ne sont pas des clés. Cela permet des analyses en index pur avec des requêtes qui ne sélectionnent que les champs inclus (include) et qui ne filtrent que sur les champs indexés (fields).

\n

Par exemple :

\n
Code
Index(name="covering_index", fields=["headline"], include=["pub_date"])\n
\n

permettra le filtrage sur headline, sélectionnant aussi pub_date, tout en ne récupérant les données qu’à partir de l’index.

\n

Avec include, l’index produit est plus petit qu’en utilisant un index sur plusieurs colonnes mais avec l’inconvénient que les colonnes n’étant pas des clés ne peuvent pas être utilisées pour le tri ou le filtrage.

\n

opclasses est ignoré pour les bases de données autres que PostgreSQL.

\n

Index.name est obligatoire quand on utilise include.

\n

Consultez la documentation PostgreSQL pour plus de détails au sujet des index couvrants.

\n\n
\n
","rootId":"module-django.db.models.indexes","toc":[{"title":"Options d”Index","anchor":"index-options","children":[{"title":"expressions","anchor":"expressions","children":[]},{"title":"fields","anchor":"fields","children":[]},{"title":"name","anchor":"name","children":[]},{"title":"db_tablespace","anchor":"db-tablespace","children":[]},{"title":"opclasses","anchor":"opclasses","children":[]},{"title":"condition","anchor":"condition","children":[]},{"title":"include","anchor":"include","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/5.2/ref/"},{"docname":"ref/models/index","title":"Modèles","url":"/fr/5.2/ref/models/"}],"prev":{"docname":"ref/models/fields","title":"Référence des champs de modèle","url":"/fr/5.2/ref/models/fields/"},"next":{"docname":"ref/models/constraints","title":"Référence des contraintes","url":"/fr/5.2/ref/models/constraints/"},"formats":{"html":"/fr/5.2/ref/models/indexes/","markdown":"/fr/5.2/ref/models/indexes.md","json":"/fr/5.2/ref/models/indexes.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/models/indexes.txt","official":"https://docs.djangoproject.com/fr/5.2/ref/models/indexes/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}