[GitHub] keith-turner commented on a change in pull request #44: ACCUMULO-4750 Created caching documentation

[GitBox <gi...@apache.org>]

keith-turner commented on a change in pull request #44: ACCUMULO-4750 Created caching documentation
URL: https://github.com/apache/accumulo-website/pull/44#discussion_r154681136
 
 

 ##########
 File path: _docs-2-0/administration/caching.md
 ##########
 @@ -0,0 +1,46 @@
+---
+title: Caching
+category: administration
+order: 11
+---
+
+Accumulo tablet servers have a **block cache** that buffers data in memory to limit reads from disk.
+This caching has the following benefits:
+
+* reduces latency when reading data
+* helps alleviate hotspots in tables
+
+The block cache stores index and data blocks. A typical Accumulo read will perfrom a binary search
+over several index blocks followed by a linear scan of one or more data blocks. Each tablet server
+has its own block cache that is shared by all hosted tablets. Therefore, block caches are only enabled
+for tables where read performance is critical.
+
+## Configuration
+
+While the block cache is enabled by default for the Accumulo metadata tables, it must be enabled
+for all other tables by setting the following table properties to `true`:
+
+* [table.cache.block.enable] - enables data block cache on the table
 
 Review comment:
   This is nice, linking to the prop docs.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services