Django
ArrayField - un champ spécifique à PostgreSQL

AngularJS CSS HTML JavaScript jQuery MongoDB MySQL postgresql Python Language SQL

Syntaxe

à partir de django.contrib.postgres.fields importer ArrayField
class ArrayField (base_field, size = None, ** options)
FooModel.objects.filter (array_field_name__contains = [objets, à, cocher])
FooModel.objects.filter (array_field_name__contained_by = [objets, à, cocher])

Remarques

Notez que même si le paramètre de size est transmis à PostgreSQL, PostgreSQL ne l'exigera pas.

Lors de l'utilisation d' ArrayField il convient de garder à l'esprit ce mot d'avertissement de la documentation des baies Postgresql .

Conseil: les tableaux ne sont pas des ensembles; La recherche d'éléments de tableau spécifiques peut être un signe de mauvaise conception de la base de données. Envisagez d'utiliser une table séparée avec une ligne pour chaque élément qui serait un élément de tableau. Cela sera plus facile à rechercher et sera probablement mieux adapté à un grand nombre d'éléments.

Un ArrayField de base

Pour créer un ArrayField PostgreSQL, nous devons donner à ArrayField le type de données que nous voulons stocker en tant que champ en tant que premier argument. Comme nous allons stocker les cotes de livres, nous utiliserons FloatField .

 from django.db import models, FloatField
 from django.contrib.postgres.fields import ArrayField
 
 class Book(models.Model):
     ratings = ArrayField(FloatField())

Spécification de la taille maximale d'un ArrayField

 from django.db import models, IntegerField
 from django.contrib.postgres.fields import ArrayField
 
 class IceCream(models.Model):
     scoops = ArrayField(IntegerField()  # we'll use numbers to ID the scoops
                   , size=6)  # our parlor only lets you have 6 scoops

Lorsque vous utilisez le paramètre size, il est transmis à postgresql, qui l'accepte et l'ignore ensuite! Il est donc tout à fait possible d'ajouter 7 entiers au champ scoops ci-dessus en utilisant la console postgresql.

Demander l'appartenance à ArrayField avec contains

Cette requête renvoie tous les cônes avec un scoop au chocolat et un scoop à la vanille.

VANILLA, CHOCOLATE, MINT, STRAWBERRY = 1, 2, 3, 4  # constants for flavors
choco_vanilla_cones = IceCream.objects.filter(scoops__contains=[CHOCOLATE, VANILLA])

N'oubliez pas d'importer le modèle IceCream partir de votre fichier models.py .

Gardez également à l'esprit que django ne créera pas d'index pour ArrayField . Si vous envisagez de les rechercher, vous aurez besoin d'un index qui devra être créé manuellement avec un appel à RunSQL dans votre fichier de migration.

Nid ArrayFields

Vous pouvez imbriquer ArrayField s en passant un autre ArrayField comme base_field .

from django.db import models, IntegerField
from django.contrib.postgres.fields import ArrayField

class SudokuBoard(models.Model):
    numbers = ArrayField(
        ArrayField(
            models.IntegerField(),
            size=9,
        ),
        size=9,
    )

Interrogation pour tous les modèles qui contiennent des éléments dans une liste avec contain_by

Cette requête renvoie tous les cônes avec un scoop à la menthe ou un scoop à la vanille.

minty_vanilla_cones = IceCream.objects.filter(scoops__contained_by=[MINT, VANILLA])

Modified text is an extract of the original Stack Overflow Documentation

Sous licence CC BY-SA 3.0

Non affilié à Stack Overflow