连接到 AWS S3 存储桶

s3_bucket() 是一个便捷函数，用于创建一个 S3FileSystem 对象，该对象会自动检测存储桶的 AWS 区域并保留其相对路径。

用法

s3_bucket(bucket, ...)

参数

bucket

字符串 S3 存储桶名称或路径

...

附加连接选项，传递给 S3FileSystem$create()

返回值

一个 SubTreeFileSystem，包含一个 S3FileSystem 和存储桶的相对路径。请注意，此函数的成功不保证您有权访问存储桶的内容。

详情

默认情况下，s3_bucket 和其他 S3FileSystem 函数仅在出现致命错误或打印其返回值时才生成输出。在解决问题时，提高日志级别可能会很有用。有关更多信息，请参阅 S3FileSystem 中的“备注”部分或参阅下面的“示例”。

示例

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")
}