HBASE-26265 Update ref guide to mention the new store file tracker im… #3942
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
🎊 +1 overall
This message was automatically generated. |
|
🎊 +1 overall
This message was automatically generated. |
|
🎊 +1 overall
This message was automatically generated. |
Apache9
reviewed
Dec 14, 2021
joshelser
requested changes
Dec 14, 2021
| those files to the actual store directory at operation commit time. That's a simple and convenient | ||
| way to separate transient from already finalised files that are ready to serve client reads with data. | ||
| This approach works well with strong consistent file systems, but with the popularity of less consistent | ||
| file systems, mainly Object Store file systems, dependency on rename operations starts to introduce |
There was a problem hiding this comment.
Suggested change
| file systems, mainly Object Store file systems, dependency on rename operations starts to introduce | |
| file systems, mainly Object Store which can be used like file systems, HBase's dependency on atomic rename operations starts to introduce |
| way to separate transient from already finalised files that are ready to serve client reads with data. | ||
| This approach works well with strong consistent file systems, but with the popularity of less consistent | ||
| file systems, mainly Object Store file systems, dependency on rename operations starts to introduce | ||
| performance penalties. Amazon S3 Object Store, in particular, has been the most affected deployment, |
There was a problem hiding this comment.
Suggested change
| performance penalties. Amazon S3 Object Store, in particular, has been the most affected deployment, | |
| performance penalties. The Amazon S3 Object Store, in particular, has been the most affected deployment |
| This approach works well with strong consistent file systems, but with the popularity of less consistent | ||
| file systems, mainly Object Store file systems, dependency on rename operations starts to introduce | ||
| performance penalties. Amazon S3 Object Store, in particular, has been the most affected deployment, | ||
| due to the its lack of atomic renames, requiring an additional locking layer implemented by HBOSS, |
There was a problem hiding this comment.
Suggested change
| due to the its lack of atomic renames, requiring an additional locking layer implemented by HBOSS, | |
| due to the its lack of atomic renames. The HBase community temporarily bypassed this problem by building a distributed locking layer called HBOSS |
| file systems, mainly Object Store file systems, dependency on rename operations starts to introduce | ||
| performance penalties. Amazon S3 Object Store, in particular, has been the most affected deployment, | ||
| due to the its lack of atomic renames, requiring an additional locking layer implemented by HBOSS, | ||
| to guarantee consistency and integrity of operations. |
There was a problem hiding this comment.
Suggested change
| to guarantee consistency and integrity of operations. | |
| to guarantee atomicity of operations against S3. |
Maybe I'm being nit-picky here? I think it makes a confusing topic easier to understand if we just say "atomic renames", even though "consistency" and "integrity" would be things sacrificed when we have non-atomic renames :)
Comment on lines
47
to
48
| It can be set at individual Table or Column Family configurations, as well as in processes | ||
| *hbase-site.xml* configuration file. |
There was a problem hiding this comment.
Suggested change
| It can be set at individual Table or Column Family configurations, as well as in processes | |
| *hbase-site.xml* configuration file. | |
| The implementation can be set at the HBase service leve in *hbase-site.xml* or at the Table or Column Family via the TableDescriptor configuration. |
| It can be set at individual Table or Column Family configurations, as well as in processes | ||
| *hbase-site.xml* configuration file. | ||
|
|
||
| NOTE: When specified in *hbase_site.xml*, this configuration is also saved into tables configuration |
There was a problem hiding this comment.
Suggested change
| NOTE: When specified in *hbase_site.xml*, this configuration is also saved into tables configuration | |
| NOTE: When the store file tracking implementation is specified in *hbase_site.xml*, this configuration is also propagated into a table's configuration |
|
|
||
| As per the name, this is the Store File Tracking implementation used by default when now explicit | ||
| configuration has been defined. The DEFAULT tracker implements the standard approach using temporary | ||
| directories and renames. |
There was a problem hiding this comment.
Suggested change
| directories and renames. | |
| directories and renames. This is how all previous (implicit) implementation that HBase used to track store files. |
|
|
||
| ### Switching implementations globally | ||
|
|
||
| For running clusters with tables already containing data, Store File Tracking implementation can |
There was a problem hiding this comment.
Suggested change
| For running clusters with tables already containing data, Store File Tracking implementation can | |
| For clusters with data that are upgraded to a version of HBase containing the store file tracking feature, the Store File Tracking implementation can |
|
Thanks for the review comments, @joshelser and @Apache9 . I believe I have addressed all the suggestions, please give a second look at your convenience. |
|
🎊 +1 overall
This message was automatically generated. |
|
🎊 +1 overall
This message was automatically generated. |
|
🎊 +1 overall
This message was automatically generated. |
|
🎊 +1 overall
This message was automatically generated. |
|
🎊 +1 overall
This message was automatically generated. |
|
🎊 +1 overall
This message was automatically generated. |
Apache9
pushed a commit
that referenced
this pull request
Dec 17, 2021
asfgit
pushed a commit
that referenced
this pull request
Dec 22, 2021
apurtell
pushed a commit
to apurtell/hbase
that referenced
this pull request
Mar 18, 2022
apurtell
pushed a commit
to apurtell/hbase
that referenced
this pull request
Mar 19, 2022
apurtell
pushed a commit
to apurtell/hbase
that referenced
this pull request
Mar 25, 2022
apurtell
pushed a commit
to apurtell/hbase
that referenced
this pull request
Mar 26, 2022
apurtell
added a commit
to apurtell/hbase
that referenced
this pull request
Mar 26, 2022
…others) to branch-2.5 Previous cherry picks: commit 6aaef89 HBASE-26064 Introduce a StoreFileTracker to abstract the store file tracking logic commit 43b40e9 HBASE-25988 Store the store file list by a file apache#3578) commit 6e05376 HBASE-26079 Use StoreFileTracker when splitting and merging apache#3617) commit 090b2fe HBASE-26224 HBASE-26224 Introduce a MigrationStoreFileTracker to support migratin… apache#3656) commit 0ee1689 HBASE-26246 Persist the StoreFileTracker configurations to TableDescriptor when creating table apache#3666) commit 2052e80 HBASE-26248 Should find a suitable way to let users specify the store… apache#3665) commit 5ff0f98 HBASE-26264 Add more checks to prevent misconfiguration on store file… apache#3681) commit fc4f6d1 HBASE-26280 HBASE-26280 Use store file tracker when snapshoting apache#3685) commit 06db852 HBASE-26326 CreateTableProcedure fails when FileBasedStoreFileTracker… apache#3721) commit e4e7cf8 HBASE-26386 Refactor StoreFileTracker implementations to expose the s… apache#3774) commit 08d1171 HBASE-26328 Clone snapshot doesn't load reference files into FILE SFT impl apache#3749) commit 8bec26e HBASE-26263 [Rolling Upgrading] Persist the StoreFileTracker configur… apache#3700) commit a288365 HBASE-26271: Cleanup the broken store files under data directory apache#3786) commit d00b5fa HBASE-26454 CreateTableProcedure still relies on temp dir and renames… apache#3845) commit 771e552 HBASE-26286: Add support for specifying store file tracker when restoring or cloning snapshot commit f16b7b1 HBASE-26265 Update ref guide to mention the new store file tracker im… apache#3942) commit 755b3b4 HBASE-26585 Add SFT configuration to META table descriptor when creating META apache#3998) commit 39c42c7 HBASE-26639 The implementation of TestMergesSplitsAddToTracker is pro… apache#4010) commit 6e1f5b7 HBASE-26586 Should not rely on the global config when setting SFT implementation for a table while upgrading apache#4006) commit f1dd865 HBASE-26654 ModifyTableDescriptorProcedure shoud load TableDescriptor… apache#4034) commit 8fbc9a2 HBASE-26674 Should modify filesCompacting under storeWriteLock apache#4040) commit 5aa0fd2 HBASE-26675 Data race on Compactor.writer apache#4035) commit 3021c58 HBASE-26700 The way we bypass broken track file is not enough in Stor… apache#4055) commit a8b68c9 HBASE-26690 Modify FSTableDescriptors to not rely on renaming when wr… apache#4054) commit dffeb8e HBASE-26587 Introduce a new Admin API to change SFT implementation (#… apache#4080) commit b265fe5 HBASE-26673 Implement a shell command for change SFT implementation apache#4113) commit 4cdb380 HBASE-26640 Reimplement master local region initialization to better … apache#4111) commit 77bb153 HBASE-26707: Reduce number of renames during bulkload (apache#4066) apache#4122) commit a4b192e HBASE-26611 Changing SFT implementation on disabled table is dangerous apache#4082) commit d3629bb HBASE-26837 Set SFT config when creating TableDescriptor in TestClone… apache#4226) commit 541d748 HBASE-26881 Backport HBASE-25368 to branch-2 (apache#4267) Fixups for precommit error prone, checkstyle, and javadoc warnings after applying cherry picks. Signed-off-by: Josh Elser <elserj@apache.org> Reviewed-by: Wellington Ramos Chevreuil <wchevreuil@apache.org>
apurtell
pushed a commit
that referenced
this pull request
Mar 26, 2022
apurtell
added a commit
that referenced
this pull request
Mar 26, 2022
…others) to branch-2.5 Previous cherry picks: commit 6aaef89 HBASE-26064 Introduce a StoreFileTracker to abstract the store file tracking logic commit 43b40e9 HBASE-25988 Store the store file list by a file #3578) commit 6e05376 HBASE-26079 Use StoreFileTracker when splitting and merging #3617) commit 090b2fe HBASE-26224 HBASE-26224 Introduce a MigrationStoreFileTracker to support migratin… #3656) commit 0ee1689 HBASE-26246 Persist the StoreFileTracker configurations to TableDescriptor when creating table #3666) commit 2052e80 HBASE-26248 Should find a suitable way to let users specify the store… #3665) commit 5ff0f98 HBASE-26264 Add more checks to prevent misconfiguration on store file… #3681) commit fc4f6d1 HBASE-26280 HBASE-26280 Use store file tracker when snapshoting #3685) commit 06db852 HBASE-26326 CreateTableProcedure fails when FileBasedStoreFileTracker… #3721) commit e4e7cf8 HBASE-26386 Refactor StoreFileTracker implementations to expose the s… #3774) commit 08d1171 HBASE-26328 Clone snapshot doesn't load reference files into FILE SFT impl #3749) commit 8bec26e HBASE-26263 [Rolling Upgrading] Persist the StoreFileTracker configur… #3700) commit a288365 HBASE-26271: Cleanup the broken store files under data directory #3786) commit d00b5fa HBASE-26454 CreateTableProcedure still relies on temp dir and renames… #3845) commit 771e552 HBASE-26286: Add support for specifying store file tracker when restoring or cloning snapshot commit f16b7b1 HBASE-26265 Update ref guide to mention the new store file tracker im… #3942) commit 755b3b4 HBASE-26585 Add SFT configuration to META table descriptor when creating META #3998) commit 39c42c7 HBASE-26639 The implementation of TestMergesSplitsAddToTracker is pro… #4010) commit 6e1f5b7 HBASE-26586 Should not rely on the global config when setting SFT implementation for a table while upgrading #4006) commit f1dd865 HBASE-26654 ModifyTableDescriptorProcedure shoud load TableDescriptor… #4034) commit 8fbc9a2 HBASE-26674 Should modify filesCompacting under storeWriteLock #4040) commit 5aa0fd2 HBASE-26675 Data race on Compactor.writer #4035) commit 3021c58 HBASE-26700 The way we bypass broken track file is not enough in Stor… #4055) commit a8b68c9 HBASE-26690 Modify FSTableDescriptors to not rely on renaming when wr… #4054) commit dffeb8e HBASE-26587 Introduce a new Admin API to change SFT implementation (#… #4080) commit b265fe5 HBASE-26673 Implement a shell command for change SFT implementation #4113) commit 4cdb380 HBASE-26640 Reimplement master local region initialization to better … #4111) commit 77bb153 HBASE-26707: Reduce number of renames during bulkload (#4066) #4122) commit a4b192e HBASE-26611 Changing SFT implementation on disabled table is dangerous #4082) commit d3629bb HBASE-26837 Set SFT config when creating TableDescriptor in TestClone… #4226) commit 541d748 HBASE-26881 Backport HBASE-25368 to branch-2 (#4267) Fixups for precommit error prone, checkstyle, and javadoc warnings after applying cherry picks. Signed-off-by: Josh Elser <elserj@apache.org> Reviewed-by: Wellington Ramos Chevreuil <wchevreuil@apache.org>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
…plementations