StripeStoreFileManager (Apache HBase

java.lang.Object
- org.apache.hadoop.hbase.regionserver.StripeStoreFileManager

所有已实现的接口:

StripeCompactionPolicy.StripeInformationProvider, StoreFileManager
```
@InterfaceAudience.Private
public class StripeStoreFileManager
extends Object
implements StoreFileManager, StripeCompactionPolicy.StripeInformationProvider
```
Stripe implementation of StoreFileManager. Not thread safe - relies on external locking (in HStore). Collections that this class returns are immutable or unique to the call, so they should be safe. Stripe store splits the key space of the region into non-overlapping stripes, as well as some recent files that have all the keys (level 0). Each stripe contains a set of files. When L0 is compacted, it's split into the files corresponding to existing stripe boundaries, that can thus be added to stripes. When scan or get happens, it only has to read the files from the corresponding stripes. See StripeCompationPolicy on how the stripes are determined; this class doesn't care. This class should work together with StripeCompactionPolicy and StripeCompactor. With regard to how they work, we make at least the following (reasonable) assumptions: - Compaction produces one file per new stripe (if any); that is easy to change. - Compaction has one contiguous set of stripes both in and out, except if L0 is involved.

字段概要

字段
限定符和类型	字段和说明
`static byte[]`	`OPEN_KEY` The key value used for range boundary, indicating that the boundary is open (i.e.
`static byte[]`	`STRIPE_END_KEY`
`static byte[]`	`STRIPE_START_KEY` The file metadata fields that contain the stripe information.

构造器概要

构造器
构造器和说明
`StripeStoreFileManager(CellComparator kvComparator, org.apache.hadoop.conf.Configuration conf, StripeStoreConfig config)`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`addCompactionResults(Collection<HStoreFile> compactedFiles, Collection<HStoreFile> results)` Adds only the new compaction results into the structure.
`org.apache.hbase.thirdparty.com.google.common.collect.ImmutableCollection<HStoreFile>`	`clearCompactedFiles()` Clears all the compacted files and returns them.
`org.apache.hbase.thirdparty.com.google.common.collect.ImmutableCollection<HStoreFile>`	`clearFiles()` Clears all the files currently in use and returns them.
`Iterator<HStoreFile>`	`getCandidateFilesForRowKeyBefore(KeyValue targetKey)` See `StoreFileManager.getCandidateFilesForRowKeyBefore(KeyValue)` for details on this methods.
`Collection<HStoreFile>`	`getCompactedfiles()` List of compacted files inside this store that needs to be excluded in reads because further new reads will be using only the newly created files out of compaction.
`int`	`getCompactedFilesCount()` Returns the number of compacted files.
`double`	`getCompactionPressure()`
`byte[]`	`getEndRow(int stripeIndex)` Gets the end row for a given stripe.
`Collection<HStoreFile>`	`getFilesForScan(byte[] startRow, boolean includeStartRow, byte[] stopRow, boolean includeStopRow)` Gets the store files to scan for a Scan or Get request.
`List<HStoreFile>`	`getLevel0Files()`
`Optional<byte[]>`	`getSplitPoint()` Override of getSplitPoint that determines the split point as the boundary between two stripes, unless it causes significant imbalance between split sides' sizes.
`byte[]`	`getStartRow(int stripeIndex)` Gets the start row for a given stripe.
`int`	`getStoreCompactionPriority()`
`Comparator<HStoreFile>`	`getStoreFileComparator()`
`int`	`getStorefileCount()` Returns the number of files currently in use.
`Collection<HStoreFile>`	`getStorefiles()` Gets the snapshot of the store files currently in use.
`List<byte[]>`	`getStripeBoundaries()`
`int`	`getStripeCount()`
`ArrayList<org.apache.hbase.thirdparty.com.google.common.collect.ImmutableList<HStoreFile>>`	`getStripes()`
`Collection<HStoreFile>`	`getUnneededFiles(long maxTs, List<HStoreFile> filesCompacting)`
`void`	`insertNewFiles(Collection<HStoreFile> sfs)` Adds new files, either for from MemStore flush or bulk insert, into the structure.
`void`	`loadFiles(List<HStoreFile> storeFiles)` Loads the initial store files into empty StoreFileManager.
`void`	`removeCompactedFiles(Collection<HStoreFile> compactedFiles)` Remove the compacted files
`Iterator<HStoreFile>`	`updateCandidateFilesForRowKeyBefore(Iterator<HStoreFile> candidateFiles, KeyValue targetKey, Cell candidate)` See `StoreFileManager.getCandidateFilesForRowKeyBefore(KeyValue)` and `StoreFileManager.updateCandidateFilesForRowKeyBefore(Iterator, KeyValue, Cell)` for details on this methods.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - STRIPE_START_KEY
```
public static final byte[] STRIPE_START_KEY
```
    The file metadata fields that contain the stripe information.
  - STRIPE_END_KEY
```
public static final byte[] STRIPE_END_KEY
```
  - OPEN_KEY
```
public static final byte[] OPEN_KEY
```
    The key value used for range boundary, indicating that the boundary is open (i.e. +-inf).
- 构造器详细资料
  - StripeStoreFileManager
```
public StripeStoreFileManager(CellComparator kvComparator,
                              org.apache.hadoop.conf.Configuration conf,
                              StripeStoreConfig config)
```
- 方法详细资料
  - loadFiles
```
public void loadFiles(List<HStoreFile> storeFiles)
```
    从接口复制的说明: StoreFileManager
    
    Loads the initial store files into empty StoreFileManager.
    
    指定者:
    
    loadFiles 在接口中 StoreFileManager
    
    参数:
    
    storeFiles - The files to load.
  - getStorefiles
```
public Collection<HStoreFile> getStorefiles()
```
    从接口复制的说明: StoreFileManager
    
    Gets the snapshot of the store files currently in use. Can be used for things like metrics and checks; should not assume anything about relations between store files in the list.
    
    指定者:
    
    getStorefiles 在接口中 StripeCompactionPolicy.StripeInformationProvider
    
    指定者:
    
    getStorefiles 在接口中 StoreFileManager
    
    返回:
    
    The list of StoreFiles.
  - getCompactedfiles
```
public Collection<HStoreFile> getCompactedfiles()
```
    从接口复制的说明: StoreFileManager
    
    List of compacted files inside this store that needs to be excluded in reads because further new reads will be using only the newly created files out of compaction. These compacted files will be deleted/cleared once all the existing readers on these compacted files are done.
    
    指定者:
    
    getCompactedfiles 在接口中 StoreFileManager
    
    返回:
    
    the list of compacted files
  - getCompactedFilesCount
```
public int getCompactedFilesCount()
```
    从接口复制的说明: StoreFileManager
    
    Returns the number of compacted files.
    
    指定者:
    
    getCompactedFilesCount 在接口中 StoreFileManager
    
    返回:
    
    The number of files.
  - insertNewFiles
```
public void insertNewFiles(Collection<HStoreFile> sfs)
                    throws IOException
```
    从接口复制的说明: StoreFileManager
    
    Adds new files, either for from MemStore flush or bulk insert, into the structure.
    
    指定者:
    
    insertNewFiles 在接口中 StoreFileManager
    
    参数:
    
    sfs - New store files.
    
    抛出:
    
    IOException
  - clearFiles
```
public org.apache.hbase.thirdparty.com.google.common.collect.ImmutableCollection<HStoreFile> clearFiles()
```
    从接口复制的说明: StoreFileManager
    
    Clears all the files currently in use and returns them.
    
    指定者:
    
    clearFiles 在接口中 StoreFileManager
    
    返回:
    
    The files previously in use.
  - clearCompactedFiles
```
public org.apache.hbase.thirdparty.com.google.common.collect.ImmutableCollection<HStoreFile> clearCompactedFiles()
```
    从接口复制的说明: StoreFileManager
    
    Clears all the compacted files and returns them. This method is expected to be accessed single threaded.
    
    指定者:
    
    clearCompactedFiles 在接口中 StoreFileManager
    
    返回:
    
    The files compacted previously.
  - getStorefileCount
```
public int getStorefileCount()
```
    从接口复制的说明: StoreFileManager
    
    Returns the number of files currently in use.
    
    指定者:
    
    getStorefileCount 在接口中 StoreFileManager
    
    返回:
    
    The number of files.
  - getCandidateFilesForRowKeyBefore
```
public Iterator<HStoreFile> getCandidateFilesForRowKeyBefore(KeyValue targetKey)
```
    See StoreFileManager.getCandidateFilesForRowKeyBefore(KeyValue) for details on this methods.
    
    指定者:
    
    getCandidateFilesForRowKeyBefore 在接口中 StoreFileManager
    
    参数:
    
    targetKey - The key that is the basis of the search.
    
    返回:
    
    The files that may have the key less than or equal to targetKey, in reverse order of new-ness, and preference for target key.
  - updateCandidateFilesForRowKeyBefore
```
public Iterator<HStoreFile> updateCandidateFilesForRowKeyBefore(Iterator<HStoreFile> candidateFiles,
                                                                KeyValue targetKey,
                                                                Cell candidate)
```
    See StoreFileManager.getCandidateFilesForRowKeyBefore(KeyValue) and StoreFileManager.updateCandidateFilesForRowKeyBefore(Iterator, KeyValue, Cell) for details on this methods.
    
    指定者:
    
    updateCandidateFilesForRowKeyBefore 在接口中 StoreFileManager
    
    参数:
    
    candidateFiles - The candidate files not yet checked for better candidates - return value from StoreFileManager.getCandidateFilesForRowKeyBefore(KeyValue), with some files already removed.
    
    targetKey - The key to search for.
    
    candidate - The current best candidate found.
    
    返回:
    
    The list to replace candidateFiles.
  - getSplitPoint
```
public Optional<byte[]> getSplitPoint()
                               throws IOException
```
    Override of getSplitPoint that determines the split point as the boundary between two stripes, unless it causes significant imbalance between split sides' sizes. In that case, the split boundary will be chosen from the middle of one of the stripes to minimize imbalance.
    
    指定者:
    
    getSplitPoint 在接口中 StoreFileManager
    
    返回:
    
    The split point, or null if no split is possible.
    
    抛出:
    
    IOException
  - getFilesForScan
```
public Collection<HStoreFile> getFilesForScan(byte[] startRow,
                                              boolean includeStartRow,
                                              byte[] stopRow,
                                              boolean includeStopRow)
```
    从接口复制的说明: StoreFileManager
    
    Gets the store files to scan for a Scan or Get request.
    
    指定者:
    
    getFilesForScan 在接口中 StoreFileManager
    
    参数:
    
    startRow - Start row of the request.
    
    stopRow - Stop row of the request.
    
    返回:
    
    The list of files that are to be read for this request.
  - addCompactionResults
```
public void addCompactionResults(Collection<HStoreFile> compactedFiles,
                                 Collection<HStoreFile> results)
                          throws IOException
```
    从接口复制的说明: StoreFileManager
    
    Adds only the new compaction results into the structure.
    
    指定者:
    
    addCompactionResults 在接口中 StoreFileManager
    
    参数:
    
    compactedFiles - The input files for the compaction.
    
    results - The resulting files for the compaction.
    
    抛出:
    
    IOException
  - removeCompactedFiles
```
public void removeCompactedFiles(Collection<HStoreFile> compactedFiles)
                          throws IOException
```
    从接口复制的说明: StoreFileManager
    
    Remove the compacted files
    
    指定者:
    
    removeCompactedFiles 在接口中 StoreFileManager
    
    参数:
    
    compactedFiles - the list of compacted files
    
    抛出:
    
    IOException
  - getStoreCompactionPriority
```
public int getStoreCompactionPriority()
```
    指定者:
    
    getStoreCompactionPriority 在接口中 StoreFileManager
    
    返回:
    
    The store compaction priority.
  - getStartRow
```
public final byte[] getStartRow(int stripeIndex)
```
    从接口复制的说明: StripeCompactionPolicy.StripeInformationProvider
    
    Gets the start row for a given stripe.
    
    指定者:
    
    getStartRow 在接口中 StripeCompactionPolicy.StripeInformationProvider
    
    参数:
    
    stripeIndex - Stripe index.
    
    返回:
    
    Start row. May be an open key.
  - getEndRow
```
public final byte[] getEndRow(int stripeIndex)
```
    从接口复制的说明: StripeCompactionPolicy.StripeInformationProvider
    
    Gets the end row for a given stripe.
    
    指定者:
    
    getEndRow 在接口中 StripeCompactionPolicy.StripeInformationProvider
    
    参数:
    
    stripeIndex - Stripe index.
    
    返回:
    
    End row. May be an open key.
  - getLevel0Files
```
public List<HStoreFile> getLevel0Files()
```
    指定者:
    
    getLevel0Files 在接口中 StripeCompactionPolicy.StripeInformationProvider
    
    返回:
    
    Level 0 files.
  - getStripeBoundaries
```
public List<byte[]> getStripeBoundaries()
```
    指定者:
    
    getStripeBoundaries 在接口中 StripeCompactionPolicy.StripeInformationProvider
    
    返回:
    
    All stripe boundaries; including the open ones on both ends.
  - getStripes
```
public ArrayList<org.apache.hbase.thirdparty.com.google.common.collect.ImmutableList<HStoreFile>> getStripes()
```
    指定者:
    
    getStripes 在接口中 StripeCompactionPolicy.StripeInformationProvider
    
    返回:
    
    The stripes.
  - getStripeCount
```
public int getStripeCount()
```
    指定者:
    
    getStripeCount 在接口中 StripeCompactionPolicy.StripeInformationProvider
    
    返回:
    
    Stripe count.
  - getUnneededFiles
```
public Collection<HStoreFile> getUnneededFiles(long maxTs,
                                               List<HStoreFile> filesCompacting)
```
    指定者:
    
    getUnneededFiles 在接口中 StoreFileManager
    
    参数:
    
    maxTs - Maximum expired timestamp.
    
    filesCompacting - Files that are currently compacting.
    
    返回:
    
    The files which don't have any necessary data according to TTL and other criteria.
  - getCompactionPressure
```
public double getCompactionPressure()
```
    指定者:
    
    getCompactionPressure 在接口中 StoreFileManager
    
    返回:
    
    the compaction pressure used for compaction throughput tuning.
    
    另请参阅:
    
    HStore.getCompactionPressure()
  - getStoreFileComparator
```
public Comparator<HStoreFile> getStoreFileComparator()
```
    指定者:
    
    getStoreFileComparator 在接口中 StoreFileManager
    
    返回:
    
    the comparator used to sort storefiles. Usually, the HStoreFile.getMaxSequenceId() is the first priority.

类 StripeStoreFileManager

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

STRIPE_START_KEY

STRIPE_END_KEY

OPEN_KEY

构造器详细资料

StripeStoreFileManager

方法详细资料

loadFiles

getStorefiles

getCompactedfiles

getCompactedFilesCount

insertNewFiles

clearFiles

clearCompactedFiles

getStorefileCount

getCandidateFilesForRowKeyBefore

updateCandidateFilesForRowKeyBefore

getSplitPoint

getFilesForScan

addCompactionResults

removeCompactedFiles

getStoreCompactionPriority

getStartRow

getEndRow

getLevel0Files

getStripeBoundaries

getStripes

getStripeCount

getUnneededFiles

getCompactionPressure

getStoreFileComparator