Module sqlx_mysql::types

Conversions between Rust and MySQL/MariaDB types.

Types

Rust type	MySQL/MariaDB type(s)
bool	TINYINT(1), BOOLEAN, BOOL (see below)
i8	TINYINT
i16	SMALLINT
i32	INT
i64	BIGINT
u8	TINYINT UNSIGNED
u16	SMALLINT UNSIGNED
u32	INT UNSIGNED
u64	BIGINT UNSIGNED
f32	FLOAT
f64	DOUBLE
&str, String	VARCHAR, CHAR, TEXT
&[u8], Vec<u8>	VARBINARY, BINARY, BLOB
IpAddr	VARCHAR, TEXT
Ipv4Addr	INET4 (MariaDB-only), VARCHAR, TEXT
Ipv6Addr	INET6 (MariaDB-only), VARCHAR, TEXT
MySqlTime	TIME (encode and decode full range)
Duration	TIME (for decoding positive values only)

Note: BOOLEAN/BOOL Type

MySQL and MariaDB treat BOOLEAN as an alias of the TINYINT type:

• Using Data Types from Other Database Engines (MySQL)
• BOOLEAN (MariaDB)

For the most part, you can simply use the Rust type bool when encoding or decoding a value using the dynamic query interface, or passing a boolean as a parameter to the query macros (query!() et al.).

However, because the MySQL wire protocol does not distinguish between TINYINT and BOOLEAN, the query macros cannot know that a TINYINT column is semantically a boolean. By default, they will map a TINYINT column as i8 instead, as that is the safer assumption.

Thus, you must use the type override syntax in the query to tell the macros you are expecting a bool column. See the docs for query!() and query_as!() for details on this syntax.

NOTE: MySQL’s TIME type is signed

MySQL’s TIME type can be used as either a time-of-day value, or a signed interval. Thus, it may take on negative values.

Decoding a std::time::Duration returns an error if the TIME value is negative.

chrono

Requires the chrono Cargo feature flag.

Rust type	MySQL/MariaDB type(s)
chrono::DateTime<Utc>	TIMESTAMP
chrono::DateTime<Local>	TIMESTAMP
chrono::NaiveDateTime	DATETIME
chrono::NaiveDate	DATE
chrono::NaiveTime	TIME (time-of-day only)
chrono::TimeDelta	TIME (decodes full range; see note for encoding)

NOTE: MySQL’s TIME type is dual-purpose

MySQL’s TIME type can be used as either a time-of-day value, or an interval. However, chrono::NaiveTime is designed only to represent a time-of-day.

Decoding a TIME value as chrono::NaiveTime will return an error if the value is out of range.

The MySqlTime type supports the full range and it also implements TryInto<chrono::NaiveTime>.

Decoding a chrono::TimeDelta also supports the full range.

To encode a chrono::TimeDelta, convert it to MySqlTime first using TryFrom/TryInto.

time

Requires the time Cargo feature flag.

Rust type	MySQL/MariaDB type(s)
time::PrimitiveDateTime	DATETIME
time::OffsetDateTime	TIMESTAMP
time::Date	DATE
time::Time	TIME (time-of-day only)
time::Duration	TIME (decodes full range; see note for encoding)

NOTE: MySQL’s TIME type is dual-purpose

MySQL’s TIME type can be used as either a time-of-day value, or an interval. However, time::Time is designed only to represent a time-of-day.

Decoding a TIME value as time::Time will return an error if the value is out of range.

The MySqlTime type supports the full range, and it also implements TryInto<time::Time>.

Decoding a time::Duration also supports the full range.

To encode a time::Duration, convert it to MySqlTime first using TryFrom/TryInto.

bigdecimal

Requires the bigdecimal Cargo feature flag.

Rust type	MySQL/MariaDB type(s)
bigdecimal::BigDecimal	DECIMAL

decimal

Requires the decimal Cargo feature flag.

Rust type	MySQL/MariaDB type(s)
rust_decimal::Decimal	DECIMAL

uuid

Requires the uuid Cargo feature flag.

Rust type	MySQL/MariaDB type(s)
uuid::Uuid	BINARY(16), VARCHAR, CHAR, TEXT
uuid::fmt::Hyphenated	CHAR(36), UUID (MariaDB-only)
uuid::fmt::Simple	CHAR(32)

json

Requires the json Cargo feature flag.

Rust type	MySQL/MariaDB type(s)
[Json<T>]	JSON
serde_json::JsonValue	JSON
&serde_json::value::RawValue	JSON

Nullable

In addition, Option<T> is supported where T implements Type. An Option<T> represents a potentially NULL value from MySQL/MariaDB.

Structs

• MySqlTime
  Container for a MySQL TIME value, which may be an interval or a time-of-day.

Enums

• MySqlTimeError
  Errors returned by MySqlTime::new().
• MySqlTimeSign
  The sign for a MySqlTime type.