R: Does a table exist?

dbExistsTable {DBI} | R Documentation

## Does a table exist?

### Description

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

#### Methods in other packages

- `DBI::dbExistsTable("DBIConnection", "Id")`

### Usage

    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.

### Additional arguments

TBD: `temporary = NA`

This must be provided as named argument. See the "Specification" section for details on their usage.

### Specification

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

- If an unquoted table name as string: `dbExistsTable()` will do the quoting, perhaps by calling `dbQuoteIdentifier(conn, x = name)`

- If the result of a call to `dbQuoteIdentifier()`: no more quoting is done

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

### See Also

Other DBIConnection generics: `DBIConnection-class`, `dbDataType`, `dbDisconnect`, `dbExecute`, `dbGetException`, `dbGetInfo`, `dbGetQuery`, `dbIsValid`, `dbListFields`, `dbListObjects`, `dbListResults`, `dbListTables`, `dbReadTable`, `dbRemoveTable`, `dbSendQuery`, `dbSendStatement`, `dbWriteTable`

### Examples

    con <- dbConnect(RSQLite::SQLite(), ":memory:")

    dbExistsTable(con, "iris")
    dbWriteTable(con, "iris", iris)
    dbExistsTable(con, "iris")

    dbDisconnect(con)

[Package DBI version 0.8 Index]