Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mysql/mysql-connector-nodejs
MySQL Connector Node.JS is a MySQL Connector using the X Protocol, which was introduced with MySQL 5.7.12.
https://github.com/mysql/mysql-connector-nodejs
Last synced: 1 day ago
JSON representation
MySQL Connector Node.JS is a MySQL Connector using the X Protocol, which was introduced with MySQL 5.7.12.
- Host: GitHub
- URL: https://github.com/mysql/mysql-connector-nodejs
- Owner: mysql
- License: other
- Created: 2016-04-12T12:33:51.000Z (almost 9 years ago)
- Default Branch: trunk
- Last Pushed: 2024-10-22T07:41:17.000Z (3 months ago)
- Last Synced: 2025-01-03T05:12:34.548Z (9 days ago)
- Language: JavaScript
- Size: 4.7 MB
- Stars: 156
- Watchers: 17
- Forks: 36
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.txt
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-mysql - MySQL Connector/Node.js - Official Node.js driver for MySQL. (Connectors)
README
# MySQL Connector/Node.js
[![Languages](https://img.shields.io/github/languages/top/mysql/mysql-connector-nodejs.svg?style=flat)](https://github.com/mysql/mysql-connector-nodejs) [![License: GPLv2 with FOSS exception](https://img.shields.io/badge/license-GPLv2_with_FOSS_exception-c30014.svg?style=flat)](https://github.com/mysql/mysql-connector-nodejs/blob/trunk/LICENSE) [![npm](https://img.shields.io/npm/v/@mysql/xdevapi.svg?style=flat)](https://www.npmjs.com/package/@mysql/xdevapi)
MySQL Connector/Node.js is a MySQL 8 driver for Node.js, officially supported and maintained by Oracle. It contains an implementation of the [X DevAPI](https://dev.mysql.com/doc/x-devapi-userguide/en/), an Application Programming Interface for working with the [MySQL Document Store](https://dev.mysql.com/doc/refman/8.0/en/document-store.html) through CRUD-based, NoSQL operations.
For detailed information, please visit the official [MySQL Connector/Node.js documentation](https://dev.mysql.com/doc/dev/connector-nodejs/).
## License
Please refer to the [README.txt](https://github.com/mysql/mysql-connector-nodejs/blob/trunk/README.txt) and [LICENSE](https://github.com/mysql/mysql-connector-nodejs/blob/trunk/LICENSE) files, available in this repository, for further details.
## Getting the Latest Release
MySQL Connector/Node.js is free to use under the terms of the specified license and it runs on any Operating System that supports a Node.js 14.0.0 (or higher) runtime. Packages can and should be installed using the npm CLI.
Since releases do **NOT** follow [Semantic Versioning](https://semver.org/) rules, it is advised to install a specific version of the package (the latest preferably) or by using an additional standard lockfile such as [`npm-shrinkwrap.json`](https://docs.npmjs.com/files/shrinkwrap.json.html) or [`package-lock.json`](https://docs.npmjs.com/files/package-lock.json) depending on the version of the npm CLI.
### Installing from the npm registry
The recommended way for installing MySQL Connector/Node.js is by downloading and installing the package from the official [npm registry](https://www.npmjs.com/). That can be done by running following command in the project root directory:
```sh
$ npm install @mysql/xdevapi --save --save-exact
```### Downloading and Installing manually
Alternatively, MySQL Connector/Node.js tarballs are also available in the [official download page](https://dev.mysql.com/downloads/connector/nodejs/). The package can be installed by running the following command in the project root directory:
```sh
$ npm install /path/to/mysql-connector-nodejs-.tar.gz --save --save-exact
```### GitHub Repository
The GitHub repository contains the MySQL Connector/Node.js source code as per the latest release. No changes are published in the repository between releases.
## Contributing
There are a few ways to contribute to the Connector/Node.js code. Please refer to the [contributing guidelines](https://github.com/mysql/mysql-connector-nodejs/blob/trunk/CONTRIBUTING.md) for additional information.
## Additional Resources
* [MySQL Connector/Node.js Documentation](https://dev.mysql.com/doc/dev/connector-nodejs/)
* [MySQL X DevAPI User Guide](https://dev.mysql.com/doc/x-devapi-userguide/en/)
* [MySQL Document Store](https://dev.mysql.com/doc/refman/en/document-store.html)
* [MySQL Connector/Node.js forum](http://forums.mysql.com/list.php?44)
* [`#connectors` channel in MySQL Community Slack](https://mysqlcommunity.slack.com/messages/connectors) ([Sign-up](https://lefred.be/mysql-community-on-slack/) required when not using an Oracle account)
* [Twitter](https://twitter.com/mysql)
* [InsideMySQL.com Connectors Blog](https://insidemysql.com/category/mysql-development/connectors/)
* [MySQL Public Bug Tracker](https://bugs.mysql.com/)For more information about this and other MySQL products, please visit [MySQL Contact & Questions](https://www.mysql.com/about/contact/).
[![Follow MySQL on Twitter](https://img.shields.io/twitter/follow/MySQL.svg?label=Follow%20%40MySQL&style=social)](https://twitter.com/intent/follow?screen_name=MySQL)