实体是映射到数据库表（或在使用MongoDB时映射到集合）的类。 您可以通过定义一个新类并使用@Entity()标记它来创建实体：

这将创建以下数据库表：

基本实体由列和关系组成。 每个实体必须具有主列（如果使用MongoDB，则是ObjectId列）。

每个实体必须在数据源选项中注册：

或者您可以指定包含所有实体的整个目录 - 所有实体都将被加载：

如果要为User实体设置替代表名，可以在@Entity中指定：@Entity("my_users")。 如果要为应用程序中的所有数据库表设置基本前缀，可以在数据源选项中指定entityPrefix。

在使用实体构造函数时，其参数**必须是可选的。由于ORM在从数据库加载时创建实体类的实例，因此不知道您的构造函数参数。

有关参数@Entity的详细信息，请参阅装饰器参考。

由于数据库表由列组成，因此您的实体也必须由列组成。 您使用@Column标记的每个实体类属性都将映射到数据库表列。

每个实体必须至少有一个主键列。 有几种类型的主键列：

您还可以拥有复合主键列：

使用save保存实体时，它始终尝试在数据库中使用给定的实体id（或ids）查找实体。 如果找到id/ids，则将更新数据库中的该行。 如果没有具有id/ids的行，将插入新行。

要通过id查找实体，可以使用manager.findOneBy或repository.findOneBy。示例：

有几种带有附加功能的特殊列类型：

@CreateDateColumn 是一个特殊列，它会自动设置为实体的插入日期。 您不需要设置该列-它将自动设置。

@UpdateDateColumn 是一个特殊列，每次调用实体管理器或存储库的save时，它都会自动设置为实体的更新时间。 您不需要设置该列-它将自动设置。

@DeleteDateColumn 是一个特殊列，每次调用实体管理器或存储库的软删除时，它都会自动设置为实体的删除时间。 您不需要设置该列-它将自动设置。如果设置了@DeleteDateColumn，则默认范围将是“非删除”。

@VersionColumn 是一个特殊列，每次调用实体管理器或存储库的save时，它都会自动设置为实体的版本（递增数）。 您不需要设置该列-它将自动设置。

MS SQL、MySQL、MariaDB、PostgreSQL 和 CockroachDB 都支持空间列。TypeORM 对每个数据库的支持略有不同，特别是由于列名在不同数据库之间有所变化。

MS SQL 和 MySQL / MariaDB 的 TypeORM 支持将几何图形以 well-known text (WKT) 的形式提供和接受，因此几何列应该标记为 string 类型。

TypeORM 的 PostgreSQL 和 CockroachDB 支持使用 GeoJSON 作为交换格式，因此几何列应该标记为 object 或 Geometry（或其子类，如 Point），在导入 geojson 类型 后或使用 TypeORM 内置的 GeoJSON 类型。

TypeORM试图尽力处理，但有时无法确定插入的值或PostGIS函数的结果应如何处理为几何值。因此，您可能会编写类似以下代码的代码，其中值从GeoJSON转换为PostGIS的geometry，并从json转换为GeoJSON：

TypeORM支持大多数常用的数据库支持的列类型。列类型是特定于数据库类型的，这提供了更大的灵活性，使您的数据库模式看起来更加多样化。

您可以将列类型指定为@Column的第一个参数，或在@Column的列选项中指定，例如：

或者

如果要指定其他类型参数，可以通过列选项来实现。例如：

或者

关于bigint类型的注意事项：在SQL数据库中使用的bigint列类型不适合常规的number类型，而是将属性映射为string。

bit、int、integer、tinyint、smallint、mediumint、bigint、float、double、 double precision、dec、decimal、numeric、fixed、bool、boolean、date、datetime、 timestamp、time、year、char、nchar、national char、varchar、nvarchar、national varchar、 text、tinytext、mediumtext、blob、longtext、tinyblob、mediumblob、longblob、enum、set、 json、binary、varbinary、geometry、point、linestring、polygon、multipoint、multilinestring、multipolygon、geometrycollection、uuid、inet4、inet6

注意：UUID、INET4和INET6仅适用于mariadb以及使它们可用的相应版本。

