MySQL Connector/C++ Release Notes

3.24 Changes in MySQL Connector/C++ 8.0.14 (2019-01-21, General Availability)

Configuration Notes

Packaging Notes

  • Previously, Connector/C++ binary distributions included a BUILDINFO.txt file that contained information about the build environment used to produce the distribution. Binary distributions now include a file named INFO_BIN that provides similar information, and an INFO_SRC file that provides information about the product version and the source repository from which the distribution was produced. Source distributions include the INFO_SRC file only. (WL #12293)

  • Connector/C++ now is compatible with MSVC 2017, while retaining compatibility with MSVC 2015:

    • Previously, Connector/C++ binary distributions were compatible with projects built using MSVC 2015. Binary distributions now are compatible with projects built using MSVC 2017 or 2015. DLLs have a -vs14 suffix in their names to reflect that they are compatible with MSVC 2015, but can also be used in MSVC 2017 projects.

    • Previously, Connector/C++ source distributions could be built using MSVC 2015. Source distributions now can be built using MSVC 2017 or 2015.

    • Previously, the MSI installer accepted the Visual C++ Redistributable for Visual Studio 2015. The MSI installer now accepts the Visual C++ Redistributable for Visual Studio 2017 or 2015.

    (WL #12611)

  • Installers for Connector/C++ are now available as Debian packages. See Installing Connector/C++ from a Binary Distribution. (WL #12101)

X DevAPI Notes

  • Connector/C++ now provides collection counting methods for applications that use X DevAPI for C:

    • mysqlx_collection_count(): The number of documents in a collection without filtering. 

      mysqlx_collection_t *c1 = mysqlx_get_collection(schema, "c1", 1);
ulong64_t documents;
mysqlx_collection_count(c1, &documents);

    • mysqlx_table_count(): The number of rows in a table without filtering. 

      mysqlx_table_t *t1 = mysqlx_get_table(schema, "t1", 1);
ulong64_t rows;
mysqlx_table_count(t1, &rows);

    • mysqlx_get_count(): The number of remaining cached rows held at the moment. After a row is consumed by a fetch function, the number of cached rows decreases. 

      mysqlx_stmt_t *stmt = mysqlx_sql_new(session, query, strlen(query));
mysqlx_result_t *res = mysqlx_execute(stmt);

ulong64_t row_count;
mysqlx_get_count(res, &row_count);

      mysqlx_get_count() is similar in all respects to mysqlx_store_result() except that the behavior differs after fetching rows when reaching zero number of rows in the cache:

      • mysqlx_get_count() returns zero through the parameter and finishes with RESULT_OK.

      • mysqlx_store_result() does not return anything through the parameter (which remains unchanged) and finishes with RESULT_ERROR.

    (WL #12496)

MySQL Documentation Library