djorm-ext-pgarray 0.10

简介

Django默认情况下，有一大系列可以用来定义模型的类型。但有时我们需要使用PostgreSQL提供的更复杂的类型。在这种情况下，我们将探讨PostgreSQL数组与Django的集成。

快速入门

djorm-ext-pgarray公开了一个简单的Django模型字段djorm_pgarray.fields.ArrayField。它接受两个额外的参数：dbtype表示PostgreSQL类型，以及dimension表示数组字段的维度。

这是使用ArrayField的模型示例定义

from django.db import models
from djorm_pgarray.fields import ArrayField
from djorm_expressions.models import ExpressionManager

class Register(models.Model):
    name = models.CharField(max_length=200)
    points = ArrayField(dbtype="int")
    objects = ExpressionManager()

class Register2(models.Model):
    name = models.CharField(max_length=200)
    texts = ArrayField(dbtype="text", dimension=2) # this creates `points text[][]` postgresql field.
    objects = ExpressionManager()

>>> Register.objects.create(points = [1,2,3,4])
<Register: Register object>
>>> Register2.objects.create(texts = [['Hello', 'World'], ['Hola', 'Mundo']])
<Register2: Register2 object>

class Register(models.Model):
    name = models.CharField(max_length=200)
    macs = ArrayField(dbtype="macaddr", type_cast=lambda x: str(x))
    # Same as previous line but uses str as callback directly
    # macs = ArrayField(dbtype="macaddr", type_cast=str)
    objects = ExpressionManager()

如何安装它？

您可以从GitHub克隆仓库，并使用简单的python setup.py install命令进行安装。或者使用pip，从Python包索引中安装它。

pip install djorm-ext-pgarray

此外，您还可以安装djorm-ext-expressions，它可以帮助使用数组字段进行复杂查询。

已知问题

• 使用表达式包的Querysets不能用作子查询。因为别名传播工作不正常。