int、int2、int4、int8、smallint、integer、bigint、decimal、numeric、real、 float、float4、float8、double precision、money、character varying、varchar、character、 char、text、citext、hstore、bytea、bit、varbit、bit varying、timetz、timestamptz、 timestamp、timestamp without time zone、timestamp with time zone、date、time、 time without time zone、time with time zone、interval、bool、boolean、enum、point、line、 lseg、box、path、polygon、circle、cidr、inet、macaddr、tsvector、tsquery、uuid、xml、 json、jsonb、int4range、int8range、numrange、tsrange、tstzrange、daterange、geometry、 geography、cube、ltree

array、bool、boolean、bytes、bytea、blob、date、numeric、decimal、dec、float、 float4、float8、double precision、real、inet、int、integer、int2、int8、int64、 smallint、bigint、interval、string、character varying、character、char、char varying、 varchar、text、time、time without time zone、timestamp、timestamptz、timestamp without time zone、 timestamp with time zone、json、jsonb、uuid

注意：CockroachDB将所有数值数据类型都返回为string。但是，如果您省略列类型并将属性定义为number，ORM将把字符串解析为数字。

int、int2、int8、integer、tinyint、smallint、mediumint、bigint、decimal、numeric、 float、double、real、double precision、datetime、varying character、character、 native character、varchar、nchar、nvarchar2、unsigned big int、boolean、blob、text、clob、date

int、bigint、bit、decimal、money、numeric、smallint、smallmoney、tinyint、float、 real、date、datetime2、datetime、datetimeoffset、smalldatetime、time、char、varchar、 text、nchar、nvarchar、ntext、binary、image、varbinary、hierarchyid、sql_variant、 timestamp、uniqueidentifier、xml、geometry、geography、rowversion

char、nchar、nvarchar2、varchar2、long、raw、long raw、number、numeric、float、dec、 decimal、integer、int、smallint、real、double precision、date、timestamp、 timestamp with time zone、timestamp with local time zone、interval year to month、 interval day to second、bfile、blob、clob、nclob、rowid、urowid

bool、int64、float64、numeric、string、json、bytes、date、timestamp、array

enum列类型由postgres和mysql支持。有多种可能的列定义方式：

使用TypeScript的枚举：

注意：支持字符串、数字和混合类型的枚举。

使用包含枚举值的数组：

set列类型由mariadb和mysql支持。有多种可能的列定义方式：

使用TypeScript的枚举：

使用包含set值的数组：

有一种特殊的列类型称为simple-array，它可以将基本数组值存储在单个字符串列中。所有值由逗号分隔。例如：

将以Alexander,Alex,Sasha,Shurik的形式存储在单个数据库列中。当您从数据库加载数据时，姓名将作为姓名数组返回，就像您存储它们一样。

请注意，您在写入的值中不能有任何逗号。

有一种特殊的列类型称为simple-json，它可以存储可以通过JSON.stringify存储在数据库中的任何值。当您没有数据库中的JSON类型并且希望存储和加载对象而无需麻烦时，这非常有用。例如：

将以{"name":"John","nickname":"Malkovich"}的形式存储在单个数据库列中。当您从数据库加载数据时，您将通过JSON.parse获得您的对象/数组/基本值。

您可以使用@Generated装饰器创建具有生成值的列。例如：

uuid值将自动生成并存储到数据库中。

除了"uuid"之外，还有"increment"、"identity"（仅适用于Postgres 10+）和"rowid"（仅适用于CockroachDB）生成类型，但某些数据库平台对于这种类型的生成有一些限制（例如，某些数据库只能有一个增量列，或者某些数据库要求增量是主键）。

列选项为实体列定义了附加选项。您可以在@Column中指定列选项：

ColumnOptions中可用的选项列表:

注意：这些列选项大多是特定于关系数据库管理系统（RDBMS）的，不适用于MongoDB。

您可以通过使用实体继承来减少代码中的重复。

例如，您有Photo、Question、Post实体：

正如您所见，所有这些实体都有共同的列：id、title、description。为了减少重复并产生更好的抽象，我们可以为它们创建一个名为Content的基类：

所有来自父实体的列（关系、嵌入等）（父实体也可以扩展其他实体）都将被继承并创建在最终实体中。

TypeORM支持使用邻接列表和闭包表模式存储树结构。

邻接列表是一种具有自引用关系的简单模型。 这种方法的好处是简单性，缺点是由于联接限制，无法一次加载大型树结构。 示例：

闭包表在一个单独的表中以特殊的方式存储父子关系。 它在读取和写入时都非常高效。 要了解有关闭包表的更多信息，请查看Bill Karwin的精彩演示文稿。 示例：