|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.accumulo.core.file.map.MyMapFile.Reader
public static class MyMapFile.Reader
Provide access to an existing map.
Constructor Summary | |
---|---|
|
MyMapFile.Reader(org.apache.hadoop.fs.FileSystem fs,
String dirName,
org.apache.hadoop.conf.Configuration conf)
Construct a map reader for the named map. |
|
MyMapFile.Reader(org.apache.hadoop.fs.FileSystem fs,
String dirName,
org.apache.hadoop.io.WritableComparator comparator,
org.apache.hadoop.conf.Configuration conf)
Construct a map reader for the named map using the named comparator. |
protected |
MyMapFile.Reader(org.apache.hadoop.fs.FileSystem fs,
String dirName,
org.apache.hadoop.io.WritableComparator comparator,
org.apache.hadoop.conf.Configuration conf,
boolean open)
Hook to allow subclasses to defer opening streams until further initialization is complete. |
Method Summary | |
---|---|
void |
close()
Close the map. |
void |
closeDeepCopies()
|
protected MySequenceFile.Reader |
createDataFileReader(org.apache.hadoop.fs.FileSystem fs,
org.apache.hadoop.fs.Path dataFile,
org.apache.hadoop.conf.Configuration conf)
Override this method to specialize the type of MySequenceFile.Reader returned. |
SortedKeyValueIterator<Key,Value> |
deepCopy(IteratorEnvironment env)
Creates a deep copy of this iterator as though seek had not yet been called. |
void |
dropIndex()
|
void |
finalKey(org.apache.hadoop.io.WritableComparable key)
Reads the final key from the file. |
org.apache.hadoop.io.Writable |
get(org.apache.hadoop.io.WritableComparable key,
org.apache.hadoop.io.Writable val)
Return the value for the named key, or null if none exists. |
org.apache.hadoop.io.WritableComparable |
getClosest(org.apache.hadoop.io.WritableComparable key,
org.apache.hadoop.io.Writable val)
Finds the record that is the closest match to the specified key. |
org.apache.hadoop.io.WritableComparable |
getClosest(org.apache.hadoop.io.WritableComparable key,
org.apache.hadoop.io.Writable val,
boolean before)
Finds the record that is the closest match to the specified key. |
org.apache.hadoop.io.WritableComparable |
getClosest(org.apache.hadoop.io.WritableComparable key,
org.apache.hadoop.io.Writable val,
boolean before,
org.apache.hadoop.io.WritableComparable lastKey)
|
Key |
getFirstKey()
|
int |
getIndexPosition(org.apache.hadoop.io.WritableComparable key)
|
Class |
getKeyClass()
Returns the class of keys in this file. |
Key |
getLastKey()
|
DataInputStream |
getMetaStore(String name)
|
Key |
getTopKey()
Returns top key. |
Value |
getTopValue()
Returns top value. |
Class |
getValueClass()
Returns the class of values in this file. |
boolean |
hasTop()
Returns true if the iterator has more elements. |
void |
init(SortedKeyValueIterator<Key,Value> source,
Map<String,String> options,
IteratorEnvironment env)
Initializes the iterator. |
org.apache.hadoop.io.WritableComparable |
midKey()
Get the key at approximately the middle of the file. |
void |
next()
Advances to the next K,V pair. |
boolean |
next(org.apache.hadoop.io.WritableComparable key,
org.apache.hadoop.io.Writable val)
Read the next key/value pair in the map into key and val . |
protected void |
open(org.apache.hadoop.fs.FileSystem fs,
String dirName,
org.apache.hadoop.io.WritableComparator comparator,
org.apache.hadoop.conf.Configuration conf)
|
void |
printIndex()
|
void |
reset()
Re-positions the reader before its first key. |
void |
seek(Range range,
Collection<ByteSequence> columnFamilies,
boolean inclusive)
Seeks to the first key in the Range, restricting the resulting K,V pairs to those with the specified columns. |
boolean |
seek(org.apache.hadoop.io.WritableComparable key)
Positions the reader at the named key, or if none such exists, at the first entry after the named key. |
boolean |
seek(org.apache.hadoop.io.WritableComparable key,
org.apache.hadoop.io.WritableComparable lastKey)
|
void |
setInterruptFlag(AtomicBoolean flag)
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public MyMapFile.Reader(org.apache.hadoop.fs.FileSystem fs, String dirName, org.apache.hadoop.conf.Configuration conf) throws IOException
IOException
public MyMapFile.Reader(org.apache.hadoop.fs.FileSystem fs, String dirName, org.apache.hadoop.io.WritableComparator comparator, org.apache.hadoop.conf.Configuration conf) throws IOException
IOException
protected MyMapFile.Reader(org.apache.hadoop.fs.FileSystem fs, String dirName, org.apache.hadoop.io.WritableComparator comparator, org.apache.hadoop.conf.Configuration conf, boolean open) throws IOException
IOException
createDataFileReader(FileSystem, Path, Configuration)
Method Detail |
---|
public Class getKeyClass()
public Class getValueClass()
public SortedKeyValueIterator<Key,Value> deepCopy(IteratorEnvironment env)
SortedKeyValueIterator
deepCopy
in interface SortedKeyValueIterator<Key,Value>
env
- IteratorEnvironment environment in which iterator is being run.
public void closeDeepCopies() throws IOException
closeDeepCopies
in interface FileSKVIterator
IOException
protected void open(org.apache.hadoop.fs.FileSystem fs, String dirName, org.apache.hadoop.io.WritableComparator comparator, org.apache.hadoop.conf.Configuration conf) throws IOException
IOException
protected MySequenceFile.Reader createDataFileReader(org.apache.hadoop.fs.FileSystem fs, org.apache.hadoop.fs.Path dataFile, org.apache.hadoop.conf.Configuration conf) throws IOException
MySequenceFile.Reader
returned.
IOException
public void reset() throws IOException
IOException
public org.apache.hadoop.io.WritableComparable midKey() throws IOException
IOException
public void finalKey(org.apache.hadoop.io.WritableComparable key) throws IOException
key
- key to read into
IOException
public boolean seek(org.apache.hadoop.io.WritableComparable key) throws IOException
IOException
public boolean seek(org.apache.hadoop.io.WritableComparable key, org.apache.hadoop.io.WritableComparable lastKey) throws IOException
IOException
public int getIndexPosition(org.apache.hadoop.io.WritableComparable key) throws IOException
IOException
public void printIndex() throws IOException
IOException
public boolean next(org.apache.hadoop.io.WritableComparable key, org.apache.hadoop.io.Writable val) throws IOException
key
and val
. Returns true if such a pair exists and false when at the end of the
map
IOException
public org.apache.hadoop.io.Writable get(org.apache.hadoop.io.WritableComparable key, org.apache.hadoop.io.Writable val) throws IOException
IOException
public org.apache.hadoop.io.WritableComparable getClosest(org.apache.hadoop.io.WritableComparable key, org.apache.hadoop.io.Writable val) throws IOException
key
or if it does not exist, at the first entry after the named
key. - *
key
- - key that we're trying to find - *val
- - data value if key is found - *
IOException
public org.apache.hadoop.io.WritableComparable getClosest(org.apache.hadoop.io.WritableComparable key, org.apache.hadoop.io.Writable val, boolean before) throws IOException
key
- - key that we're trying to findval
- - data value if key is foundbefore
- - IF true, and key
does not exist, return the first entry that falls just before the key
. Otherwise, return the record
that sorts just after.
IOException
public org.apache.hadoop.io.WritableComparable getClosest(org.apache.hadoop.io.WritableComparable key, org.apache.hadoop.io.Writable val, boolean before, org.apache.hadoop.io.WritableComparable lastKey) throws IOException
IOException
public void close() throws IOException
close
in interface FileSKVIterator
IOException
public Key getTopKey()
SortedKeyValueIterator
getTopKey
in interface SortedKeyValueIterator<Key,Value>
public Value getTopValue()
SortedKeyValueIterator
getTopValue
in interface SortedKeyValueIterator<Key,Value>
public boolean hasTop()
SortedKeyValueIterator
hasTop
in interface SortedKeyValueIterator<Key,Value>
public void init(SortedKeyValueIterator<Key,Value> source, Map<String,String> options, IteratorEnvironment env) throws IOException
SortedKeyValueIterator
init
in interface SortedKeyValueIterator<Key,Value>
source
- SortedKeyValueIterator source to read data from.options
- Map map of string option names to option values.env
- IteratorEnvironment environment in which iterator is being run.
IOException
- unused.public void next() throws IOException
SortedKeyValueIterator
next
in interface SortedKeyValueIterator<Key,Value>
IOException
- if an I/O error occurs.public void seek(Range range, Collection<ByteSequence> columnFamilies, boolean inclusive) throws IOException
SortedKeyValueIterator
SortedKeyValueIterator.init(org.apache.accumulo.core.iterators.SortedKeyValueIterator, java.util.Map, org.apache.accumulo.core.iterators.IteratorEnvironment)
is called.
Iterators that examine groups of adjacent key/value pairs (e.g. rows) to determine their top key and value should be sure that they properly handle a seek
to a key in the middle of such a group (e.g. the middle of a row). Even if the client always seeks to a range containing an entire group (a,c), the tablet
server could send back a batch of entries corresponding to (a,b], then reseek the iterator to range (b,c) when the scan is continued.
columnFamilies
is used, at the lowest level, to determine which data blocks inside of an RFile need to be opened for this iterator. This set of data
blocks is also the set of locality groups defined for the given table. If no columnFamilies are provided, the data blocks for all locality groups inside of
the correct RFile will be opened and seeked in an attempt to find the correct start key, irregardless of the startKey in the range
.
In an Accumulo instance in which multiple locality groups exist for a table, it is important to ensure that columnFamilies
is properly set to the
minimum required column families to ensure that data from separate locality groups is not inadvertently read.
seek
in interface SortedKeyValueIterator<Key,Value>
range
- Range of keys to iterate over.columnFamilies
- Collection of column families to include or exclude.inclusive
- boolean that indicates whether to include (true) or exclude (false) column families.
IOException
- if an I/O error occurs.public Key getFirstKey() throws IOException
getFirstKey
in interface FileSKVIterator
IOException
public Key getLastKey() throws IOException
getLastKey
in interface FileSKVIterator
IOException
public DataInputStream getMetaStore(String name) throws IOException
getMetaStore
in interface FileSKVIterator
IOException
public void dropIndex()
public void setInterruptFlag(AtomicBoolean flag)
setInterruptFlag
in interface InterruptibleIterator
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |