# Dataset ## *class* Dataset Dataset on Redivis are the entity where data is stored. Datasets are made up of tables, non-tabular files, and various metadata. Datasets can be owned by a user or organization, and are version controlled. ## Constructors

Method	Description
`Organization$dataset`(dataset_reference)	Construct a new dataset instance that references a dataset owned by an organization.
`Organization$list_datasets`([max_results])	Returns a list of Datasets owned by an organization.
`User$dataset`(dataset_reference)	Construct a new dataset instance that references a dataset owned by a user.
`User$list_datasets`([max_results])	Returns a list of Datasets owned by a user.

## Examples {% tabs %} {% tab title="Basics" %} ```r dataset <- redivis$organization("Demo")$dataset("US Fires") # Will raise an error if the dataset doesn't exists # Can first call dataset$exists() to check for existence dataset$get() print(dataset$properties) # A named list of dataset properties ``` {% endtab %} {% tab title="Create" %} ```r dataset <- redivis$user("my_username")$dataset("My dataset") dataset$create(public_access_level="overview") print(dataset$properties) ``` {% endtab %} {% tab title="New version" %} ```r dataset <- redivis$user("my_username")$dataset("My dataset") dataset <- dataset$create_next_version() # Coming soon: uploading data via R, see Python library dataset.release() ``` {% endtab %} {% tab title="Query" %} ```r dataset <- redivis$organization("Demo")$dataset("CMS 2014 Medicare Data") # The home_health_agencies table is assumed to be within the dataset, # since it isn't otherwise qualified query = dataset$query(""" SELECT * FROM home_health_agencies WHERE state = 'CA' """) print(query$to_tibble()) ``` {% endtab %} {% endtabs %} ## Fields | Name | Description | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **`organization`** | A reference to the [Organization](/api/client-libraries/redivis-r/reference/organization.md) instance that constructed this dataset. Will be `None` if the dataset belongs to a user. | | **`properties`** |

A named list containing the API resource representation of the dataset. This will be fully populated after calling get(), create\_next\_version(), and release(), otherwise will be None.

This will also be partially populated for datasets returned via the Organization$list\_datasets and User$list\_datasets methods

| | **`qualified_reference`** | The [fully qualified reference](/api/referencing-resources.md) for the dataset, which can be used in SQL queries or the REST API. E.g., `demo.ghcn_daily_weather_data:v1_1:7br5` | | **`scoped_reference`** | The canonical reference for the dataset, without the username qualifier. E.g.,: `ghcn_daily_weather_data:v1_1:7br5` | | **`user`** | A reference to the [User](/api/client-libraries/redivis-r/reference/user.md) instance that constructed this dataset. Will be `None` if the dataset belongs to an organization. | ## Methods


`Dataset$connect_dbi`()	Create a DBI connection scoped to the dataset.
`Dataset$create`([public_access_level, ...])	Create a new dataset.
`Dataset$create_next_version`([if_not_exists])	Create a "next" (unreleased) version on the dataset. Data can only be uploaded to unreleased versions.
`Dataset$delete`()	Delete the dataset.
`Dataset$exists`()	Check whether the dataset exists.
`Dataset$get`()	Get the dataset, populating the `properties` on the current instance.
`Dataset$list_tables`([max_results])	List all tables in the dataset.
`Dataset$list_versions`([max_results])	List all versions for the dataset.
`Dataset$next_version`()	Return a reference to the dataset at the version subsequent to the currently referenced version.
`Dataset$previous_version`()	Return a reference to the dataset at the version prior to the currently referenced version.
`Dataset$query`(query_string)	Create a query scoped to the dataset.
`Dataset$release`()	Release the `next` version of the dataset.
`Dataset$table`(table_reference)	Create a reference to a specific table within the dataset.
`Dataset$unrelease`()	Unrelease the `current` version of the dataset.
`Dataset$update`([name, public_access_level, ...])	Update certain attributes on the dataset.
`Dataset$update_variables`(variables)	Bulk update variable metadata across tables in a workflow.
`Dataset$version`([tag])	Create a reference to a version instance at a particular tag.

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.redivis.com/api/client-libraries/redivis-r/reference/dataset.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.