Change Log

0.7.0 (2025-XX-XX)

Breaking changes:

Add [#[non_exhaustive]] attribute to [OracleType]
Change string form of [Timestamp] when precisions or “alternate” form is specified.
- "{:.n}" where n is 0~9 specifies the number of fractional seconds displayed.
- "{:#}" formats timestamps in ISO 8601 extended format.
- "{:-#}" formats timestamps in ISO 8601 basic format.

[Possibly-breaking changings]:

Bump MSRV (minimum supported rust version) to 1.68.0

New features:

Support VECTOR data type
- Add [OracleType::Vector] variant
- Add [InnerValue::Vector] variant
- Add [VecFmt] enum type
- Add [VecRef] enum type to set rust values to Oracle VECTOR data type
- Add [Vector] struct to get rust values from Oracle VECTOR data type
- Add [VectorFormat] trait type
- impl FromSql for Vec<f32>, Vec<f64>, Vec<i8> and Vec<u8> to get values from Oracle VECTOR data type

0.6.3 (2025-01-02)

New features:

Add [Connection::info()], [conn::Info] and [conn::ServerType] to get connection information
Add [Error::new()], [Error::add_source()], [Error::with_source()] and [Error::into_source()]
Add [InnerValue] and [SqlValue::as_inner_value()]
impl Default for InitParams and PoolOptions

Fixed Issues:

Fix panic when invalid argument Error is displayed

Internal Changes:

Update ODPI-C from 5.2.0 to 5.4.1. (see [ODPI-C release notes])
Improve performance of fetching numeric types when number column definition is out of range of i64. See #89 (comment)
Improve performance of fetching number columns by skipping UTF-8 validation

0.6.2 (2024-06-26)

Fixed Issues:

Fix memory leaks when [Batch] is explicitly closed by [close()][Batch::close()].

0.6.1 (2024-06-24)

New features:

Add [InitParams] to initialize the Oracle client library explicitly
Add [DbError::is_recoverable()] and [DbError::is_warning()]

Non-breaking Changes:

DbError::new() uses generics, which supports old types.

Internal Changes:

Improve performance of iterator for [ResultSet<T>][ResultSet] where T is [Row] by sharing an internal fetch array buffer. Before this change, one row in the buffer is copied to Row for each iteration. After this, new fetch array buffer is allocated when more rows must be fetched into a buffer but the buffer is referenced by Rows.

0.6.0 (2024-05-20)

Breaking changes:

Remove the lifetype parameter 'conn from [Statement] and remove stmt_without_lifetime feature added at 0.5.7
Add a new variant [OracleType::Xml]
Add a lifetime parameter to [SqlValue]
Change the return type of [Timestamp::new()], [Timestamp::and_tz_offset()], [Timestamp::and_tz_hm_offset()], and [Timestamp::and_prec()] to check the arguments
Change the return type of [IntervalDS::new()] and [IntervalDS::and_prec()] to check the arguments
Change the return type of [IntervalYM::new()] and [IntervalYM::and_prec()] to check the arguments
Remove [SqlValue::dup]
Add [#[non_exhaustive]] to [Error]
Remove deprecated trait method [Error::description] for [Error]
Remove [Connection::prepare()] and [StmtParam]

Deprecated:

All variants in [Error] enum are deprecated. The enum will be changed to struct in the future.

New features:

Add [Row::column_info()] to tell column names and types in [RowValue::get()]
Change the lifetime parameter of [ResultSet] to 'static when it is created by query methods of [Connection] or into_result_set methods of [Statement].
Send is implemented for the following types:
- [Statement]
- [ResultSet<'static, T>][ResultSet]
- [Row]
- [SqlValue]
- [Object]
- [Collection]

Changes:

Error messages are changed to follow "Error messages are typically concise lowercase sentences without trailing punctuation"
Update ODPI-C to 5.2.0. (see [ODPI-C release notes])
Update minimum supported Rust version to 1.60.0
Update rust edition to 2021
Change a undocumented method of the sealed trait [ColumnIndex]
Add #[drive(Debug)] for [Error] instead of explicitly implementing Debug for Error
Implement Error::source for Error

0.5.7 (2023-01-30)

New features:

Add stmt_without_lifetime feature flag.
Add [ObjectType::package_name()]
Add [Statement::last_row_id()]
Add [Connection::last_warning()]
Add [iter()][Collection::iter()], [indices()][Collection::indices()] and [values()][Collection::values()] methods, which creates iterators over [Collection] elements.

Fixed Issues:

[FromSql::from_sql] for chrono data types returns [Error::OutOfRange] instead of panics when an invalid timestamp is retrieved from Oracle.

Changes:

The [Eq] trait was implemented for enum types.

Internal Changes:

Update ODPI-C to 4.6.0. (see [ODPI-C release notes])

0.5.6 (2022-08-09)

Fixed Issues:

Fix RowValue which can reference an invalid Ok that defined outside (contributed by GH-62)

Changes:

[Connection::prepare()] was marked as deprecated.

Internal Changes:

Update ODPI-C to 4.4.1. (see [ODPI-C release notes])
Suppress 'cargo clippy' warnings
Use atomic types instead of RefCell and Mutex

0.5.5 (2022-05-11)

New features:

[RowValue derive macro] (contributed by GH-49)
Add query methods for Statement which take ownership (contributed by GH-50)
Support connection pooling
- [pool]
- [Connection::close_with_mode()]
- [Connection::tag()]
- [Connection::tag_found()]
- [Connection::is_new_connection()]
Add methods related to statement caching
- [Connector::stmt_cache_size()]
- [StatementBuilder::exclude_from_cache()]
- [StatementBuilder::tag()]
Support Advanced Queuing experimentally when aq_unstable feature is enabled Breaking changes may be introduced by a minor release.

Fixed bugs:

Fix resource leaks when statement are explicitly closed by [Statement::close()].
Fix syntax typo in doc comment about [Row::get_as()] (GH-54)

Internal Changes:

Update ODPI-C to 4.3.0. (see ODPI-C release notes: 4.3.0)

0.5.4 (2022-01-20)

Fixed bugs:

Fix resource leaks when Oracle object datatypes are used. (GH-48)

0.5.3 (2021-08-15)

New features:

Add [Connection::statement()][] and [StatementBuilder][] to create [Statement][] and deprecate [Connection::prepare()][].
Customize prefetch row size ([StatementBuilder::prefetch_rows()]) GH-40
Read/Write LOBs as streams ([sql_type::Lob][], [sql_type::Clob][], [sql_type::Nclob][] and [sql_type::Blob][])
Ref cursors including implicit statement results ([sql_type::RefCursor][]) GH-38
Add [Connection::oci_attr][], [Connection::set_oci_attr][], [Statement::oci_attr][] and [Statement::oci_attr][] to support OCI handle attributes.
Impl ToSql for &'a [u8; N]

Internal Changes:

Bind LOB columns as string or binary by default

0.5.2 (2021-06-11)

Update ODPI-C to 4.2.1. (see ODPI-C release notes: 4.2.0 and 4.2.1)
Make it possible to get rowid as string (GH-36)
Make it possible to bind boolean values (PL/SQL only)

0.5.1 (2021-04-18)

Add [Batch DML][Batch] feature (GH-29)
Implement FromStr for Version.
Add OracleType::Json variant. (Note: JSON data type has not been supported yet.)

0.4.0 (2021-03-07)

Changes:

Based on ODPI-C 4.1.0
The return value of [DbError::offset()][] was changed from u16 to u32.

0.3.3 (2020-10-25)

Changes:

Add new methods [Connection::call_timeout()][] and [Connection::set_call_timeout()][]

0.3.2 (2019-11-14)

Changes:

Fix SEGV while getting Object type's FLOAT data type attributes. (GH-19)
Add workaround to use with tracing-core. (GH-18)

0.3.1 (2019-10-05)

Changes:

Add a new method [Connection::status()][] and a new enum [ConnStatus][] to get the status of the connection.

0.3.0 (2019-10-02)

Incompatible changes:

Remove ConnParam enum and add Connector struct to use builder pattern.

The fourth argument of Connection::connect was removed.
From:

let conn = Connection::connect(username, password, connect_string, &[])?;

To:

let conn = Connection::connect(username, password, connect_string)?;

Use Connector to use additional parameters.
From:

let conn = Connection::connect(username, password, connect_string, &[ConnParam::Sysdba])?;

To:

let conn = Connector::new(username, password, connect_string).privilege(Privilege::Sysdba).connect()?;

or

let mut connector = Connector::new(username, password, connect_string);
connector.privilege(Privilege::Sysdba);
let conn = connector.connect().unwrap();

Add a new submodule sql_type and move the following structs, enums and traits from the root module to the submodule.
- Collection
- IntervalDS
- IntervalYM
- Object
- ObjectType
- ObjectTypeAttr
- OracleType
- Timestamp
- FromSql
- ToSql
- ToSqlNull
Remove client_version() method and add Version::client() method instead.
Remove the associated type Item from RowValue trait.
Add &Connection argument to trait methods: ToSql::oratype and ToSqlNull::oratype_for_null.
Iterator for &ResultSet<T> was removed and that for ResultSet<T> was added again for better ergonomics. Change for row_result in &result_set {...} to either for row_result in result_set {...} if the ResultSet can be consumed or to for row_result in result_set.by_ref() {...} otherwise.

Changes:

Implement FusedIterator for ResultSet.
The return value of [Connection::object_type()][] is cached in the connection.
When "CREATE TYPE", "ALTER TYPE" or "DROP TYPE" is executed, the cache clears.
Add Connection.clear_object_type_cache().
Update ODPI-C to version 3.2.2.

0.2.2 (2019-09-29)

Implement Sync and Send for Connection. (GH-14)

0.2.1 (2019-04-14)

Changes:

Fix memory corruption when using object and collection data types.
Update ODPI-C to version 3.1.3.

0.2.0 (2018-10-02)

Incompatible changes:

Make errors usable across threads (GH-6)

0.1.2 (2018-09-22 - yanked because of packaging miss)

Changes:

Change the license to the Universal Permissive License v 1.0 and/or the Apache License v 2.0.
Update ODPI-C to 3.0.0, which includes support for Oracle 18c client.
New methods
- [Statement::row_count()][]

0.1.1 (2018-07-16)

Changes:

Allow fetching BLOB data as Vec<u8>.
Implement ToSql and ToSqlNull for &[u8].
Implement Debug for Connection, Statement and so on.
Update ODPI-C to version 2.4.2.

0.1.0 (2018-04-15)

Changes:

New methods
- [Statement::is_query()][]
- [Statement::is_plsql()][]
- [Statement::is_ddl()][]
- [Statement::is_dml()][]

Incompatible changes:

Iterator for ResultSet<T> was removed and that for &ResultSet<T> was added in order not to consume ResultSet<T> by for-loop.
Change for row_result in result_set {...} to for row_result in &result_set {...}.

0.0.8 (2018-03-25)

Fixed bugs:

Fix an error when a column value converted from the database character set to UTF-8 becomes longer than the column size. (GH-3)

Incompatible changes:

BindIndex and ColumnIndex were sealed and cannot be implemented for types outside of the crate.
The Other variant of [StatetmentType][] enum was removed. Commit, Rollback, ExplainPlan, Call and Unknown variants were added to the enum.
Change the return type of [ObjectType::new_object()][] from Option<Object> to Result<Object>.
Change the return type of [ObjectType::new_collection()][] from Option<Collection> to Result<Collection>.

0.0.7 (2018-03-18)

The method to prepare statements was changed for future extension.

Changes:

New methods and structs
- [Statement::returned_values()][] to support RETURNING INTO clause.
- [StmtParam][] struct to specify prepared statement parameters.

Incompatible changes:

Changed Methods
- [Connection::prepare()][]. The params argument was added.
Removed methods
- Statement::set_fetch_array_size(). Use [StmtParam::FetchArraySize][] instead.

0.0.6 (2018-03-11)

Methods for establishing connections were changed in order to avoid incompatible changes when connection pooling is supported in future.

Changes:

New methods and enums.
- [Connection::connect()][]
- [ConnParam][]
Deprecated methods.
- Connnection::new(). Use [Connection::connect()][] instead.

Incompatible changes:

Renamed variants.
- Error::NoMoreData → [Error::NoDataFound][]
Removed structs and enums.
- Connector (connection builder). Use [ConnParam][] in order to specify extra connection parameters instead.
- AuthMode. Use [ConnParam][] to specify authentication mode instead.
Methods whose return type was changed from &String to &str.
- [Connection::tag()][]
- [ColumnInfo::name()][]
- [DbError::message()][]
- [DbError::fn_name()][]
- [DbError::action()][]
- [ObjectType::schema()][]
- [ObjectType::name()][]
- [ObjectTypeAttr::name()][]
Methods whose return type was changed from &Vec<...> to &[...].
- [Row::sql_values()][]
- [ResultSet::column_info()][]
- [ObjectType::attributes()][]

0.0.5 (2018-03-04)

New features:

Add query methods to Connection to fetch rows without using Statement.
- [Connection::query()][]
- [Connection::query_named()][]
- [Connection::query_as()][]
- [Connection::query_as_named()][]
Add query_row methods to Statement to fetch a first row without using ResultSet.
- [Statement::query_row()][]
- [Statement::query_row_named()][]
- [Statement::query_row_as()][]
- [Statement::query_row_as_named()][]

Incompatible changes:

Merge RowResultSet struct into RowValueResultSet and rename it to ResultSet.

0.0.4 (2018-02-25)

New features:

Add query methods to Statement to fetch rows as iterator.
- [Statement::query()][]
- [Statement::query_named()][]
- [Statement::query_as()][]
- [Statement::query_as_named()][]
Add query_row methods to Connection to fetch a first row without using Statement.
- [Connection::query_row()][]
- [Connection::query_row_named()][]
- [Connection::query_row_as()][]
- [Connection::query_row_as_named()][]
Autocommit mode.

Incompatible changes:

Execute methods fail for select statements. Use query methods instead.
- [Connection::execute()][]
- [Connection::execute_named()][]
- [Statement::execute()][]
- [Statement::execute_named()][]
Renamed traits, methods and variants.
- ColumnValues → [RowValue][]
- Row::values() → [Row::get_as()][]
- Row::columns() → [Row::sql_values()][]
- Error::Overflow → [Error::OutOfRange][]
Removed methods.
- Statement::column_count()
- Statement::column_names()
- Statement::column_info()
- Statement::fetch()
- SqlValue::clone()

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!