HTML CSS JAVASCRIPT JQUERY AI PHP SQL EXCEL LINUX C# C++ C PYTHON JAVA 教程库 参考手册 技术文章 测验 练习 HOWTO FAQ
❮ Peewee Model 模型 Peewee 插入新记录 ❯

Peewee - Field 字段类

Model 模型类包含一个或多个属性，这些属性是 Peewee 中 Field 类的对象。 Base Field 类不直接实例化。 Peewee 为等效的 SQL 数据类型定义了不同的子类。

Field 类的构造函数有以下参数 −

Sr.No 构造函数 & 描述
1

column_name (str)

指定字段的列名。
2

primary_key (bool)

字段为主键
3

constraints (list)

应用于列的约束列表
4

choices (list)

二元组的可迭代映射列值以显示标签。
5

null (bool)

字段允许 NULL。
6

index (bool)

在字段上创建索引。
7

unique (bool)

在字段上创建唯一索引。
8

Default

默认值。
9

collation (str)

字段的排序规则名称。
10

help_text (str)

用于字段、元数据目的的帮助文本。
11

verbose_name (str)

用于字段、元数据用途的详细名称。

Field 字段类的子类映射到各种数据库中对应的数据类型，即SQLite、PostgreSQL、MySQL等

Numeric 数值字段类

Peewee 中的数字字段类如下 −

Sr.No 字段类 & 描述
1

IntegerField

用于存储整数的字段类。
2

BigIntegerField

用于存储大整数的字段类（分别映射到SQLite、PostgreSQL和MySQL中的integer、bigint和bigint类型）。
3

SmallIntegerField

用于存储小整数的字段类（如果数据库支持）。
4

FloatField

存储浮点数的字段类对应真实数据类型。
5

DoubleField

用于存储双精度浮点数的字段类映射到相应SQL数据库中的等效数据类型。
6

DecimalField

用于存储十进制数字的字段类。 参数如下所述 −

  • max_digits (int) – 要存储的最大位数。

  • decimal_places (int) – 最大精度。

  • auto_round (bool) – 自动舍入值。

Text 文本字段

Peewee 中可用的文本字段如下 −

Sr.No 字段 & 描述
1

CharField

用于存储字符串的字段类。 最多 255 个字符。 等效的 SQL 数据类型是 varchar。
2

FixedCharField

用于存储定长字符串的字段类。
3

TextField

用于存储文本的字段类。 在 SQLite 和 PostgreSQL 中映射到 TEXT 数据类型，在 MySQL 中映射到 longtext。

Binary 二进制字段

Peewee 中的二进制字段解释如下 −

Sr.No 字段 & 描述
1

BlobField

用于存储二进制数据的字段类。
2

BitField

用于在 64 位整数列中存储选项的字段类。
3

BigBitField

用于在二进制大型对象 (BLOB) 中存储任意大位图的字段类。 该字段将根据需要增加底层缓冲区。
4

UUIDField

用于存储通用唯一标识符 (UUID) 对象的字段类。 映射到 Postgres 中的 UUID 类型。 SQLite 和 MySQL 没有 UUID 类型，它存储为 VARCHAR。

日期和时间字段

Peewee中的日期时间字段如下 −

Sr.No 字段 & 描述
1

DateTimeField

用于存储 datetime.datetime 对象的字段类。 接受一个特殊的参数字符串格式，日期时间可以用它来编码。
2

DateField

用于存储 datetime.date 对象的字段类。 接受一个特殊的参数字符串格式来编码日期。
3

TimeField

用于存储 datetime.time 对象的字段类接受特殊参数格式以显示编码时间。

因为 SQLite 没有 DateTime 数据类型，这个字段被映射为字符串。

ForeignKeyField 外键字段

此类用于在两个模型中建立外键关系，从而在数据库中建立相应的表。 此类使用以下参数实例化 −

Sr.No 字段 & 描述
1

model (Model)

要参考的模型。 如果设置为'self'，则为自引用外键。
2

field (Field)

要在模型上引用的字段（默认为主键）。
3

backref (str)

反向引用的访问者名称。 "+"禁用反向引用访问器。
4

on_delete (str)

ON DELETE 操作。
5

on_update (str)

ON UPDATE 动作。
6

lazy_load (bool)

当访问外键字段属性时，获取相关对象。 如果为 FALSE，访问外键字段将返回存储在外键列中的值。

示例

这是 ForeignKeyField 的示例。

from peewee import *

db = SqliteDatabase('mydatabase.db')
class Customer(Model):
   id=IntegerField(primary_key=True)
   name = TextField()
   address = TextField()
   phone = IntegerField()
   class Meta:
      database=db
      db_table='Customers'

class Invoice(Model):
   id=IntegerField(primary_key=True)
   invno=IntegerField()
   amount=IntegerField()
   custid=ForeignKeyField(Customer, backref='Invoices')
   class Meta:
      database=db
      db_table='Invoices'

db.create_tables([Customer, Invoice])

执行上述脚本时，将运行以下 SQL 查询 −

CREATE TABLE Customers (
   id INTEGER NOT NULL
   PRIMARY KEY,
   name TEXT NOT NULL,
   address TEXT NOT NULL,
   phone INTEGER NOT NULL
);
CREATE TABLE Invoices (
   id INTEGER NOT NULL
   PRIMARY KEY,
   invno INTEGER NOT NULL,
   amount INTEGER NOT NULL,
   custid_id INTEGER NOT NULL,
   FOREIGN KEY (
      custid_id
   )
   REFERENCES Customers (id)
);

在SQLiteStuidio GUI工具中验证时，表结构如下 −

外键字段 SQLite Stuidio GUI 工具

其他字段类型

Peewee 中的其他字段类型包括 −

Sr.No 字段 & 描述
1

IPField

用于有效存储 IPv4 地址（作为整数）的字段类。
2

BooleanField

用于存储布尔值的字段类。
3

AutoField

用于存储自增主键的字段类。
4

IdentityField

使用新的 Postgres 10 IDENTITY 列类型存储自动递增主键的字段类。 列类型。
❮ Peewee Model 模型 Peewee 插入新记录 ❯