drs_stat {AnVIL}R Documentation

DRS (Data Repository Service) URL management

Description

drs_stat() resolves zero or more DRS URLs to their google bucket location.

drs_cp() copies 0 or more DRS URIs to a google bucket or local folder

Usage

drs_stat(source = character())

drs_cp(source, destination, ...)

Arguments

source

character() DRS URLs (beginning with 'drs://') to resources managed by the 'martha' DRS resolution server.

destination

character(1) directory path in which to retrieve files.

...

additional arguments, passed to gsutil_cp() for file copying.

Details

drs_stat() sends requests in parallel to the DRS server, using 8 forked processes (by default) to speed up queries. Use options(mc.cores = 16L), for instance, to set the number of processes to use.

`drs_stat()` uses the AnVIL 'pet' account associated with a
runtime. The pet account is discovered by default when
evaluated on an AnVIL runtime (e.g., in RStudio or a Jupyter
notebook in the AnVIL), or can be found in the return value of
`avruntimes()`.

Value

drs_stat() returns a tbl with the following columns:

drs_cp() returns a tibble like drs_stat(), but with additional columns

Examples

drs_eg_anvil <- c(
    "drs://dg.ANV0/975bd45f-f022-4fad-b9a2-3a00c3b8792c",
    "drs://dg.ANV0/00008531-03d7-418c-b3d3-b7b22b5381a0"
)

if (gcloud_exists() && startsWith(gcloud_account(), "pet-")) {
    ## from within AnVIL
    drs_stat(drs_eg_anvil)
}



[Package AnVIL version 1.6.2 Index]