Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/r-dbi/RMySQL
Legacy DBI interface for MySQL
https://github.com/r-dbi/RMySQL
database mysql r
Last synced: about 2 months ago
JSON representation
Legacy DBI interface for MySQL
- Host: GitHub
- URL: https://github.com/r-dbi/RMySQL
- Owner: r-dbi
- Created: 2012-01-12T17:27:03.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2023-12-04T13:04:49.000Z (10 months ago)
- Last Synced: 2024-07-24T10:39:58.342Z (about 2 months ago)
- Topics: database, mysql, r
- Language: C
- Homepage: http://cran.r-project.org/package=RMySQL
- Size: 9.14 MB
- Stars: 208
- Watchers: 35
- Forks: 111
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- jimsghstars - r-dbi/RMySQL - Legacy DBI interface for MySQL (C)
README
RMySQL
======
NOTE: this package is being phased out in favor of the new [RMariaDB](https://github.com/r-dbi/RMariaDB) package.
> Database Interface and MySQL Driver for R
[](https://ci.appveyor.com/project/jeroen/RMySQL)
[](https://cran.r-project.org/package=RMySQL)
[](https://cran.r-project.org/package=RMySQL)
RMySQL is a database interface and MySQL driver for R. This version complies with the database interface definition as implemented in the package DBI 0.2-2.
## Hello World
```R
library(DBI)
# Connect to my-db as defined in ~/.my.cnf
con <- dbConnect(RMySQL::MySQL(), group = "my-db")
dbListTables(con)
dbWriteTable(con, "mtcars", mtcars)
dbListTables(con)
dbListFields(con, "mtcars")
dbReadTable(con, "mtcars")
# You can fetch all results:
res <- dbSendQuery(con, "SELECT * FROM mtcars WHERE cyl = 4")
dbFetch(res)
dbClearResult(res)
# Or a chunk at a time
res <- dbSendQuery(con, "SELECT * FROM mtcars WHERE cyl = 4")
while(!dbHasCompleted(res)){
chunk <- dbFetch(res, n = 5)
print(nrow(chunk))
}
# Clear the result
dbClearResult(res)
# Disconnect from the database
dbDisconnect(con)
```
## Installation
Binary packages for __OS-X__ or __Windows__ can be installed directly from CRAN:
```r
install.packages("RMySQL")
```
The development version from github:
```R
# install.packages("devtools")
devtools::install_github("r-dbi/DBI")
devtools::install_github("r-dbi/RMySQL")
```
Installation from source on Linux or OSX requires [`MariaDB Connector/C`](https://downloads.mariadb.org/connector-c/). On some older platforms you can also link against Oracle's [libmysqlclient](https://packages.debian.org/testing/libmysqlclient-dev) driver but the mariadb implementation is much better.
On recent __Debian or Ubuntu__ install [libmariadbclient-dev](https://packages.debian.org/testing/libmariadbclient-dev)
```
sudo apt-get install -y libmariadbclient-dev
```
On __Fedora__, __CentOS or RHEL__ we need [mariadb-devel](https://src.fedoraproject.org/rpms/mariadb):
```
sudo yum install mariadb-devel
````
On __OS-X__ use [mariadb-connector-c](https://github.com/Homebrew/homebrew-core/blob/master/Formula/mariadb-connector-c.rb) from Homebrew:
```
brew install mariadb-connector-c
```
## MySQL configuration file
Instead of specifying a username and password in calls to `dbConnect()`, it's better to set up a MySQL configuration file that names the databases that you connect to most commonly. This file should live in `~/.my.cnf` and look like:
```
[database_name]
option1=value1
option2=value2
```
If you want to run the examples, you'll need to set the proper options in the `[rs-dbi]` group of any MySQL option file, such as /etc/my.cnf or the .my.cnf file in your home directory. For a default single user install of MySQL, the following code should work:
```
[rs-dbi]
database=test
user=root
password=
```
## Acknowledgements
Many thanks to Christoph M. Friedrich, John Heuer, Kurt Hornik, Torsten Hothorn, Saikat Debroy, Matthew Kelly, Brian D. Ripley, Mikhail Kondrin, Jake Luciani, Jens Nieschulze, Deepayan Sarkar, Louis Springer, Duncan Temple Lang, Luis Torgo, Arend P. van der Veen, Felix Weninger, J. T. Lindgren, Crespin Miller, and Michal Okonlewski, Seth Falcon and Paul Gilbert for comments, suggestions, bug reports, and patches.