Package dbx. July 5, 2018

Transcription

1 Type Package Title A Fast, Easy-to-Use Database Interface Version Date Package dbx July 5, 2018 Provides select, insert, update, upsert, and delete database operations. Supports 'PostgreSQL', 'MySQL', 'SQLite', and more, and plays nicely with the 'DBI' package. URL BugReports License MIT + file LICENSE LazyData TRUE RoxygenNote Imports DBI (>= 1.0.0) Suggests testthat (>= 1.0.2), urltools (>= 1.7.0), RSQLite (>= 1.1-2), RMariaDB, RMySQL, RPostgres, RPostgreSQL, dplyr (>= 0.5.0) NeedsCompilation no Author Andrew Kane [aut, cre] Maintainer Andrew Kane <andrew@chartkick.com> Repository CRAN Date/Publication :30:03 UTC R topics documented: dbxconnect dbxdelete dbxdisect dbxinsert dbxselect dbxupdate dbxupsert Index 7 1

2 2 dbxdelete dbxconnect Create a database ection Create a database ection dbxconnect(url = NULL, adapter = NULL,...) url adapter A database URL The database adapter to use... to pass to dbconnect # SQLite ## Not run: # Postgres db <- dbxconnect(adapter="postgres", dbname="mydb") # MySQL db <- dbxconnect(adapter="mysql", dbname="mydb") # Others db <- dbxconnect(adapter=odbc(), database="mydb") ## End(Not run) dbxdelete Delete records Delete records dbxdelete(,, where = NULL, = NULL)

3 dbxdisect 3 where The name to delete records from A data frame of records to delete The number of records to delete in a single statement (defaults to all) <- "forecasts" DBI::dbCreateTable(db,, data.frame(id=1:3, temperature=20:22)) # Delete specific records bad_records <- data.frame(id=c(1, 2)) dbxdelete(db,, where=bad_records) # Delete all records dbxdelete(db, ) dbxdisect Close a database ection Close a database ection dbxdisect() dbxdisect(db)

4 4 dbxselect dbxinsert Insert records Insert records dbxinsert(,, records, = NULL) records The name to insert A data frame of records to insert The number of records to insert in a single statement (defaults to all) <- "forecasts" DBI::dbCreateTable(db,, data.frame(id=1:3, temperature=20:22)) records <- data.frame(temperature=c(32, 25)) inserts <- dbxinsert(db,, records) dbxselect Select records Select records dbxselect(, statement) statement The SQL statement to use

5 dbxupdate 5 DBI::dbCreateTable(db, "forecasts", data.frame(id=1:3, temperature=20:22)) records <- dbxselect(db, "SELECT * FROM forecasts") dbxupdate Update records Update records dbxupdate(,, records, where_cols, = NULL) records where_cols The name to update A data frame of records to insert The columns to use for WHERE clause The number of records to update in a single transaction (defaults to all) <- "forecasts" DBI::dbCreateTable(db,, data.frame(id=1:3, temperature=20:22)) records <- data.frame(id=c(1, 2), temperature=c(16, 13)) dbxupdate(db,, records, where_cols=c("id")) dbxupsert Upsert records Upsert records dbxupsert(,, records, where_cols, = NULL)

6 6 dbxupsert records where_cols The name to upsert A data frame of records to upsert The columns to use for WHERE clause The number of records to upsert in a single statement (defaults to all) ## Not run: db <- dbxconnect(adapter="postgres", dbname="dbx") <- "forecasts" DBI::dbCreateTable(db,, data.frame(id=1:3, temperature=20:22)) records <- data.frame(id=c(3, 4), temperature=c(20, 25)) upserts <- dbxupsert(db,, records, where_cols=c("id")) ## End(Not run)

7 Index dbxconnect, 2 dbxdelete, 2 dbxdisect, 3 dbxinsert, 4 dbxselect, 4 dbxupdate, 5 dbxupsert, 5 7