Connect to an AWS S3 bucket

s3_bucket() is a convenience function to create anS3FileSystem objectthat automatically detects the bucket's AWS region and holding onto the itsrelative path.

Usage

s3_bucket(bucket,...)

Arguments

bucket

string S3 bucket name or path

...

Additional connection options, passed toS3FileSystem$create()

Value

ASubTreeFileSystem containing anS3FileSystem and the bucket'srelative path. Note that this function's success does not guarantee that youare authorized to access the bucket's contents.

Details

By default,s3_bucket and otherS3FileSystem functions only produce output for fatal errorsor when printing their return values. When troubleshooting problems, it maybe useful to increase the log level. See the Notes section inS3FileSystem for more information or see Examples below.

Examples

if(FALSE){bucket<-s3_bucket("voltrondata-labs-datasets")}if(FALSE){# Turn on debug logging. The following line of code should be run in a fresh# R session prior to any calls to `s3_bucket()` (or other S3 functions)Sys.setenv("ARROW_S3_LOG_LEVEL"="DEBUG")bucket<-s3_bucket("voltrondata-labs-datasets")}