概述

什么是 Key？

Key 是 Ozone 中的基本数据对象，类似于传统文件系统中的文件。Key 存储在 Bucket 中，代表用户实际交互的数据。

Key 的特征：

• 包含在 Bucket 中： 每个 Key 必须位于某个 Bucket 之内。
• 数据块不可变： Key 一旦写入，其底层数据块即不可更改。对 Key 的更新或修改通常会产生新的版本或新的数据块，元数据则指向最新的版本。

详细信息

创建、读取与管理

可以使用 Ozone CLI 或各种客户端 API（Java、S3 等）来创建、读取和管理 Key。

ozone sh key put /myvolume/mybucket/mykey.txt /path/to/local/file.txt

如需了解键操作的更多细节，请参阅 Ozone CLI 文档。

键的写入与读取过程

当客户端写入一个键时，Ozone Manager 负责处理元数据（键名、数据块的位置），而 Datanode 负责存储实际的数据块。读取时，Ozone Manager 将数据块的位置提供给客户端，客户端再据此直接从 Datanode 获取数据。

如需深入了解键的写入与读取过程，请参阅 Ozone Manager 文档。

原子键替换

Ozone 支持原子键替换，确保只有在键自上次读取以来未发生变更的情况下才会被覆盖，从而防止并发写入场景下的更新丢失。

详情请参阅《仅在未变更时覆盖键》设计文档。

回收站

从文件系统优化（FSO）类型的桶中删除键时，键会被移动到回收站目录中，以便恢复。对于对象存储（OBS）类型的桶，键将被永久删除。

有关回收站功能的更多信息，请参阅回收站文档。

加密

如果父桶已启用加密，写入该桶的所有键都将被透明加密。

详情请参阅透明数据加密文档。

访问控制列表（ACL）

ACL 也可以应用到单个键上，从而对读写权限进行细粒度控制。

详情请参阅原生 ACL 文档。