This is a release of MongoDB ODBC driver, the driver that enables ODBC applications to communicate with MongoDB's Connector for Business Intelligence.
For the avoidance of doubt, this particular copy of the software is released under the version 2 of the GNU General Public License and is a fork of the MySQL Connector/ODBC (formerly MyODBC) version 5.7.21.
The original README file provided with the upstream repository can be found below.
Copyright (c) 1995, 2018, Oracle and/or its affiliates. All rights reserved. Copyright (c) 2018 MongoDB Inc.
License information can be found in the COPYING file.
MySQL FOSS License Exception We maintain the MySQL FOSS License Exception from MySQL: we want free and open source software applications under certain licenses to be able to use the GPL-licensed MongoDB ODBC (specified GPL-licensed MySQL client libraries) despite the fact that not all such FOSS licenses are compatible with version 2 of the GNU General Public License. Therefore there are special exceptions to the terms and conditions of the GPLv2 as applied to these client libraries, which are identified and described in more detail in the FOSS License Exception at http://www.mysql.com/about/legal/licensing/foss-exception.html
This distribution may include materials developed by third parties. For license and attribution notices for these materials, please refer to the documentation that accompanies this distribution (see the "Licenses for Third-Party Components" appendix) or view the online documentation at http://dev.mysql.com/doc/
GPLv2 Disclaimer For the avoidance of doubt, except that if any license choice other than GPL or LGPL is available it will apply instead, Oracle elects to use only the General Public License version 2 (GPLv2) at this time for any software where a choice of GPL license versions is made available with the language indicating that GPLv2 or any later version may be used, or where a choice of which version of the GPL is applied is otherwise unspecified.
CONTENTS
- Introduction
- Building Source
- Installing
- Binary Files
- MongoDB ODBC SDK
- Resources
This is the source or binary distribution of ODBC for MongoDB. This software is distributed with restrictions - please see the license information for details.
Open Database Connectivity (ODBC) is a widely accepted standard for reading/writing data. ODBC is designed in a similar manner to the MS Windows printing system in that it has a Driver Manager and Drivers. MongoDB ODBC is a driver for the ODBC system which allows applications to communicate with the MySQL Server using the ODBC standard. ODBC implementations exist on all popular platforms and MongoDB ODBC is also available on those platforms.
MongoDB provides support for ODBC by means of the MongoDB ODBC driver and the MongoDB Connector for Business Intelligence (BI Connector). MongoDB ODBC is ODBC 3.5x compliant, and provides a MySQL interface to MongoDB through the BI Connector. This ODBC driver is designed specifically for use with MongoDB's Connector for Business Intelligence, and in conjunction with a MongoDB server.
To get all functionality from the ODBC 1.0 driver (e.g. transaction support) you should use it against MongoDB 3.6 or later, though less performant support is maintained for MongoDB 3.2+.
Please see the BUILD file for details on building the source code. This is included with the source distribution.
Please see the INSTALL file for details on installing.
The following, key, files are provided by MongoDB ODBC (the MS Windows names are included for reference but the file names for other platforms would be similar).
Driver (mdbodbca.dll and mdbodbcw.dll)
The most important part of MongoDB ODBC is the driver.
Application developers can link directly to the driver but
more often use the driver indirectly, via a Driver Manager
such as the one provided by Microsoft or unixODBC.
There is an ANSI version, mdbodbca.dll, and an Unicode
version, mdbodbcw.dll, of the driver.
Many options can be provided to the driver to adjust its
behavior.
Setup Library (mdbodbcS.dll)
The setup library provides a graphical user interface needed
during certain activities provided by the driver. For example;
it provides the GUI when you use the ODBC Administrator to
create/edit a Data Source Name (DSN).
Installer (mdbodbc-installer.exe)
This command-line utility program can be used to manage ODBC
system information. For example it can be used to register
or deregister a driver. It can also manage data source names.
This was created to test the ODBC system information
abstraction and portability layer within MongoDB ODBC but
is also useful for installing and uninstalling MongoDB ODBC.
Invoke mdbodbc-installer.exe, in a command shell and without
options, to get help on its use.
Library Loading Tester (dltest.exe)
This command-line utility is useful for debugging problems
related to loading a library and resolving symbols in it.
MongoDB ODBC provides an SDK for developers in the form of several reusable libraries. These libraries can be used to save development time/effort and to increase stability of resulting software.
myodbc-util
This library provides the ODBC system information abstraction
and portability used by MongoDB ODBC.
For more information about MongoDB, see http://www.mongodb.com For more information about MySQL, see http://www.mysql.com.