Python sqlalchemy columns 列类型列表

在使用 SQLAlchemy 进行数据库开发时，我们常常需要定义数据表的列类型。SQLAlchemy 提供了丰富的列类型供我们选择使用。本文将详细介绍 SQLAlchemy 提供的常用列类型，并给出相应的代码示例。

1. SQL 列类型简介

SQL 中有多种列类型，包括整数类型、浮点类型、字符串类型、日期时间类型等。在使用 SQLAlchemy 时，我们需要根据数据库的特点选择相应的列类型。

2. SQLAlchemy 列类型分类

SQLAlchemy 列类型可以分为以下几类：

• 数字类型（Numeric Types）
• 字符串类型（String Types）
• 日期时间类型（Date and Time Types）
• 二进制类型（Binary Types）
• 布尔类型（Boolean Types）
• 特殊类型（Other Types）

下面将逐一介绍这些列类型及其使用方法。

3. 数字类型

3.1 Integer

整数类型，表示不带小数点的数字。

from sqlalchemy import Column, Integer

class User(Base):
    __tablename__ = 'users'
    id = Column(Integer, primary_key=True)

3.2 SmallInteger

小整数类型，表示范围小的整数。

from sqlalchemy import Column, SmallInteger

class User(Base):
    __tablename__ = 'users'
    id = Column(SmallInteger, primary_key=True)

3.3 BigInteger

大整数类型，表示范围较大的整数。

from sqlalchemy import Column, BigInteger

class User(Base):
    __tablename__ = 'users'
    id = Column(BigInteger, primary_key=True)

3.4 Float

浮点数类型，表示带有小数点的数值。

from sqlalchemy import Column, Float

class Product(Base):
    __tablename__ = 'products'
    price = Column(Float)

3.5 Numeric

精确数值类型，表示带有小数点的数值，并可指定精度和范围。

from sqlalchemy import Column, Numeric

class Order(Base):
    __tablename__ = 'orders'
    total_amount = Column(Numeric(10, 2))

上述代码中，Numeric 列类型表示最多有 10 位数字，其中小数最多保留 2 位。

4. 字符串类型

4.1 String

字符串类型，表示可变长度的字符串。

from sqlalchemy import Column, String

class User(Base):
    __tablename__ = 'users'
    name = Column(String(50))

上述代码中，String 列类型表示最大长度为 50 的字符串。

4.2 Text

文本类型，表示可变长度的文本。

from sqlalchemy import Column, Text

class Article(Base):
    __tablename__ = 'articles'
    content = Column(Text)

4.3 Unicode

Unicode 字符串类型。

from sqlalchemy import Column, Unicode

class User(Base):
    __tablename__ = 'users'
    name = Column(Unicode(50))

4.4 UnicodeText

Unicode 文本类型。

from sqlalchemy import Column, UnicodeText

class Article(Base):
    __tablename__ = 'articles'
    content = Column(UnicodeText)

5. 日期时间类型

5.1 Date

日期类型，表示年、月、日。

from sqlalchemy import Column, Date

class Event(Base):
    __tablename__ = 'events'
    date = Column(Date)

5.2 DateTime

日期时间类型，表示年、月、日、时、分、秒。

from sqlalchemy import Column, DateTime

class Event(Base):
    __tablename__ = 'events'
    datetime = Column(DateTime)

5.3 Time

时间类型，表示时、分、秒。

from sqlalchemy import Column, Time

class Event(Base):
    __tablename__ = 'events'
    time = Column(Time)

6. 二进制类型

6.1 LargeBinary

二进制类型，表示可变长度的二进制数据。

from sqlalchemy import Column, LargeBinary

class File(Base):
    __tablename__ = 'files'
    data = Column(LargeBinary)

7. 布尔类型

7.1 Boolean

布尔类型，表示真或假。

from sqlalchemy import Column, Boolean

class User(Base):
    __tablename__ = 'users'
    is_active = Column(Boolean)

8. 特殊类型

8.1 Enum

枚举类型，表示某一列只能从预定义的几个值中选择。

from enum import Enum
from sqlalchemy import Column, Enum as EnumType

class UserType(Enum):
    ADMIN = 'admin'
    USER = 'user'
    GUEST = 'guest'

class User(Base):
    __tablename__ = 'users'
    type = Column(EnumType(UserType))

上述代码中，UserType 是自定义的枚举类型，User 表的 type 列只能选择 admin、user 或 guest 之一。

结论

本文详细介绍了 SQLAlchemy 提供的常用列类型。通过选择不同的列类型，能够更好地满足数据库的需求。