diff --git a/src/main/docbkx/book.xml b/src/main/docbkx/book.xml index 163bea35e20..675564db8aa 100644 --- a/src/main/docbkx/book.xml +++ b/src/main/docbkx/book.xml @@ -2134,12 +2134,14 @@ rs.close();
General Cache Configurations - Apart from the cache implementaiton itself, you can set some general - configuration options to control how the cache performs. - See . - After setting any of these options, restart or rolling restart your cluster for the - configuration to take effect. Check logs for errors or unexpected behavior. + Apart from the cache implementation itself, you can set some general configuration + options to control how the cache performs. See . After setting any of these options, restart or rolling restart your cluster for the + configuration to take effect. Check logs for errors or unexpected behavior. + See also , which discusses a new option + introduced in HBASE-9857.
diff --git a/src/main/docbkx/performance.xml b/src/main/docbkx/performance.xml index 58557db2a1a..599677cbab2 100644 --- a/src/main/docbkx/performance.xml +++ b/src/main/docbkx/performance.xml @@ -217,6 +217,37 @@ A memory setting for the RegionServer process.
+
+ Prefetch Option for Blockcache + HBASE-9857 + adds a new option to prefetch HFile contents when opening the blockcache, if a columnfamily + or regionserver property is set. This option is available for HBase 0.98.3 and later. The + purpose is to warm the blockcache as rapidly as possible after the cache is opened, using + in-memory table data, and not counting the prefetching as cache misses. This is great for + fast reads, but is not a good idea if the data to be preloaded will not fit into the + blockcache. It is useful for tuning the IO impact of prefetching versus the time before all + data blocks are in cache. + To enable prefetching on a given column family, you can use HBase Shell or use the + API. + + Enable Prefetch Using HBase Shell + hbase> create 'MyTable', { NAME => 'myCF', PREFETCH_BLOCKS_ON_OPEN => 'true' } + + + Enable Prefetch Using the API + +// ... +HTableDescriptor tableDesc = new HTableDescriptor("myTable"); +HColumnDescriptor cfDesc = new HColumnDescriptor("myCF"); +cfDesc.setPrefetchBlocksOnOpen(true); +tableDesc.addFamily(cfDesc); +// ... + + + See the API documentation for CacheConfig. +
<varname>hbase.regionserver.global.memstore.size</varname> See .