Initializes the connector for SQL warehouse type of storage. See ConnectorDatabricksSQL for details.
Initialize the connection to Databricks
Usage
connector_databricks_sql(
warehouse_id = Sys.getenv("DATABRICKS_WAREHOUSE_ID"),
catalog,
schema,
staging_volume = NULL,
...,
extra_class = NULL
)Arguments
- warehouse_id
character The ID of the Databricks SQL warehouse you want to connect to. Defaults to
DATABRICKS_WAREHOUSE_IDenvironment variable.- catalog
character The catalog to use
- schema
character The schema to use
- staging_volume
character Optional volume path for large dataset staging. Recommended way for better performances.
- ...
Additional parameters sent to
brickster::DatabricksSQL()driver.- extra_class
character Extra class to assign to the new connector
Value
A ConnectorDatabricksSQL object
Details
The extra_class parameter allows you to create a subclass of the
ConnectorDatabricksSQL object. This can be useful if you want to create
a custom connection object for easier dispatch of new s3 methods, while still
inheriting the methods from the ConnectorDatabricksSQL object.
Examples
if (FALSE) { # \dontrun{
# Establish connection to your SQL warehouse
con_databricks <- connector_databricks_sql(
warehouse_id = "your-warehouse-id",
catalog = "my_catalog",
schema = "my_schema"
)
# List tables in my_schema
con_databricks$list_content()
# Read and write tables
con_databricks$write(mtcars, "my_mtcars_table")
con_databricks$read("my_mtcars_table")
# Use dplyr::tbl
con_databricks$tbl("my_mtcars_table")
# Remove table
con_databricks$remove("my_mtcars_table")
# Disconnect
con_databricks$disconnect()
} # }
