com.mapr.db.impl

Class AdminImpl

java.lang.Object

com.mapr.db.impl.AdminImpl

All Implemented Interfaces:

Admin, AutoCloseable

@API.Internal
public class AdminImpl
extends Object
implements Admin

Constructor Summary

Constructors

Constructor and Description
AdminImpl()
AdminImpl(org.apache.hadoop.conf.Configuration conf)
AdminImpl(com.mapr.fs.MapRFileSystem maprfs)

Method Summary

Methods

Modifier and Type	Method and Description
void	addFamily(org.apache.hadoop.fs.Path tablePath, FamilyDescriptor familyDesc)
void	alterFamily(org.apache.hadoop.fs.Path tablePath, String familyName, FamilyDescriptor familyDesc)
void	alterFamily(String tablePath, String familyName, FamilyDescriptor familyDesc)
void	alterTable(TableDescriptor desc) Modify the attributes of an existing table.
void	close() Override AutoCloseable.close() to avoid declaring a checked exception.
Table	createTable(org.apache.hadoop.fs.Path tablePath) Creates a Json table at the specified path with 'default' column family and default options.
Table	createTable(String tablePath) Creates a Json table at the specified path with 'default' column family and default options.
Table	createTable(String tablePath, boolean openTable)
Table	createTable(TableDescriptor tableDesc) Creates a Json table using the specified TableDescriptor.
Table	createTable(TableDescriptor tableDesc, boolean openTable)
Table	createTable(TableDescriptor tableDesc, ByteBuffer[] splitPoints) Creates a pre-split JSON table using the specified TableDescriptor and the split points as the tablet boundaries.
Table	createTable(TableDescriptor tableDesc, String[] splitPoints) Creates a pre-split Json table using the specified TableDescriptor and the split points as the tablet boundaries.
Table	createTable(TableDescriptor tableDesc, org.ojai.Value[] splitPoints)
static void	createTableForCopy(String replicaPath, String srcPath, List<String> cfList, boolean isBulkload) Deprecated.
boolean	deleteFamily(org.apache.hadoop.fs.Path tablePath, String familyName) Deletes a family from a Json table.
boolean	deleteFamily(String tablePath, String familyName) Deletes a family from a Json table.
boolean	deleteTable(org.apache.hadoop.fs.Path tablePath) Deletes a Table.
boolean	deleteTable(String tablePath) Deletes a Table.
TableDescriptor	getTableDescriptor(org.apache.hadoop.fs.Path tablePath)
TableDescriptor	getTableDescriptor(String tablePath)
List<org.apache.hadoop.fs.Path>	listTables() List all tables in user's home directory.
List<org.apache.hadoop.fs.Path>	listTables(org.apache.hadoop.fs.Path folderOrPattern) List all tables in the specified folder and/or with the matching pattern.
List<org.apache.hadoop.fs.Path>	listTables(String folderOrPattern) List all tables in the specified folder and/or with the matching pattern.
boolean	tableExists(org.apache.hadoop.fs.Path tablePath)
boolean	tableExists(String tablePath)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AdminImpl

public AdminImpl()
          throws DBException

Throws:

DBException

AdminImpl

public AdminImpl(org.apache.hadoop.conf.Configuration conf)
          throws DBException

Throws:

DBException

AdminImpl

public AdminImpl(com.mapr.fs.MapRFileSystem maprfs)
          throws DBException

Throws:

DBException

Method Detail

close

public void close()
           throws DBException

Description copied from interface: Admin

Override AutoCloseable.close() to avoid declaring a checked exception.

Specified by:

close in interface Admin

Specified by:

close in interface AutoCloseable

Throws:

DBException

listTables

public List<org.apache.hadoop.fs.Path> listTables()
                                           throws DBException

Description copied from interface: Admin

List all tables in user's home directory.

Specified by:

listTables in interface Admin

Returns:

a list of table paths

Throws:

DBException

listTables

public List<org.apache.hadoop.fs.Path> listTables(String folderOrPattern)
                                           throws DBException

Description copied from interface: Admin

List all tables in the specified folder and/or with the matching pattern.

Specified by:

listTables in interface Admin

Parameters:

folderOrPattern - the parent folder or pattern

Returns:

a list of table paths

Throws:

DBException

listTables

public List<org.apache.hadoop.fs.Path> listTables(org.apache.hadoop.fs.Path folderOrPattern)
                                           throws DBException

Description copied from interface: Admin

List all tables in the specified folder and/or with the matching pattern.

Specified by:

listTables in interface Admin

Parameters:

folderOrPattern - the parent folder or pattern

Returns:

a list of table paths

