连接到 AWS S3 存储桶

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

用法

s3_bucket(bucket, ...)

参数

bucket

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

...

其他连接选项，传递给 S3FileSystem$create()

返回值

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

详情

默认情况下，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")
}