9 个重大版本发布
0.47.0 | 2024 年 7 月 23 日 |
---|---|
0.45.0 | 2024 年 5 月 13 日 |
0.42.0 | 2024 年 3 月 18 日 |
#6 在 #opendal
每月 125 次下载
27KB
471 行
Shuttle OpenDAL
此插件允许服务连接到 Apache OpenDAL™。OpenDAL 是一个数据访问层,允许用户以统一的方式轻松高效地从各种存储服务中检索数据。
用户可以将 OpenDAL 连接到各种存储服务以访问数据,包括:s3、azblob、gcs、oss 等。
用法
重要:目前 Shuttle 还无法为您配置存储(暂时还不行)。这意味着您需要先创建存储服务并相应地设置密钥。
通过运行 cargo add shuttle-opendal
将 shuttle-opendal
添加到您服务的依赖项中。您可以通过将 shuttle_opendal::Opendal
属性添加到您的 Shuttle main
装饰函数中来提供此资源。
它返回一个 opendal::Operator
,供您连接存储服务。
示例
对于 Axum 服务器,您的 main 函数将如下所示
use opendal::Operator;
use shuttle_axum::ShuttleAxum;
#[shuttle_runtime::main]
async fn app(
#[shuttle_opendal::Opendal(scheme = "s3")]
storage: Operator,
) -> ShuttleAxum {}
参数
参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
scheme | str |
"memory" |
要连接的存储服务的方案。 |
所有密钥都是从您的 Secrets.toml
文件中加载的。
例如,当使用 s3
时,您可以将方案配置为 s3
并指定密钥:bucket
、access_key_id
和 secret_access_key
。
有关如何为要连接的存储服务设置密钥的更多信息,请参阅 OpenDAL 文档。
依赖项
~13–26MB
~412K SLoC