Throws:

DBException

createTable

public Table createTable(String tablePath)
                  throws TableExistsException,
                         DBException

Description copied from interface: Admin

Creates a Json table at the specified path with 'default' column family and default options.

Specified by:

createTable in interface Admin

Parameters:

tablePath - The table path. The table path can be either absolute or relative to user's home directory. The absolute path can be specified as "/<tablepath>" for tables in default cluster or as "/mapr/<clustername>/<tablepath>" for tables in the specified cluster

Returns:

Table object for accessing the table

Throws:

TableExistsException - if a table with the specified path already exits

DBException - if some DBException occurs

createTable

public Table createTable(org.apache.hadoop.fs.Path tablePath)
                  throws DBException

Description copied from interface: Admin

Creates a Json table at the specified path with 'default' column family and default options.

Specified by:

createTable in interface Admin

Parameters:

tablePath - The table path. The table path can be either absolute or relative to user's home directory. The absolute path can be specified as "/<tablepath>" for tables in default cluster or as "/mapr/<clustername>/<tablepath>" for tables in the specified cluster

Returns:

Table object for accessing the table

Throws:

TableExistsException - if a table with the specified path already exits

DBException - if some DBException occurs

createTable

public Table createTable(TableDescriptor tableDesc)
                  throws TableExistsException,
                         DBException

Description copied from interface: Admin

Creates a Json table using the specified TableDescriptor.

Specified by:

createTable in interface Admin

Parameters:

tableDesc - the TableDescriptor containing various attributes of this table

Returns:

a Table object connected to the newly created table

Throws:

TableExistsException - if the table already exist at the specified path

DBException - if an DBException occurs

createTable

public Table createTable(TableDescriptor tableDesc,
                org.ojai.Value[] splitPoints)
                  throws TableExistsException,
                         DBException

Throws:

TableExistsException

DBException

createTable

public Table createTable(TableDescriptor tableDesc,
                String[] splitPoints)
                  throws TableExistsException,
                         DBException

Description copied from interface: Admin

Creates a pre-split Json table using the specified TableDescriptor and the split points as the tablet boundaries. The number of tablets is 1 + the number of split points. The split points must be in sorted order.

Specified by:

createTable in interface Admin

Parameters:

tableDesc - the TableDescriptor containing various attributes of this table

splitPoints - the split points for this table

Returns:

Throws:

TableExistsException

DBException

createTable

public Table createTable(TableDescriptor tableDesc,
                ByteBuffer[] splitPoints)
                  throws TableExistsException,
                         DBException

Description copied from interface: Admin

Creates a pre-split JSON table using the specified TableDescriptor and the split points as the tablet boundaries. The number of tablets is 1 + the number of split points. The split points must be in sorted order.

Specified by:

createTable in interface Admin

Parameters:

tableDesc - the TableDescriptor containing various attributes of this table

splitPoints - the split points for this table

Returns:

Throws:

TableExistsException

DBException

createTable

@API.Internal
public Table createTable(String tablePath,
                             boolean openTable)
                  throws TableExistsException,
                         DBException

Throws:

TableExistsException

DBException

createTable

@API.Internal
public Table createTable(TableDescriptor tableDesc,
                             boolean openTable)
                  throws TableExistsException,
                         DBException

Throws:

TableExistsException

DBException

alterTable

public void alterTable(TableDescriptor desc)
                throws TableNotFoundException,
                       DBException

Description copied from interface: Admin

Modify the attributes of an existing table. This API cannot be used to modify (add/remove/alter) families of the table. Please use #addFamily(Path, FamilyDescriptor), Admin.deleteFamily(Path, String), and Admin.alterFamily(Path, String, FamilyDescriptor) for this purpose.

Specified by:

alterTable in interface Admin

Parameters:

desc - the TableDescriptor containing various attributes of this table

Throws:

TableNotFoundException

OpNotPermittedException - if an attribute is requested to be modified but is not allowed

DBException

addFamily

public void addFamily(org.apache.hadoop.fs.Path tablePath,
             FamilyDescriptor familyDesc)
               throws TableNotFoundException,
                      FamilyExistsException,
                      DBException

Throws:

TableNotFoundException

FamilyExistsException

DBException

deleteFamily

public boolean deleteFamily(String tablePath,
                   String familyName)
                     throws TableNotFoundException,
                            FamilyNotFoundException,
                            DBException

Description copied from interface: Admin

Deletes a family from a Json table.

Specified by:

deleteFamily in interface Admin

Returns:

true if and only if the family is successfully deleted; false otherwise

Throws:

DBException

TableNotFoundException

FamilyNotFoundException

