add_resource: Add a Data Resource

In frictionlessdata/frictionless-r: Read and Write Frictionless Data Packages

Add a Data Resource

Description

Adds a Data Resource to a Data Package. The resource will be a Tabular Data Resource. The resource name can only contain lowercase alphanumeric characters plus ., - and ⁠_⁠.

Usage

add_resource(
  package,
  resource_name,
  data,
  schema = NULL,
  replace = FALSE,
  delim = ",",
  ...
)

Arguments

package	Data Package object, as returned by read_package() or create_package().
resource_name	Name of the Data Resource.
data	Data to attach, either a data frame or path(s) to CSV file(s): Data frame: attached to the resource as data and written to a CSV file when using write_package(). One or more paths to CSV file(s) as a character (vector): added to the resource as path. The last file will be read with readr::read_delim() to create or compare with schema and to set format, mediatype and encoding. The other files are ignored, but are expected to have the same structure and properties.
schema	Either a list, or path or URL to a JSON file describing a Table Schema for the data. If not provided, one will be created using create_schema().
replace	If TRUE, the added resource will replace an existing resource with the same name.
delim	Single character used to separate the fields in the CSV file(s), e.g. ⁠\t⁠ for tab delimited file. Will be set as delimiter in the resource Table Dialect, so read functions . know how to read the file(s).
...	Additional metadata properties to add to the resource, e.g. ⁠title = "My title", validated = FALSE⁠. These are not verified against specifications and are ignored by read_resource(). The following properties are automatically set and can't be provided with ...: name, data, path, schema, profile, format, mediatype, encoding and dialect.

Details

See vignette("data-resource") (and to a lesser extend vignette("table-dialect")) to learn how this function implements the Data Package standard.

Value

package with one additional resource.

See Also

Other edit functions: remove_resource()

Examples

# Load the example Data Package
package <- example_package()

# List the resources
resources(package)

# Create a data frame
df <- data.frame(
  multimedia_id = c(
    "aed5fa71-3ed4-4284-a6ba-3550d1a4de8d",
    "da81a501-8236-4cbd-aa95-4bc4b10a05df"
  ),
  x = c(718, 748),
  y = c(860, 900)
)

# Add the resource "positions" from the data frame
package <- add_resource(package, "positions", data = df)

# Add the resource "positions_with_schema", with a user-defined schema and title
my_schema <- create_schema(df)
package <- add_resource(
  package,
  resource_name = "positions_with_schema",
  data = df,
  schema = my_schema,
  title = "Positions with schema"
)

# Replace the resource "observations" with a file-based resource (2 TSV files)
path_1 <-
system.file("extdata", "v1", "observations_1.tsv", package = "frictionless")
path_2 <-
system.file("extdata", "v1", "observations_2.tsv", package = "frictionless")
package <- add_resource(
  package,
  resource_name = "observations",
  data = c(path_1, path_2),
  replace = TRUE,
  delim = "\t"
)

# List the resources ("positions" and "positions_with_schema" added)
resources(package)

frictionlessdata/frictionless-r documentation built on April 17, 2025, 11:45 a.m.