echonesis commented on code in PR #218: URL: https://github.com/apache/ozone-site/pull/218#discussion_r2660420044
########## docs/03-core-concepts/03-namespace/03-keys/01-overview.md: ########## @@ -0,0 +1,60 @@ +--- +sidebar_label: Overview +--- + +# Keys + +## What is a Key? + +A **Key** is the fundamental data object in Ozone, analogous to a file in a traditional file system. Keys are stored within buckets and represent the actual data that users interact with. + +**Key Characteristics:** + +- **Contained within Buckets:** Every key must reside within a bucket. +- **Immutable Data Blocks:** Once written, the underlying data blocks of a key are immutable. Updates or modifications to a key typically result in new versions or new data blocks being written, with the metadata pointing to the latest version. + +## Details + +### Creation, Reading, and Management + +Keys are created, read, and managed using the Ozone CLI or various client APIs (Java, S3, etc.). + +```bash +ozone sh key put /myvolume/mybucket/mykey.txt /path/to/local/file.txt +``` + +For more details on key operations, refer to the [Ozone CLI documentation](/docs/user-guide/client-interfaces/o3#key-operations). + +### Key Write and Read Process + +When a client writes a key, the Ozone Manager handles the metadata (key name, location of data blocks), and the Datanodes store the actual data blocks. For reads, the Ozone Manager provides the client with the locations of the data blocks, which the client then retrieves directly from the Datanodes. + +<!-- TODO: Link to Ozone Manager documentation --> +For a deeper dive into the key write and read process, refer to the Ozone Manager documentation. + +### Atomic Key Replacement + +Ozone supports atomic key replacement, ensuring that a key is only overwritten if it hasn't changed since it was last read. This prevents lost updates in concurrent write scenarios. + +<!-- TODO: Link to overwrite-key-only-if-unchanged design document when created --> +For more details, refer to the Overwriting Key Only If Unchanged design document. + +### Trash + +When keys are deleted from File System Optimized (FSO) buckets, they are moved to a trash directory, allowing for recovery. For Object Store (OBS) buckets, keys are permanently deleted. + +<!-- TODO: Link to Trash documentation when created --> +For more information on the trash feature, refer to the Trash documentation. + +### Encryption + +If the parent bucket is encrypted, all keys written to that bucket will be transparently encrypted. + +<!-- TODO: Link to Securing TDE documentation when created --> +For more details, refer to the Securing TDE documentation. Review Comment: Please refer to https://ozone-site-v2.staged.apache.org/docs/administrator-guide/configuration/security/encryption/transparent-data-encryption ########## docs/03-core-concepts/03-namespace/03-keys/01-overview.md: ########## @@ -0,0 +1,60 @@ +--- +sidebar_label: Overview +--- + +# Keys + +## What is a Key? + +A **Key** is the fundamental data object in Ozone, analogous to a file in a traditional file system. Keys are stored within buckets and represent the actual data that users interact with. + +**Key Characteristics:** + +- **Contained within Buckets:** Every key must reside within a bucket. +- **Immutable Data Blocks:** Once written, the underlying data blocks of a key are immutable. Updates or modifications to a key typically result in new versions or new data blocks being written, with the metadata pointing to the latest version. + +## Details + +### Creation, Reading, and Management + +Keys are created, read, and managed using the Ozone CLI or various client APIs (Java, S3, etc.). + +```bash +ozone sh key put /myvolume/mybucket/mykey.txt /path/to/local/file.txt +``` + +For more details on key operations, refer to the [Ozone CLI documentation](/docs/user-guide/client-interfaces/o3#key-operations). + +### Key Write and Read Process + +When a client writes a key, the Ozone Manager handles the metadata (key name, location of data blocks), and the Datanodes store the actual data blocks. For reads, the Ozone Manager provides the client with the locations of the data blocks, which the client then retrieves directly from the Datanodes. + +<!-- TODO: Link to Ozone Manager documentation --> +For a deeper dive into the key write and read process, refer to the Ozone Manager documentation. + +### Atomic Key Replacement + +Ozone supports atomic key replacement, ensuring that a key is only overwritten if it hasn't changed since it was last read. This prevents lost updates in concurrent write scenarios. + +<!-- TODO: Link to overwrite-key-only-if-unchanged design document when created --> +For more details, refer to the Overwriting Key Only If Unchanged design document. + +### Trash + +When keys are deleted from File System Optimized (FSO) buckets, they are moved to a trash directory, allowing for recovery. For Object Store (OBS) buckets, keys are permanently deleted. + +<!-- TODO: Link to Trash documentation when created --> +For more information on the trash feature, refer to the Trash documentation. Review Comment: Please refer to https://ozone-site-v2.staged.apache.org/docs/administrator-guide/operations/trash -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