deleteFamily

public boolean deleteFamily(org.apache.hadoop.fs.Path tablePath,
                   String familyName)
                     throws TableNotFoundException,
                            FamilyNotFoundException,
                            DBException

Description copied from interface: Admin

Deletes a family from a Json table.

Specified by:

deleteFamily in interface Admin

Returns:

true if and only if the family is successfully deleted; false otherwise

Throws:

DBException

TableNotFoundException

FamilyNotFoundException

alterFamily

public void alterFamily(String tablePath,
               String familyName,
               FamilyDescriptor familyDesc)
                 throws TableNotFoundException,
                        FamilyNotFoundException,
                        OpNotPermittedException,
                        DBException

Specified by:

alterFamily in interface Admin

Throws:

TableNotFoundException

FamilyNotFoundException

OpNotPermittedException - if an attribute is requested to be modified but is not allowed

DBException

alterFamily

public void alterFamily(org.apache.hadoop.fs.Path tablePath,
               String familyName,
               FamilyDescriptor familyDesc)
                 throws TableNotFoundException,
                        FamilyNotFoundException,
                        DBException

Specified by:

alterFamily in interface Admin

Throws:

TableNotFoundException

FamilyNotFoundException

OpNotPermittedException - if an attribute is requested to be modified but is not allowed

DBException

tableExists

public boolean tableExists(String tablePath)
                    throws DBException

Specified by:

tableExists in interface Admin

Parameters:

tablePath - The table path. The table path can be either absolute or relative to user's home directory. The absolute path can be specified as "/<tablepath>" for tables in default cluster or as "/mapr/<clustername>/<tablepath>" for tables in the specified cluster

Returns:

true if the specified path exists and is a table

Throws:

DBException

tableExists

public boolean tableExists(org.apache.hadoop.fs.Path tablePath)
                    throws DBException

Specified by:

tableExists in interface Admin

Parameters:

tablePath - The table path. The table path can be either absolute or relative to user's home directory. The absolute path can be specified as "/<tablepath>" for tables in default cluster or as "/mapr/<clustername>/<tablepath>" for tables in the specified cluster

Returns:

true if the specified path exists and is a table

Throws:

DBException

getTableDescriptor

public TableDescriptor getTableDescriptor(String tablePath)
                                   throws DBException

Specified by:

getTableDescriptor in interface Admin

Parameters:

tablePath - The table path. The table path can be either absolute or relative to user's home directory. The absolute path can be specified as "/<tablepath>" for tables in default cluster or as "/mapr/<clustername>/<tablepath>" for tables in the specified cluster

Returns:

TableDescriptor for the specified table

Throws:

DBException

getTableDescriptor

public TableDescriptor getTableDescriptor(org.apache.hadoop.fs.Path tablePath)
                                   throws DBException

Specified by:

getTableDescriptor in interface Admin

Parameters:

tablePath - The table path. The table path can be either absolute or relative to user's home directory. The absolute path can be specified as "/<tablepath>" for tables in default cluster or as "/mapr/<clustername>/<tablepath>" for tables in the specified cluster

Returns:

TableDescriptor for the specified table

Throws:

DBException

deleteTable

public boolean deleteTable(String tablePath)
                    throws DBException

Description copied from interface: Admin

Deletes a Table.

Specified by:

deleteTable in interface Admin

Parameters:

tablePath - The table path. The table path can be either absolute or relative to user's home directory. The absolute path can be specified as "/<tablepath>" for tables in default cluster or as "/mapr/<clustername>/<tablepath>" for tables in the specified cluster

Returns:

true if and only if the table is successfully deleted; otherwise, false

Throws:

AccessDeniedException - if the user does not have permission to delete the table.

DBException

deleteTable

public boolean deleteTable(org.apache.hadoop.fs.Path tablePath)
                    throws DBException

Description copied from interface: Admin

Deletes a Table.

Specified by:

deleteTable in interface Admin

Parameters:

tablePath - The table path. The table path can be either absolute or relative to user's home directory. The absolute path can be specified as "/<tablepath>" for tables in default cluster or as "/mapr/<clustername>/<tablepath>" for tables in the specified cluster

Returns:

true if and only if the table is successfully deleted; otherwise, false

Throws:

AccessDeniedException - If the user does not have permission to delete the table.

DBException

createTableForCopy

@Deprecated
public static void createTableForCopy(String replicaPath,
                                 String srcPath,
                                 List<String> cfList,
                                 boolean isBulkload)
                               throws DBException

Deprecated.

Creates a JSON DB Table as CopyTable destination TODO JJS: Remove with Bug 19295 fixed

Throws:

DBException