Odbc-safe

Note: This crate is no longer maintained. Try using odbc-api.

Introduction

This Rust crate builds upon the FFI (Foreign Function Interface) bindings for ODBC (Open Database Connectivity) provided by odbc-sys. It enables you to write ODBC Applications entirely in safe Rust. While this crate tries to prevent all kinds of erros it does very little to hide the complexity of ODBC, as it tries to be the smallest safe layer around odbc-sys. Therfore code written with this library is likely to be safe, but unlikely to look like idiomatic Rust. For a library offering greater convinience have a look at odbc-rs.

Design Goals

Zero cost abstraction
Catch Invalid Handle Errors at compile time
Prevent bound buffers or columns from going out of scope
Catch Function Sequence Errors at compile time
Not to abstract away any power of the underlying API

Current State

This library currently supports:

Direct execution of queries
Prepared execution of queries
Binding parameters
Retrieving Result Sets (kind of slow via SQLGetData)

Currently unsupported:

Binding columns to Result Sets
Multi threading and asynchronous capabilities

Documentation

Thanks to the folks of docs.rs for building and hosting the documentation!

Contributing