Skip to content

Latest commit

 

History

History
1271 lines (933 loc) · 50.9 KB

CHANGELOG.md

File metadata and controls

1271 lines (933 loc) · 50.9 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.5.13 - 2022-04-15

This is a hotfix that reverts #1748 as that was an accidental breaking change:
the generated PgHasArrayType impl conflicts with manual impls of the trait.
This change will have to wait for 0.6.0.

0.5.12 - 2022-04-13 (Yanked; use 0.5.13)

27 pull requests were merged this release cycle.

Added

  • [#1641]: Postgres: Convenient wrapper for advisory locks [@abonander]
  • [#1675]: Add function to undo migrations [@jdrouet]
  • [#1722]: Postgres: implement PgHasArrayType for serde_json::{Value, RawValue} [@abreis]
  • [#1736]: Derive Clone for MySqlArguments and MssqlArguments [@0xdeafbeef]
  • [#1748]: Derive PgHasArrayType for #[sqlx(transparent)] types [@carols10cents]
  • [#1754]: Include affected rows alongside returned rows in query logging [@david-mcgillicuddy-moixa]
  • [#1757]: Implement Type for Cow<str> for MySQL, MSSQL and SQLite [@ipetkov]
  • [#1769]: sqlx-cli: add --source to migration subcommands [@pedromfedricci]
  • [#1774]: Postgres: make extra_float_digits settable [@abonander]
    • Can be set to None for Postgres or third-party database servers that don't support the option.
  • [#1776]: Implement close-event notification for Pool [@abonander]
    • Also fixes PgListener preventing Pool::close() from resolving.
  • [#1780]: Implement query builder [@crajcan]
  • [#1781]: Postgres: support NUMERIC[] using decimal feature [@tm-drtina]
  • [#1784]: SQLite: add FromStr, Copy, PartialEq, Eq impls for options enums [@andrewwhitehead]

Changed

Fixed

0.5.11 - 2022-02-17

20 pull requests were merged this release cycle.

Added

Changed

Fixed

Additionally, we have introduced two mitigations for the issue of the cyclic dependency on ahash:

  • We re-downgraded our version requirement on indexmap from 1.7.0 back to 1.6.2 so users can pin it to that version as recommended in aHash#95.
  • Thanks to the work of @LovecraftianHorror in #1684, we no longer require the preserve_order feature of serde_json which gives users another place to break the cycle by simply not enabling that feature.
    • This may introduce extra churn in Git diffs for sqlx-data.json, however. If this is an issue for you but the dependency cycle isn't, you can re-enable the preserve_order feature:
    [dependencies]
serde_json = { version = "1", features = ["preserve_order"] }

0.5.10 - 2021-12-29

A whopping 31 pull requests were merged this release cycle!

According to this changelog, we saw 18 new contributors! However, some of these folks may have missed getting mentioned in previous entries since we only listed highlights. To avoid anyone feeling left out, I put in the effort this time and tried to list every single one here.

Added

Changes

Fixes

  • [#1475]: Fix panic when converting a negative chrono::Duration to PgInterval [@yuyawk]
  • [#1483]: Fix error when decoding array of custom types from Postgres [@demurgos
  • [#1501]: Reduce indexmap version requirement to 1.6.2 [@dimfeld]
  • [#1511]: Fix element type given to Postgres for arrays of custom enums [@chesedo]
  • [#1517]: Fix mismatched type errors in MySQL type tests [@abonander]
  • [#1537]: Fix missing re-export of PgCopyIn [@akiradeveloper]
  • [#1566]: Match ~/.pgpass password after URL parsing and fix user and database ordering [@D1plo1d]
  • [#1582]: cargo sqlx prepare: Append to existing RUSTFLAGS instead of overwriting [@tkintscher]
  • [#1587]: SQLite: if set, send PRAGMA key on a new connection before anything else. [@parazyd]
    • This should fix problems with being unable to open databases using SQLCipher.

0.5.9 - 2021-10-01

A hotfix release to address the issue of the sqlx crate itself still depending on older versions of sqlx-core and sqlx-macros.

No other changes from 0.5.8.

0.5.8 - 2021-10-01 (Yanked; use 0.5.9)

A total of 24 pull requests were merged this release cycle! Some highlights:

  • [#1289] Support the immutable option on SQLite connections [@djmarcin]
  • [#1295] Support custom initial options for SQLite [@ghassmo]
    • Allows specifying custom PRAGMAs and overriding those set by SQLx.
  • [#1345] Initial support for Postgres COPY FROM/TO[@montanalow, @abonander]
  • [#1439] Handle multiple waiting results correctly in MySQL [@eagletmt]

0.5.7 - 2021-08-20

  • [#1392] use resolve_path when getting path for include_str!() [@abonander]
    • Fixes a regression introduced by [#1332].
  • [#1393] avoid recursively spawning tasks in PgListener::drop() [@abonander]
    • Fixes a panic that occurs when PgListener is dropped in async fn main().

0.5.6 - 2021-08-16

A large bugfix release, including but not limited to:

  • [#1329] Implement MACADDR type for Postgres [@nomick]
  • [#1363] Fix PortalSuspended for array of composite types in Postgres [@AtkinsChang]
  • [#1320] Reimplement sqlx::Pool internals using futures-intrusive [@abonander]
    • This addresses a number of deadlocks/stalls on acquiring connections from the pool.
  • [#1332] Macros: tell the compiler about external files/env vars to watch [@abonander]
    • Includes sqlx build-script to create a build.rs to watch migrations/ for changes.
    • Nightly users can try RUSTFLAGS=--cfg sqlx_macros_unstable to tell the compiler to watch migrations/ for changes instead of using a build script.
    • See the new section in the docs for sqlx::migrate!() for details.
  • [#1351] Fix a few sources of segfaults/errors in SQLite driver [@abonander]
  • [#1323] Keep track of column typing in SQLite EXPLAIN parsing [@marshoepial]
    • This fixes errors in the macros when using INSERT/UPDATE/DELETE ... RETURNING ... in SQLite.

A total of 25 pull requests were merged this release cycle!

0.5.5 - 2021-05-24

  • [#1242] Fix infinite loop at compile time when using query macros [@toshokan]

0.5.4 - 2021-05-22

  • [#1235] Fix compilation with rustls from an eager update to webpki [@ETCaton]

0.5.3 - 2021-05-21

0.5.2 - 2021-04-15

PostgreSQL

  • [#1170] Remove Self: Type bounds in Encode / Decode implementations for arrays [@jplatte]

    Enables working around the lack of support for user-defined array types:

    #[derive(sqlx::Encode)]
struct Foos<'a>(&'a [Foo]);

impl sqlx::Type<sqlx::Postgres> for Foos<'_> {
    fn type_info() -> PgTypeInfo {
        PgTypeInfo::with_name("_foo")
    }
}

query_as!(
    Whatever,
    "<QUERY with $1 of type foo[]>",
    Foos(&foo_vec) as _,
)

  • [#1141] Use u16::MAX instead of i16::MAX for a check against the largest number of parameters in a query [@crajcan]

  • [#1112] Add support for DOMAIN types [@demurgos]

  • [#1100] Explicitly UNLISTEN before returning connections to the pool in PgListener [@Diggsey]

SQLite

  • [#1161] Catch SQLITE_MISUSE on connection close and panic [@link2xt]

  • [#1160] Do not cast pointers to i32 (cast to usize) [@link2xt]

  • [#1156] Reset the statement when fetch_many stream is dropped [@link2xt]

0.5.1 - 2021-02-04

  • Update sqlx-rt to 0.3.

0.5.0 - 2021-02-04

Changes

  • [#983] [#1022] Upgrade async runtime dependencies [@seryl, @ant32, @jplatte, @robjtede]

    • tokio 1.0
    • actix-rt 2.0

  • [#854] Allow chaining map and try_map [@jplatte]

    Additionally enables calling these combinators with the macros:

    let ones: Vec<i32> = query!("SELECT 1 as foo")
    .map(|row| row.foo)
    .fetch_all(&mut conn).await?;

  • [#940] Rename the #[sqlx(rename)] attribute used to specify the type name on the database side to #[sqlx(type_name)] [@jplatte].

  • [#976] Rename the DbDone types to DbQueryResult. [@jplatte]

  • [#976] Remove the Done trait. The .rows_affected() method is now available as an inherent method on PgQueryResult, MySqlQueryResult and so on. [@jplatte]

  • [#1007] Remove any::AnyType (and replace with directly implementing Type<Any>) [@jplatte]

Added

Fixes

  • [#1002] For SQLite, GROUP BY in query! caused an infinite loop at compile time. [@pymongo]

  • [#979] For MySQL, fix support for non-default authentication. [@sile]

  • [#918] Recover from dropping wait_for_conn inside Pool. [@antialize]

0.4.2 - 2020-12-19

SQLite

PostgreSQL

MySQL

0.4.1 – 2020-11-13

Fix docs.rs build by enabling a runtime feature in the docs.rs metadata in Cargo.toml.

0.4.0 - 2020-11-12

  • [#774] Fix usage of SQLx derives with other derive crates [@NyxCode]

  • [#762] Fix migrate!() (with no params) [@esemeniuc]

  • [#755] Add kebab-case to rename_all [@iamsiddhant05]

  • [#735] Support rustls [@jplatte]

    Adds -native-tls or -rustls on each runtime feature:

    # previous
features = [ "runtime-async-std" ]

# now
features = [ "runtime-async-std-native-tls" ]

  • [#718] Support tuple structs with #[derive(FromRow)] [@dvermd]

SQLite

PostgreSQL

  • [#781] Fix decimal conversions handling of 0.01 [@pimeys]

  • [#745] Always prefer parsing of the non-localized notice severity field [@dstoeckel]

  • [#742] Enable Vec<DateTime<Utc>> with chrono [@mrcd]

MySQL

  • [#743] Consider utf8mb4_bin as a string [[@digorithm]]

  • [#739] Fix minor protocol detail with iteration-count that was blocking Vitess [@mcronce]

0.4.0-beta.1 - 2020-07-27

Highlights

  • Enable compile-time type checking from cached metadata to enable building in an environment without access to a development database (e.g., Docker, CI).

  • Initial support for Microsoft SQL Server. If there is something missing that you need, open an issue. We are happy to help.

  • SQL migrations, both with a CLI tool and programmatically loading migrations at runtime.

  • Runtime-determined database driver, Any, to support compile-once and run with a database driver selected at runtime.

  • Support for user-defined types and more generally overriding the inferred Rust type from SQL with compile-time SQL verification.

Fixed

MySQL

Added

  • [#174] Inroduce a builder to construct connections to bypass the URI parsing

    // MSSQL
let conn = MssqlConnectOptions::new()
    .host("localhost")
    .database("master")
    .username("sa")
    .password("Password")
    .connect().await?;

// SQLite
let conn = SqliteConnectOptions::from_str("sqlite://a.db")?
    .foreign_keys(false)
    .connect().await?;

  • [#127] Get the last ID or Row ID inserted for MySQL or SQLite

    // MySQL
let id: u64 = query!("INSERT INTO table ( col ) VALUES ( ? )", val)
    .execute(&mut conn).await?
    .last_insert_id(); // LAST_INSERT_ID()

// SQLite
let id: i64 = query!("INSERT INTO table ( col ) VALUES ( ?1 )", val)
    .execute(&mut conn).await?
    .last_insert_rowid(); // sqlite3_last_insert_rowid()

  • [#263] Add hooks to the Pool: after_connect, before_release, and after_acquire

    // PostgreSQL
let pool = PgPoolOptions::new()
    .after_connect(|conn| Box::pin(async move {
        conn.execute("SET application_name = 'your_app';").await?;
        conn.execute("SET search_path = 'my_schema';").await?;

        Ok(())
    }))
    .connect("postgres:// …").await?

  • [#308] [#495] Extend derive(FromRow) with support for #[sqlx(default)] on fields to allow reading in a partial query [@OriolMunoz]

  • [#454] [[#456]] Support rust_decimal::Decimal as an alternative to bigdecimal::BigDecimal for NUMERIC columns in MySQL and PostgreSQL [@pimeys]

  • [#181] Column names and type information is now accessible from Row via Row::columns() or Row::column(name)

PostgreSQL

  • [#197] [#271] Add initial support for INTERVAL (full support pending a time::Period type) [@dimtion]

MySQL

  • [#449] [[#450]] Support Unix Domain Sockets (UDS) for MySQL [@pimeys]

SQLite

  • Types are now inferred for expressions. This means its now possible to use query! and query_as! for:

    let row = query!("SELECT 10 as _1, x + 5 as _2 FROM table").fetch_one(&mut conn).await?;

assert_eq!(row._1, 10);
assert_eq!(row._2, 5); // 5 + x?

  • [#167] Support foreign_keys explicitly with a foreign_keys(true) method available on SqliteConnectOptions which is a builder for new SQLite connections (and can be passed into PoolOptions to build a pool).

    let conn = SqliteConnectOptions::new()
    .foreign_keys(true) // on by default
    .connect().await?;

  • [#430] [#438] Add method to get the raw SQLite connection handle [@agentsim]

    // conn is `SqliteConnection`
// this is not unsafe, but what you do with the handle will be
let ptr: *mut libsqlite3::sqlite3 = conn.as_raw_handle();

  • [#164] Support TIMESTAMP, DATETIME, DATE, and TIME via chrono in SQLite [@felipesere] [@meteficha]

Changed

  • Transaction now mutably borrows a connection instead of owning it. This enables a new (or nested) transaction to be started from &mut conn.

  • [#145] [#444] Use a least-recently-used (LRU) cache to limit the growth of the prepared statement cache for SQLite, MySQL, and PostgreSQL [@pimeys]

SQLite

  • [#499] INTEGER now resolves to i64 instead of i32, INT4 will still resolve to i32

Removed

0.3.5 - 2020-05-06

Fixed

  • [#259] Handle percent-encoded paths for SQLite [@g-s-k]

  • [#281] Deallocate SQLite statements before closing the SQLite connection [@hasali19]

  • [#284] Fix handling of 0 for BigDecimal in PostgreSQL and MySQL [@abonander]

Added

  • [#256] Add query_unchecked! and query_file_unchecked! with similar semantics to query_as_unchecked! [@meh]

  • [#252] [#297] Derive several traits for the Json<T> wrapper type [@meh]

  • [#261] Add support for #[sqlx(rename_all = "snake_case")] to #[derive(Type)] [@shssoichiro]

  • [#253] Add support for UNIX domain sockets to PostgreSQL [@Nilix007]

  • [#251] Add support for textual JSON on MySQL [@blackwolf12333]

  • [#275] [#268] Optionally log formatted SQL queries on execution [@shssoichiro]

  • [#267] Support Cargo.toml relative .env files; allows for each crate in a workspace to use their own .env file and thus their own DATABASE_URL [@xyzd]

0.3.4 - 2020-04-10

Fixed

  • [#241] Type name for custom enum is not always attached to TypeInfo in PostgreSQL

  • [#237] [#238] User-defined type name matching is now case-insensitive in PostgreSQL [@qtbeee]

  • [#231] Handle empty queries (and those with comments) in SQLite

  • [#228] Provide MapRow implementations for functions (enables .map(|row| ...) over .try_map(|row| ...))

Added

  • [#234] Add support for NUMERIC in MySQL with the bigdecimal crate [@xiaopengli89]

  • [#227] Support #[sqlx(rename = "new_name")] on struct fields within a FromRow derive [@sidred]

0.3.3 - 2020-04-01

Fixed

Changed

  • [#216] Mark Cursor, Query, QueryAs, query::Map, and Transaction as #[must_use] [@Ace4896]

  • [#213] Remove matches dependency and use matches macro from std [@nrjais]

0.3.2 - 2020-03-31

Fixed

  • [#212] Removed sneaky println! in MySqlCursor

0.3.1 - 2020-03-30

Fixed

  • [#203] Allow an empty password for MySQL

  • [#204] Regression in error reporting for invalid SQL statements on PostgreSQL

  • [#200] Fixes the incorrect handling of raw (r#...) fields of a struct in the FromRow derive [@sidred]

0.3.0 - 2020-03-29

Breaking Changes

  • sqlx::Row now has a lifetime ('c) tied to the database connection. In effect, this means that you cannot store Rows or collect them into a collection. Query (returned from sqlx::query()) has map() which takes a function to map from the Row to another type to make this transition easier.

    In 0.2.x

    let rows = sqlx::query("SELECT 1")
    .fetch_all(&mut conn).await?;

    In 0.3.x

    let values: Vec<i32> = sqlx::query("SELECT 1")
    .map(|row: PgRow| row.get(0))
    .fetch_all(&mut conn).await?;

    To assist with the above, sqlx::query_as() now supports querying directly into tuples (up to 9 elements) or struct types with a #[derive(FromRow)].

    // This extension trait is needed until a rust bug is fixed
use sqlx::postgres::PgQueryAs;

let values: Vec<(i32, bool)> = sqlx::query_as("SELECT 1, false")
    .fetch_all(&mut conn).await?;

  • HasSqlType<T>: Database is now T: Type<Database> to mirror Encode and Decode

  • Query::fetch (returned from query()) now returns a new Cursor type. Cursor is a Stream-like type where the item type borrows into the stream (which itself borrows from connection). This means that using query().fetch() you can now stream directly from the database with zero-copy and zero-allocation.

  • Remove PgTypeInfo::with_oid and replace with PgTypeInfo::with_name

Added

  • Results from the database are now zero-copy and no allocation beyond a shared read buffer for the TCP stream ( in other words, almost no per-query allocation ). Bind arguments still do allocate a buffer per query.

  • [#129] Add support for SQLite. Generated code should be very close to normal use of the C API.

    • Adds Sqlite, SqliteConnection, SqlitePool, and other supporting types

  • [#97] [#134] Add support for user-defined types. [@Freax13]

    • Rust-only domain types or transparent wrappers around SQL types. These may be used transparently inplace of the SQL type.

      #[derive(sqlx::Type)]
#[repr(transparent)]
struct Meters(i32);

    • Enumerations may be defined in Rust and can match SQL by integer discriminant or variant name.

      #[derive(sqlx::Type)]
#[repr(i32)] // Expects a INT in SQL
enum Color { Red = 1, Green = 2, Blue = 3 }
      #[derive(sqlx::Type)]
#[sqlx(rename = "TEXT")] // May also be the name of a user defined enum type
#[sqlx(rename_all = "lowercase")] // similar to serde rename_all
enum Color { Red, Green, Blue } // expects 'red', 'green', or 'blue'

    • Postgres further supports user-defined composite types.

      #[derive(sqlx::Type)]
#[sqlx(rename = "interface_type")]
struct InterfaceType {
    name: String,
    supplier_id: i32,
    price: f64
}

  • [#98] [#131] Add support for asynchronous notifications in Postgres (LISTEN / NOTIFY). [@thedodd]

    • Supports automatic reconnection on connection failure.

    • PgListener implements Executor and may be used to execute queries. Be careful however as if the intent is to handle and process messages rapidly you don't want to be tying up the connection for too long. Messages received during queries are buffered and will be delivered on the next call to recv().

    let mut listener = PgListener::new(DATABASE_URL).await?;

listener.listen("topic").await?;

loop {
    let message = listener.recv().await?;

    println!("payload = {}", message.payload);
}

  • Add unchecked variants of the query macros. These will still verify the SQL for syntactic and semantic correctness with the current database but they will not check the input or output types.

    This is intended as a temporary solution until query_as! is able to support user defined types.

    • query_as_unchecked!
    • query_file_as_unchecked!

  • Add support for many more types in Postgres

    • JSON, JSONB [@oeb25]
    • INET, CIDR [@PoiScript]
    • Arrays [@oeb25]
    • Composites ( Rust tuples or structs with a #[derive(Type)] )
    • NUMERIC [@abonander]
    • OID (u32)
    • "CHAR" (i8)
    • TIMESTAMP, TIMESTAMPTZ, etc. with the time crate [@utter-step]
    • Enumerations ( Rust enums with a #[derive(Type)] ) [@Freax13]

Changed

  • Query (and QueryAs; returned from query(), query_as(), query!(), and query_as!()) now will accept both &mut Connection or &Pool where as in 0.2.x they required &mut &Pool.

  • Executor now takes any value that implements Execute as a query. Execute is implemented for Query and QueryAs to mean exactly what they've meant so far, a prepared SQL query. However, Execute is also implemented for just &str which now performs a raw or unprepared SQL query. You can further use this to fetch Rows from the database though it is not as efficient as the prepared API (notably Postgres and MySQL send data back in TEXT mode as opposed to in BINARY mode).

    use sqlx::Executor;

// Set the time zone parameter
conn.execute("SET TIME ZONE LOCAL;").await

// Demonstrate two queries at once with the raw API
let mut cursor = conn.fetch("SELECT 1; SELECT 2");
let row = cursor.next().await?.unwrap();
let value: i32 = row.get(0); // 1
let row = cursor.next().await?.unwrap();
let value: i32 = row.get(0); // 2

Removed

  • Query (returned from query()) no longer has fetch_one, fetch_optional, or fetch_all. You must map the row using map() and then you will have a query::Map value that has the former methods available.

    let values: Vec<i32> = sqlx::query("SELECT 1")
    .map(|row: PgRow| row.get(0))
    .fetch_all(&mut conn).await?;

Fixed

  • [#62] [#130] [#135] Remove explicit set of IntervalStyle. Allow usage of SQLx for CockroachDB and potentially PgBouncer. [@bmisiak]

  • [#108] Allow nullable and borrowed values to be used as arguments in query! and query_as!. For example, where the column would resolve to String in Rust (TEXT, VARCHAR, etc.), you may now use Option<String>, Option<&str>, or &str instead. [@abonander]

  • [#108] Make unknown type errors far more informative. As an example, trying to SELECT a DATE column will now try and tell you about the chrono feature. [@abonander]

    optional feature `chrono` required for type DATE of column #1 ("now")

0.2.6 - 2020-03-10

Added

Fixed

0.2.5 - 2020-02-01

Fixed

  • Fix decoding of Rows containing NULLs in Postgres #104

  • After a large review and some battle testing by @ianthetechie of the Pool, a live leaking issue was found. This has now been fixed by @abonander in #84 which included refactoring to make the pool internals less brittle (using RAII instead of manual work is one example) and to help any future contributors when changing the pool internals.

  • Passwords are now being percent-decoded before being presented to the server [@repnop]

  • [@100] Fix FLOAT and DOUBLE decoding in MySQL

Added

  • [#72] Add PgTypeInfo::with_oid to allow simple construction of PgTypeInfo which enables HasSqlType to be implemented by downstream consumers of SQLx [@jplatte]

  • [#96] Add support for returning columns from query! with a name of a rust keyword by using raw identifiers [@yaahc]

  • [#71] Implement derives for Encode and Decode. This is the first step to supporting custom types in SQLx. [@Freax13]

0.2.4 - 2020-01-18

Fixed

  • Fix decoding of Rows containing NULLs in MySQL (and add an integration test so this doesn't break again)

0.2.3 - 2020-01-18

Fixed

  • Fix query! when used on a query that does not return results

0.2.2 - 2020-01-16

Added

  • [#57] Add support for unsigned integers and binary types in query! for MySQL [@mehcode]

Fixed

  • Fix stall when requesting TLS from a Postgres server that explicitly does not support TLS (such as postgres running inside docker) [@abonander]

  • [#66] Declare used features for tokio in sqlx-macros explicitly

0.2.1 - 2020-01-16

Fixed

  • [#55] Use a shared tokio runtime for the query! macro compile-time execution (under the runtime-tokio feature) [@udoprog]

0.2.0 - 2020-01-15

Fixed

Added

  • Support Tokio through an optional runtime-tokio feature.

  • Support SQL transactions. You may now use the begin() function on Pool or Connection to start a new SQL transaction. This returns sqlx::Transaction which will ROLLBACK on Drop or can be explicitly COMMIT using commit().

  • Support TLS connections.

0.1.4 - 2020-01-11

Fixed

Added

0.1.3 - 2020-01-06

Fixed

0.1.2 - 2020-01-03

Added

  • Support for Authentication in MySQL 5+ including the newer authentication schemes now default in MySQL 8: mysql_native_password, sha256_password, and caching_sha2_password.

  • Chrono support for MySQL was only partially implemented (was missing NaiveTime and DateTime<Utc>).

  • Vec<u8> (and [u8]) support for MySQL (BLOB) and Postgres (BYTEA).