Returns if a table given by name exists in the database.

Methods in other packages

  • RSQLite::dbExistsTable("SQLiteConnection", "character")

dbExistsTable(conn, name, ...)

Arguments

conn

A DBIConnection object, as returned by dbConnect().

name

A character string specifying a DBMS table name.

...

Other parameters passed on to methods.

Value

dbExistsTable() returns a logical scalar, TRUE if the table or view specified by the name argument exists, FALSE otherwise. This includes temporary tables if supported by the database.

An error is raised when calling this method for a closed or invalid connection. An error is also raised if name cannot be processed with dbQuoteIdentifier() or if this results in a non-scalar.

Specification

The name argument is processed as follows, to support databases that allow non-syntactic names for their objects:

For all tables listed by dbListTables(), dbExistsTable() returns TRUE.

See also

Examples

con <- dbConnect(RSQLite::SQLite(), ":memory:") dbExistsTable(con, "iris")
#> [1] FALSE
dbWriteTable(con, "iris", iris) dbExistsTable(con, "iris")
#> [1] TRUE