From 0bf91ac41f0f1333a7aea6a2d127d7d3d353c568 Mon Sep 17 00:00:00 2001 From: Misty Stanley-Jones Date: Wed, 16 Dec 2015 11:28:57 -0800 Subject: [PATCH] HBASE-14994 Clean up some broken links and references to old APIs --- src/main/asciidoc/_chapters/appendix_hfile_format.adoc | 10 ++++++---- src/main/asciidoc/_chapters/hbase-default.adoc | 4 +++- src/main/asciidoc/_chapters/schema_design.adoc | 9 +++++++-- 3 files changed, 16 insertions(+), 7 deletions(-) diff --git a/src/main/asciidoc/_chapters/appendix_hfile_format.adoc b/src/main/asciidoc/_chapters/appendix_hfile_format.adoc index 98dda5f..18eafe6 100644 --- a/src/main/asciidoc/_chapters/appendix_hfile_format.adoc +++ b/src/main/asciidoc/_chapters/appendix_hfile_format.adoc @@ -225,7 +225,7 @@ In contrast with version 1, in a version 2 HFile Bloom filter metadata is stored ==== File Info format in versions 1 and 2 -The file info block is a serialized link:http://hbase.apache.org/devapidocs/org/apache/hadoop/hbase/io/HbaseMapWritable.html[HbaseMapWritable] (essentially a map from byte arrays to byte arrays) with the following keys, among others. +The file info block is a serialized map from byte arrays to byte arrays, with the following keys, among others. StoreFile-level logic adds more keys to this. [cols="1,1", frame="all"] @@ -235,9 +235,11 @@ StoreFile-level logic adds more keys to this. |hfile.AVG_VALUE_LEN| The average value length in the file (int) |=== -File info format did not change in version 2. -However, we moved the file info to the final section of the file, which can be loaded as one block at the time the HFile is being opened. -Also, we do not store comparator in the version 2 file info anymore. +In version 2, we did not change the file format, but we moved the file info to +the final section of the file, which can be loaded as one block when the HFile +is being opened. + +Also, we do not store the comparator in the version 2 file info anymore. Instead, we store it in the fixed file trailer. This is because we need to know the comparator at the time of parsing the load-on-open section of the HFile. diff --git a/src/main/asciidoc/_chapters/hbase-default.adoc b/src/main/asciidoc/_chapters/hbase-default.adoc index 9a5c1f0..26929a3 100644 --- a/src/main/asciidoc/_chapters/hbase-default.adoc +++ b/src/main/asciidoc/_chapters/hbase-default.adoc @@ -1248,7 +1248,9 @@ When the size of a leaf-level, intermediate-level, or root-level + .Description Where to store the contents of the bucketcache. One of: onheap, - offheap, or file. If a file, set it to file:PATH_TO_FILE. See https://hbase.apache.org/apidocs/org/apache/hadoop/hbase/io/hfile/CacheConfig.html for more information. + offheap, or file. If a file, set it to file:PATH_TO_FILE. + See https://hbase.apache.org/devapidocs/org/apache/hadoop/hbase/io/hfile/CacheConfig.html + for more information. + .Default diff --git a/src/main/asciidoc/_chapters/schema_design.adoc b/src/main/asciidoc/_chapters/schema_design.adoc index e2dcbad..e5fdd23 100644 --- a/src/main/asciidoc/_chapters/schema_design.adoc +++ b/src/main/asciidoc/_chapters/schema_design.adoc @@ -632,8 +632,13 @@ For more information, see <> == Constraints HBase currently supports 'constraints' in traditional (SQL) database parlance. -The advised usage for Constraints is in enforcing business rules for attributes in the table (e.g. make sure values are in the range 1-10). Constraints could also be used to enforce referential integrity, but this is strongly discouraged as it will dramatically decrease the write throughput of the tables where integrity checking is enabled. -Extensive documentation on using Constraints can be found at: link:http://hbase.apache.org/apidocs/org/apache/hadoop/hbase/constraint[Constraint] since version 0.94. +The advised usage for Constraints is in enforcing business rules for attributes +in the table (e.g. make sure values are in the range 1-10). Constraints could +also be used to enforce referential integrity, but this is strongly discouraged +as it will dramatically decrease the write throughput of the tables where integrity +checking is enabled. Extensive documentation on using Constraints can be found at +link:http://hbase.apache.org/devapidocs/org/apache/hadoop/hbase/constraint/Constraint.html[Constraint] +since version 0.94. [[schema.casestudies]] == Schema Design Case Studies -- 2.5.4 (Apple Git-61)