Documentation Home
MySQL Connector/C++ Release Notes
Related Documentation Download these Release Notes
PDF (US Ltr) - 406.4Kb
PDF (A4) - 406.3Kb

MySQL Connector/C++ Release Notes  /  Changes in MySQL Connector/C++ 1.0  /  Changes in MySQL Connector/C++ 1.0.1 (2008-12-01, Alpha)

Changes in MySQL Connector/C++ 1.0.1 (2008-12-01, Alpha)

Deprecation and Removal Notes

  • sql::mysql::MySQL_SQLException was removed. The distinction between server and client (connector) errors, based on the type of the exception, has been removed. However, the error code can still be checked to evaluate the error type.

  • Driver Manager was removed.

Functionality Added or Changed

  • Support for (n)make install was added. You can change the default installation path. Carefully read the messages displayed after executing cmake. The following are installed:

    • Static and the dynamic version of the library, libmysqlcppconn.

    • Generic interface, cppconn.

    • Two MySQL specific headers:

      mysql_driver.h, use this if you want to get your connections from the driver instead of instantiating a MySQL_Connection object. This makes your code portable when using the common interface.

      mysql_connection.h, use this if you intend to link directly to the MySQL_Connection class and use its specifics not found in sql::Connection.

      However, you can make your application fully abstract by using the generic interface rather than these two headers.

  • Added ConnectionMetaData::getSchemas() and Connection::setSchema().

  • ConnectionMetaData::getCatalogTerm() returns not applicable, there is no counterpart to catalog in Connector/C++.

  • Added experimental GCov support, cmake -DMYSQLCPPCONN_GCOV_ENABLE:BOOL=1

  • All examples can be given optional connection parameters on the command line, for example:

    examples/connect tcp://host:port user pass database


    examples/connect unix:///path/to/mysql.sock user pass database
  • Renamed ConnectionMetaData::getTables: TABLE_COMMENT to REMARKS.

  • Renamed ConnectionMetaData::getProcedures: PROCEDURE_SCHEMA to PROCEDURE_SCHEM.

  • Renamed ConnectionMetaData::getPrimaryKeys(): COLUMN to COLUMN_NAME, SEQUENCE to KEY_SEQ, and INDEX_NAME to PK_NAME.


  • Changed metadata column name TABLE_CATALOG to TABLE_CAT and TABLE_SCHEMA to TABLE_SCHEM to ensure JDBC compliance.

  • Introduced experimental CPack support, see make help.

  • All tests changed to create TAP compliant output.

  • Renamed sql::DbcMethodNotImplemented to sql::MethodNotImplementedException

  • Renamed sql::DbcInvalidArgument to sql::InvalidArgumentException

  • Changed sql::DbcException to implement the interface of JDBC's SQLException. Renamed to sql::SQLException.

  • Converted Connector/J tests were added.

  • MySQL Workbench 5.1 changed to use Connector/C++ for its database connectivity.

  • New directory layout.