RMySQL (version 0.10.2)

dbReadTable,MySQLConnection,character-method: Convenience functions for importing/exporting DBMS tables

Description

These functions mimic their R/S-Plus counterpart get, assign, exists, remove, and objects, except that they generate code that gets remotely executed in a database engine.

Usage

## S3 method for class 'MySQLConnection,character':
dbReadTable(conn, name, row.names,
  check.names = TRUE, ...)
## S3 method for class 'MySQLConnection':
dbListTables(conn, ...)
## S3 method for class 'MySQLConnection,character':
dbExistsTable(conn, name, ...)
## S3 method for class 'MySQLConnection,character':
dbRemoveTable(conn, name, ...)
## S3 method for class 'MySQLConnection,character':
dbListFields(conn, name, ...)

Arguments

conn

a MySQLConnection object, produced by dbConnect

name

a character string specifying a table name.

row.names

A string or an index specifying the column in the DBMS table to use as row.names in the output data.frame. Defaults to using the row_names column if present. Set to NULL to never use row names.

check.names

If TRUE, the default, column names will be converted to valid R identifiers.

...

Unused, needed for compatiblity with generic.

Value

• A data.frame in the case of dbReadTable; otherwise a logical indicating whether the operation was successful.

Examples

if (mysqlHasDefault()) {
con <- dbConnect(RMySQL::MySQL(), dbname = "test")

# By default, row names are written in a column to row_names, and
# automatically read back into the row.names()
dbWriteTable(con, "mtcars", mtcars[1:5, ], overwrite = TRUE)
dbReadTable(con, "mtcars")
dbReadTable(con, "mtcars", row.names = NULL)
}