public interface TableOperations
Modifier and Type | Method and Description |
---|---|
void |
addAggregators(String tableName,
List<? extends PerColumnIteratorConfig> aggregators)
Deprecated.
since 1.4
attachIterator(String, IteratorSetting) |
void |
addSplits(String tableName,
SortedSet<org.apache.hadoop.io.Text> partitionKeys) |
void |
attachIterator(String tableName,
IteratorSetting setting)
Add an iterator to a table on all scopes.
|
void |
attachIterator(String tableName,
IteratorSetting setting,
EnumSet<IteratorUtil.IteratorScope> scopes)
Add an iterator to a table on the given scopes.
|
void |
checkIteratorConflicts(String tableName,
IteratorSetting setting,
EnumSet<IteratorUtil.IteratorScope> scopes)
Check whether a given iterator configuration conflicts with existing configuration; in particular, determine if the name or priority are already in use for
the specified scopes.
|
void |
clearLocatorCache(String tableName)
Clears the tablet locator cache for a specified table
|
void |
clone(String srcTableName,
String newTableName,
boolean flush,
Map<String,String> propertiesToSet,
Set<String> propertiesToExclude)
Clone a table from an existing table.
|
void |
compact(String tableName,
org.apache.hadoop.io.Text start,
org.apache.hadoop.io.Text end,
boolean flush,
boolean wait)
Starts a full major compaction of the tablets in the range (start, end].
|
void |
create(String tableName)
Create a table with no special configuration
|
void |
create(String tableName,
boolean limitVersion) |
void |
create(String tableName,
boolean versioningIter,
TimeType timeType) |
void |
delete(String tableName)
Delete a table
|
void |
deleteRows(String tableName,
org.apache.hadoop.io.Text start,
org.apache.hadoop.io.Text end)
Delete rows between (start, end]
|
boolean |
exists(String tableName)
A method to check if a table exists in Accumulo.
|
void |
flush(String tableName)
Deprecated.
As of release 1.4, replaced by
flush(String, Text, Text, boolean) |
void |
flush(String tableName,
org.apache.hadoop.io.Text start,
org.apache.hadoop.io.Text end,
boolean wait)
Flush a tables data that is currently in memory.
|
IteratorSetting |
getIteratorSetting(String tableName,
String name,
IteratorUtil.IteratorScope scope)
Get the settings for an iterator.
|
Map<String,Set<org.apache.hadoop.io.Text>> |
getLocalityGroups(String tableName)
Gets the locality groups currently set for a table.
|
org.apache.hadoop.io.Text |
getMaxRow(String tableName,
Authorizations auths,
org.apache.hadoop.io.Text startRow,
boolean startInclusive,
org.apache.hadoop.io.Text endRow,
boolean endInclusive)
Finds the max row within a given range.
|
Iterable<Map.Entry<String,String>> |
getProperties(String tableName)
Gets properties of a table
|
Collection<org.apache.hadoop.io.Text> |
getSplits(String tableName) |
Collection<org.apache.hadoop.io.Text> |
getSplits(String tableName,
int maxSplits) |
void |
importDirectory(String tableName,
String dir,
String failureDir,
boolean setTime)
Bulk import all the files in a directory into a table.
|
BulkImportHelper.AssignmentStats |
importDirectory(String tableName,
String dir,
String failureDir,
int numThreads,
int numAssignThreads,
boolean disableGC)
Deprecated.
Since 1.4 use
importDirectory(String, String, String, boolean) |
SortedSet<String> |
list() |
Map<String,EnumSet<IteratorUtil.IteratorScope>> |
listIterators(String tableName)
Get a list of iterators for this table.
|
void |
merge(String tableName,
org.apache.hadoop.io.Text start,
org.apache.hadoop.io.Text end)
Merge tablets between (start, end]
|
void |
offline(String tableName) |
void |
online(String tableName) |
void |
removeIterator(String tableName,
String name,
EnumSet<IteratorUtil.IteratorScope> scopes)
Remove an iterator from a table by name.
|
void |
removeProperty(String tableName,
String property)
Removes a property from a table
|
void |
rename(String oldTableName,
String newTableName)
Rename a table
|
void |
setLocalityGroups(String tableName,
Map<String,Set<org.apache.hadoop.io.Text>> groups)
Sets a tables locality groups.
|
void |
setProperty(String tableName,
String property,
String value)
Sets a property on a table
|
Set<Range> |
splitRangeByTablets(String tableName,
Range range,
int maxSplits) |
Map<String,String> |
tableIdMap()
Get a mapping of table name to internal table id.
|
boolean exists(String tableName)
tableName
- the name of the tablevoid create(String tableName) throws AccumuloException, AccumuloSecurityException, TableExistsException
tableName
- the name of the tableAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionTableExistsException
- if the table already existsvoid create(String tableName, boolean limitVersion) throws AccumuloException, AccumuloSecurityException, TableExistsException
tableName
- the name of the tablelimitVersion
- Enables/disables the versioning iterator, which will limit the number of Key versions kept.AccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionTableExistsException
- if the table already existsvoid create(String tableName, boolean versioningIter, TimeType timeType) throws AccumuloException, AccumuloSecurityException, TableExistsException
tableName
- the name of the tableversioningIter
- Enables/disables the versioning iterator, which will limit the number of Key versions kept.timeType
- specifies logical or real-time based time recording for entries in the tableAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionTableExistsException
- if the table already existsvoid addAggregators(String tableName, List<? extends PerColumnIteratorConfig> aggregators) throws AccumuloSecurityException, TableNotFoundException, AccumuloException
attachIterator(String, IteratorSetting)
tableName
- the name of the tableaggregators
- List of aggregators to addAccumuloSecurityException
- if insufficient permissions to do actionTableNotFoundException
- if table does not existAccumuloException
- if a general error occursvoid addSplits(String tableName, SortedSet<org.apache.hadoop.io.Text> partitionKeys) throws TableNotFoundException, AccumuloException, AccumuloSecurityException
tableName
- the name of the tablepartitionKeys
- a sorted set of row key values to pre-split the table onAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionTableNotFoundException
- if the table does not existCollection<org.apache.hadoop.io.Text> getSplits(String tableName) throws TableNotFoundException
tableName
- the name of the tableTableNotFoundException
- if the table does not existCollection<org.apache.hadoop.io.Text> getSplits(String tableName, int maxSplits) throws TableNotFoundException
tableName
- the name of the tablemaxSplits
- specifies the maximum number of splits to returnTableNotFoundException
org.apache.hadoop.io.Text getMaxRow(String tableName, Authorizations auths, org.apache.hadoop.io.Text startRow, boolean startInclusive, org.apache.hadoop.io.Text endRow, boolean endInclusive) throws TableNotFoundException, AccumuloException, AccumuloSecurityException
tableName
- auths
- find the max row that can seen with these authsstartRow
- row to start looking at, null means -InfinitystartInclusive
- determines if the start row is includedendRow
- row to stop looking at, null means InfinityendInclusive
- determines if the end row is includedAccumuloSecurityException
AccumuloException
TableNotFoundException
void merge(String tableName, org.apache.hadoop.io.Text start, org.apache.hadoop.io.Text end) throws AccumuloException, AccumuloSecurityException, TableNotFoundException
tableName
- the table to mergestart
- first tablet to be merged contains the row after this row, null means the first tabletend
- last tablet to be merged contains this row, null means the last tabletAccumuloException
AccumuloSecurityException
TableNotFoundException
void deleteRows(String tableName, org.apache.hadoop.io.Text start, org.apache.hadoop.io.Text end) throws AccumuloException, AccumuloSecurityException, TableNotFoundException
tableName
- the table to mergestart
- delete rows after this, null means the first row of the tableend
- last row to be deleted, inclusive, null means the last row of the tableAccumuloException
AccumuloSecurityException
TableNotFoundException
void compact(String tableName, org.apache.hadoop.io.Text start, org.apache.hadoop.io.Text end, boolean flush, boolean wait) throws AccumuloSecurityException, TableNotFoundException, AccumuloException
tableName
- the table to compactstart
- first tablet to be compacted contains the row after this row, null means the first tablet in tableend
- last tablet to be merged contains this row, null means the last tablet in tableflush
- when true, table memory is flushed before compaction startswait
- when true, the call will not return until compactions are finishedAccumuloSecurityException
TableNotFoundException
AccumuloException
void delete(String tableName) throws AccumuloException, AccumuloSecurityException, TableNotFoundException
tableName
- the name of the tableAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionTableNotFoundException
- if the table does not existvoid clone(String srcTableName, String newTableName, boolean flush, Map<String,String> propertiesToSet, Set<String> propertiesToExclude) throws AccumuloException, AccumuloSecurityException, TableNotFoundException, TableExistsException
srcTableName
- the table to clonenewTableName
- the name of the cloneflush
- determines if memory is flushed in the source table before cloning.propertiesToSet
- the sources tables properties are copied, this allows overriding of those propertiespropertiesToExclude
- do not copy these properties from the source table, just revert to system defaultsAccumuloException
AccumuloSecurityException
TableNotFoundException
TableExistsException
void rename(String oldTableName, String newTableName) throws AccumuloSecurityException, TableNotFoundException, AccumuloException, TableExistsException
oldTableName
- the old table namenewTableName
- the new table nameAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionTableNotFoundException
- if the old table name does not existTableExistsException
- if the new table name already existsvoid flush(String tableName) throws AccumuloException, AccumuloSecurityException
flush(String, Text, Text, boolean)
tableName
- the name of the tableAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionvoid flush(String tableName, org.apache.hadoop.io.Text start, org.apache.hadoop.io.Text end, boolean wait) throws AccumuloException, AccumuloSecurityException, TableNotFoundException
tableName
- the name of the tablewait
- if true the call will not return until all data present in memory when the call was is flushed if false will initiate a flush of data in memory,
but will not wait for it to completeAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionTableNotFoundException
void setProperty(String tableName, String property, String value) throws AccumuloException, AccumuloSecurityException
tableName
- the name of the tableproperty
- the name of a per-table propertyvalue
- the value to set a per-table property toAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionvoid removeProperty(String tableName, String property) throws AccumuloException, AccumuloSecurityException
tableName
- the name of the tableproperty
- the name of a per-table propertyAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionIterable<Map.Entry<String,String>> getProperties(String tableName) throws AccumuloException, TableNotFoundException
tableName
- the name of the tableTableNotFoundException
- if the table does not existAccumuloException
void setLocalityGroups(String tableName, Map<String,Set<org.apache.hadoop.io.Text>> groups) throws AccumuloException, AccumuloSecurityException, TableNotFoundException
tableName
- the name of the tablegroups
- mapping of locality group names to column families in the locality groupAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionTableNotFoundException
- if the table does not existMap<String,Set<org.apache.hadoop.io.Text>> getLocalityGroups(String tableName) throws AccumuloException, TableNotFoundException
tableName
- the name of the tableAccumuloException
- if a general error occursTableNotFoundException
- if the table does not existSet<Range> splitRangeByTablets(String tableName, Range range, int maxSplits) throws AccumuloException, AccumuloSecurityException, TableNotFoundException
tableName
- the name of the tablerange
- a range to splitmaxSplits
- the maximum number of splitsAccumuloException
- if a general error occursAccumuloSecurityException
- if the user does not have permissionTableNotFoundException
- if the table does not existvoid importDirectory(String tableName, String dir, String failureDir, boolean setTime) throws TableNotFoundException, IOException, AccumuloException, AccumuloSecurityException
tableName
- the name of the tabledir
- the HDFS directory to find files for importingfailureDir
- the HDFS directory to place files that failed to be imported, must exist and be emptyIOException
- when there is an error reading/writing to HDFSAccumuloException
- when there is a general accumulo errorAccumuloSecurityException
- when the user does not have the proper permissionsTableNotFoundException
- when the table no longer existsBulkImportHelper.AssignmentStats importDirectory(String tableName, String dir, String failureDir, int numThreads, int numAssignThreads, boolean disableGC) throws IOException, AccumuloException, AccumuloSecurityException
importDirectory(String, String, String, boolean)
void offline(String tableName) throws AccumuloSecurityException, AccumuloException, TableNotFoundException
tableName
- the table to take offlineAccumuloException
- when there is a general accumulo errorAccumuloSecurityException
- when the user does not have the proper permissionsTableNotFoundException
void online(String tableName) throws AccumuloSecurityException, AccumuloException, TableNotFoundException
tableName
- the table to take onlineAccumuloException
- when there is a general accumulo errorAccumuloSecurityException
- when the user does not have the proper permissionsTableNotFoundException
void clearLocatorCache(String tableName) throws TableNotFoundException
tableName
- the name of the tableTableNotFoundException
- if table does not existMap<String,String> tableIdMap()
void attachIterator(String tableName, IteratorSetting setting) throws AccumuloSecurityException, AccumuloException, TableNotFoundException
tableName
- the name of the tablesetting
- object specifying the properties of the iteratorAccumuloSecurityException
- thrown if the user does not have the ability to set properties on the tableAccumuloException
TableNotFoundException
- throw if the table no longer existsIllegalArgumentException
- if the setting conflicts with any existing iteratorsvoid attachIterator(String tableName, IteratorSetting setting, EnumSet<IteratorUtil.IteratorScope> scopes) throws AccumuloSecurityException, AccumuloException, TableNotFoundException
tableName
- the name of the tablesetting
- object specifying the properties of the iteratorAccumuloSecurityException
- thrown if the user does not have the ability to set properties on the tableAccumuloException
TableNotFoundException
- throw if the table no longer existsIllegalArgumentException
- if the setting conflicts with any existing iteratorsvoid removeIterator(String tableName, String name, EnumSet<IteratorUtil.IteratorScope> scopes) throws AccumuloSecurityException, AccumuloException, TableNotFoundException
tableName
- the name of the tablename
- the name of the iteratorscopes
- the scopes of the iteratorAccumuloSecurityException
- thrown if the user does not have the ability to set properties on the tableAccumuloException
TableNotFoundException
- throw if the table no longer existsIteratorSetting getIteratorSetting(String tableName, String name, IteratorUtil.IteratorScope scope) throws AccumuloSecurityException, AccumuloException, TableNotFoundException
tableName
- the name of the tablename
- the name of the iteratorscope
- the scope of the iteratorAccumuloSecurityException
- thrown if the user does not have the ability to set properties on the tableAccumuloException
TableNotFoundException
- throw if the table no longer existsMap<String,EnumSet<IteratorUtil.IteratorScope>> listIterators(String tableName) throws AccumuloSecurityException, AccumuloException, TableNotFoundException
tableName
- the name of the tableAccumuloSecurityException
AccumuloException
TableNotFoundException
void checkIteratorConflicts(String tableName, IteratorSetting setting, EnumSet<IteratorUtil.IteratorScope> scopes) throws AccumuloException, TableNotFoundException
tableName
- the name of the tablesetting
- object specifying the properties of the iteratorAccumuloException
TableNotFoundException
IllegalStateException
- if the setting conflicts with any existing iteratorsCopyright © 2012 The Apache Software Foundation. All Rights Reserved.