write_release: write_release

View source: R/write_release.R

write_releaseR Documentation

write_release

Description

Release data set with identifier - ECONDATA:id(version).

Usage

write_release(id, version, providerid, description, method = "release", ...)

Arguments

id

Data identifier.

version

Version of the data definition.

providerid

Data provider identifier.

description

Description of the new data set release/vintage.

method

One of release, reset, or rollback. release releases staged data, reset wipes staged data, and rollback wipes the previous release.

...

Further Optional arguments:

agencyid character. Defaults to "ECONDATA". Agency responsible for the metadata creation/maintenance.
release Date/time. For historical releases with format %Y-%m-%dT%H:%M:%S.

Details

An EconData account (http://econdata.co.za) is required to use this function. The user must provide an API token that can be found on the Account page of the online portal, a GUI dialog will prompt the user for their API token. Credentials can also be supplied by setting the ECONDATA_CREDENTIALS environment variable using the syntax: "client_id;client_secret", e.g. Sys.setenv(ECONDATA_CREDENTIALS="client_id;client_secret"), when available.

The functionality provided by write_release is to release, reset, or rollback a release/vintage of the data set according to the function arguments. As this makes modifications to the database the user calling this function requires higher privileges than needed for other econdatar functions - the user requires membership with the relevant data provider.

Value

No return value, called for side-effects - writes data to server.

See Also

read_release write_econdata

Examples

## Not run: 
write_release(id = "BA900",
              version = "1.0.0",
              description = paste0("Vintage - ", Sys.Date()))

## End(Not run)

coderaanalytics/econdatar documentation built on Nov. 1, 2024, 5:41 a.m.