[HBASE-16987] Update javadoc, refguide, and unit tests so ""...setting [scan] cache is ... old style..."; instead limit by size and time.

• Type: Sub-task
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: Scanners
• Assignee: Unassigned
• Reporter: Michael Stack
• Created: 01/Nov/16 18:10
• Updated: 07/May/19 16:11

Description

As yangzhe1991 says up in the parent issue, ""...Setting cache is an old style to limit size and time...". Lets make this indeed the case by updating javadoc, unit tests, and refguide in 1.3 going forward.

Setting how many rows to get at a time when scanning was always less-than-satisfactory, unpredictable as the data a row could contain. The hard work done to get us up on a size/time basis should be underlined and evangelized as the new norm. Thats what this issue is about (see parent issue for the kinds of problems we run into when it caching is the awkward row-count basis).

Issue Links

• relates to: HBASE-1996 Configure scanner buffer in bytes instead of number of rows