连接到 AWS S3 存储桶 — s3_bucket • Arrow R 包

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