You can define custom types by extending
Type abstract class. It has 4 optional methods:
convertToDatabaseValue(value: any, platform: Platform): any
Converts a value from its JS representation to its database representation of this type. By default returns unchanged
convertToJSValue(value: any, platform: Platform): any
Converts a value from its database representation to its JS representation of this type. By default returns unchanged
toJSON(value: any, platform: Platform): any
Converts a value from its JS representation to its serialized JSON form of this type. By default uses the runtime value.
getColumnType(prop: EntityProperty, platform: Platform): string
Gets the SQL declaration snippet for a field of this type. By default returns
columnTypeof given property.
Then you can use this type when defining your entity properties:
There are few types provided by MikroORM. All of them aim to provide similar experience among all the drivers, even if the particular feature is not supported out of box by the driver.
In PostgreSQL and MongoDB, it uses native arrays, otherwise it concatenates the
values into string separated by commas. This means that you can't use values that
contain comma with the
ArrayType (but you can create custom array type that will
handle this case, e.g. by using different separator).
By default array of strings is returned from the type. You can also have arrays
of numbers or other data types - to do so, you will need to implement custom
hydrate method that is used for converting the array values to the right type.
ArrayTypewill be used automatically if
typeis set to
array(default behaviour of reflect-metadata) or
number(either manually or via ts-morph). In case of
numberit will automatically handle the conversion to numbers. This means that the following examples would both have the
ArrayTypeused automatically (but with reflect-metadata we would have a string array for both unless we specify the type manually as `type: 'number')
You can use
BigIntType to support
bigints. By default, it will represent the
value as a
Blob type can be used to store binary data in the database.
BlobTypewill be used automatically if you specify the type hint as
Buffer. This means that the following example should work even without the explicit
type: BlobTypeoption (with both reflect-metadata and ts-morph providers).
To store objects we can use
JsonType. As some drivers are handling objects
automatically and some don't, this type will handle the serialization in a driver
independent way (calling
stringify only when needed).
To store dates without time information, we can use
DateType. It does use
column type and maps it to the
As opposed to the
DateType, to store only the time information, we can use
TimeType. It will use the
time column type, the runtime type is string.