Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
org.apache.hadoop.hbase.client.AsyncTable.CheckAndMutateBuilder Since 3.0.0, will be removed in 4.0.0. For internal test use only, do not use it any more.
org.apache.hadoop.hbase.client.AsyncTable.CheckAndMutateWithFilterBuilder Since 3.0.0, will be removed in 4.0.0. For internal test use only, do not use it any more.
org.apache.hadoop.hbase.ipc.CoprocessorRpcChannel Please stop using this class again, as it is too low level, which is part of the rpc framework for HBase. Will be deleted in 4.0.0.
org.apache.hadoop.hbase.client.Table.CheckAndMutateBuilder Since 3.0.0, will be removed in 4.0.0. For internal test use only, do not use it any more.
org.apache.hadoop.hbase.client.Table.CheckAndMutateWithFilterBuilder Since 3.0.0, will be removed in 4.0.0. For internal test use only, do not use it any more.

Deprecated Classes

Class and Description
org.apache.hadoop.hbase.filter.FirstKeyValueMatchingQualifiersFilter Deprecated in 2.0.0 and will be removed in 3.0.0.
org.apache.hadoop.hbase.client.LogQueryFilter as of 2.4.0. Will be removed in 4.0.0.
org.apache.hadoop.hbase.client.MasterRegistry Since 2.5.0, will be removed in 4.0.0. Use RpcConnectionRegistry instead.

Deprecated Exceptions

Exceptions and Description
org.apache.hadoop.hbase.exceptions.PreemptiveFastFailException since 2.3.0, and will be removed in 4.0.0.

Deprecated Fields

Field and Description
org.apache.hadoop.hbase.zookeeper.ZNodePaths.balancerZNode Since 2.6.0, will be removed in 4.0.0. We use master local region to store this state.
org.apache.hadoop.hbase.client.BufferedMutator.CLASSNAME_KEY Since 3.0.0, will be removed in 4.0.0. For internal test use only, do not use it any more.
org.apache.hadoop.hbase.client.TableDescriptorBuilder.NAMESPACE_COL_DESC_BYTES namespace table has been folded into the ns family in meta table, do not use this any more.
org.apache.hadoop.hbase.client.TableDescriptorBuilder.NAMESPACE_FAMILY_INFO namespace table has been folded into the ns family in meta table, do not use this any more.
org.apache.hadoop.hbase.client.TableDescriptorBuilder.NAMESPACE_FAMILY_INFO_BYTES namespace table has been folded into the ns family in meta table, do not use this any more.
org.apache.hadoop.hbase.client.TableDescriptorBuilder.NAMESPACE_TABLEDESC since 3.0.0 and will be removed in 4.0.0. We have folded the data in namespace table into meta table, so do not use it any more.
org.apache.hadoop.hbase.client.TableDescriptorBuilder.NORMALIZER_TARGET_REGION_SIZE
org.apache.hadoop.hbase.zookeeper.ZNodePaths.regionNormalizerZNode Since 2.6.0, will be removed in 4.0.0. We use master local region to store this state.
org.apache.hadoop.hbase.zookeeper.ZNodePaths.snapshotCleanupZNode Since 2.6.0, will be removed in 4.0.0. We use master local region to store this state.
org.apache.hadoop.hbase.zookeeper.ZNodePaths.switchZNode Since 2.6.0, will be removed in 4.0.0. We use master local region to store this state.
org.apache.hadoop.hbase.zookeeper.ZNodePaths.tableZNode

Deprecated Methods

Method and Description
org.apache.hadoop.hbase.client.AsyncAdmin.abortProcedure(long, boolean) since 2.1.1 and will be removed in 4.0.0.
org.apache.hadoop.hbase.client.Admin.abortProcedure(long, boolean) since 2.1.1 and will be removed in 4.0.0.
org.apache.hadoop.hbase.client.Admin.abortProcedureAsync(long, boolean) since 2.1.1 and will be removed in 4.0.0.
org.apache.hadoop.hbase.client.AsyncAdmin.balance(boolean) Since 2.5.0. Will be removed in 4.0.0. Use AsyncAdmin.balance(BalanceRequest) instead.
org.apache.hadoop.hbase.client.Admin.balance(boolean) Since 2.5.0. Will be removed in 4.0.0. Use Admin.balance(BalanceRequest) instead.
org.apache.hadoop.hbase.client.Table.batchCallback(List<? extends Row>, Object[], Batch.Callback<R>) since 3.0.0, will removed in 4.0.0. Please use the batch related methods in AsyncTable directly if you want to use callback. We reuse the callback for coprocessor here, and the problem is that for batch operation, the AsyncTable does not tell us the region, so in this method we need an extra locating after we get the result, which is not good.
org.apache.hadoop.hbase.client.Table.batchCoprocessorService(Descriptors.MethodDescriptor, Message, byte[], byte[], R) since 3.0.0, will removed in 4.0.0. The batch call here references the blocking interface for of a protobuf stub, so it is not possible to do it in an asynchronous way, even if now we are building the Table implementation based on the AsyncTable, which is not good. Use the coprocessorService methods in AsyncTable directly instead.
org.apache.hadoop.hbase.client.Table.batchCoprocessorService(Descriptors.MethodDescriptor, Message, byte[], byte[], R, Batch.Callback<R>) since 3.0.0, will removed in 4.0.0. The batch call here references the blocking interface for of a protobuf stub, so it is not possible to do it in an asynchronous way, even if now we are building the Table implementation based on the AsyncTable, which is not good. Use the coprocessorService methods in AsyncTable directly instead.
org.apache.hadoop.hbase.client.AsyncTable.checkAndMutate(byte[], byte[]) Since 3.0.0, will be removed in 4.0.0. For internal test use only, do not use it any more.
org.apache.hadoop.hbase.client.Table.checkAndMutate(byte[], byte[]) Since 3.0.0, will be removed in 4.0.0. For internal test use only, do not use it any more.
org.apache.hadoop.hbase.client.AsyncTable.checkAndMutate(byte[], Filter) Since 3.0.0, will be removed in 4.0.0. For internal test use only, do not use it any more.
org.apache.hadoop.hbase.client.Table.checkAndMutate(byte[], Filter) Since 3.0.0, will be removed in 4.0.0. For internal test use only, do not use it any more.
org.apache.hadoop.hbase.client.Admin.coprocessorService() since 3.0.0, will removed in 4.0.0. This is too low level, please stop using it any more. Use the coprocessorService methods in AsyncAdmin instead.
org.apache.hadoop.hbase.client.Table.coprocessorService(byte[]) since 3.0.0, will removed in 4.0.0. This is too low level, please stop using it any more. Use the coprocessorService methods in AsyncTable instead.
org.apache.hadoop.hbase.client.Table.coprocessorService(Class<T>, byte[], byte[], Batch.Call<T, R>) since 3.0.0, will removed in 4.0.0. The batch call here references the blocking interface for of a protobuf stub, so it is not possible to do it in an asynchronous way, even if now we are building the Table implementation based on the AsyncTable, which is not good. Use the coprocessorService methods in AsyncTable directly instead.
org.apache.hadoop.hbase.client.Table.coprocessorService(Class<T>, byte[], byte[], Batch.Call<T, R>, Batch.Callback<R>) since 3.0.0, will removed in 4.0.0. The batch call here references the blocking interface for of a protobuf stub, so it is not possible to do it in an asynchronous way, even if now we are building the Table implementation based on the AsyncTable, which is not good. Use the coprocessorService methods in AsyncTable directly instead.
org.apache.hadoop.hbase.client.Admin.coprocessorService(ServerName) since 3.0.0, will removed in 4.0.0. This is too low level, please stop using it any more. Use the coprocessorService methods in AsyncAdmin instead.
org.apache.hadoop.hbase.client.BufferedMutatorParams.getImplementationClassName() Since 3.0.0, will be removed in 4.0.0. You can not set it any more as the implementation has to use too many internal stuffs in HBase.
org.apache.hadoop.hbase.client.BufferedMutatorParams.getPool() Since 3.0.0-alpha-2, will be removed in 4.0.0. You can not set it anymore. BufferedMutator will use Connection's ExecutorService.
org.apache.hadoop.hbase.client.AsyncAdmin.getSlowLogResponses(Set<ServerName>, LogQueryFilter) since 2.4.0 and will be removed in 4.0.0. Use AsyncAdmin.getLogEntries(Set, String, ServerType, int, Map) instead.
org.apache.hadoop.hbase.client.Admin.getSlowLogResponses(Set<ServerName>, LogQueryFilter) since 2.4.0 and will be removed in 4.0.0. Use Admin.getLogEntries(Set, String, ServerType, int, Map) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.getUserPermissions(RpcController, AccessControlProtos.AccessControlService.BlockingInterface) Use Admin.getUserPermissions(GetUserPermissionsRequest) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.getUserPermissions(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, byte[]) Use Admin.getUserPermissions(GetUserPermissionsRequest) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.getUserPermissions(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, byte[], String) Use Admin.getUserPermissions(GetUserPermissionsRequest) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.getUserPermissions(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, String) Use Admin.getUserPermissions(GetUserPermissionsRequest) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.getUserPermissions(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, TableName) Use Admin.getUserPermissions(GetUserPermissionsRequest) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.getUserPermissions(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, TableName, byte[], byte[], String) Use Admin.getUserPermissions(GetUserPermissionsRequest) instead.
org.apache.hadoop.hbase.client.BufferedMutatorParams.getWriteBufferPeriodicFlushTimerTickMs() Since 3.0.0, will be removed in 4.0.0. We use a common timer in the whole client implementation so you can not set it any more.
org.apache.hadoop.hbase.security.access.AccessControlUtil.grant(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, String, boolean, Permission.Action...) Use Admin.grant(UserPermission, boolean) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.grant(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, String, String, boolean, Permission.Action...) Use Admin.grant(UserPermission, boolean) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.grant(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, String, TableName, byte[], byte[], boolean, Permission.Action...) Use Admin.grant(UserPermission, boolean) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.hasPermission(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, TableName, byte[], byte[], String, Permission.Action[]) Use Admin.hasUserPermissions(String, List) instead.
org.apache.hadoop.hbase.client.BufferedMutatorParams.implementationClassName(String) Since 3.0.0, will be removed in 4.0.0. You can not set it any more as the implementation has to use too many internal stuffs in HBase.
org.apache.hadoop.hbase.client.RegionInfo.isOffline() since 3.0.0 and will be removed in 4.0.0
org.apache.hadoop.hbase.client.RegionInfo.isSplitParent() since 3.0.0 and will be removed in 4.0.0, Use RegionInfo.isSplit() instead.
org.apache.hadoop.hbase.client.AsyncAdmin.mergeRegions(byte[], byte[], boolean) since 2.3.0 and will be removed in 4.0.0.Use AsyncAdmin.mergeRegions(List, boolean) instead.
org.apache.hadoop.hbase.client.Admin.mergeRegionsAsync(byte[], byte[], boolean) since 2.3.0 and will be removed in 4.0.0. Multi-region merge feature is now supported. Use Admin.mergeRegionsAsync(byte[][], boolean) instead.
org.apache.hadoop.hbase.client.Admin.move(byte[], byte[]) since 2.2.0 and will be removed in 4.0.0. Use Admin.move(byte[], ServerName) instead. And if you want to move the region to a random server, please use Admin.move(byte[]).
org.apache.hadoop.hbase.client.BufferedMutatorParams.opertationTimeout(int) Since 2.3.0, will be removed in 4.0.0. Use BufferedMutatorParams.operationTimeout(int)
org.apache.hadoop.hbase.client.BufferedMutatorParams.pool(ExecutorService) Since 3.0.0-alpha-2, will be removed in 4.0.0. You can not set it anymore. BufferedMutator will use Connection's ExecutorService.
org.apache.hadoop.hbase.security.access.AccessControlUtil.revoke(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, String, Permission.Action...) Use Admin.revoke(UserPermission) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.revoke(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, String, String, Permission.Action...) Use Admin.revoke(UserPermission) instead.
org.apache.hadoop.hbase.security.access.AccessControlUtil.revoke(RpcController, AccessControlProtos.AccessControlService.BlockingInterface, String, TableName, byte[], byte[], Permission.Action...) Use Admin.revoke(UserPermission) instead.
org.apache.hadoop.hbase.client.Scan.setAsyncPrefetch(boolean) Since 3.0.0, will be removed in 4.0.0. After building sync client upon async client, the implementation is always 'async prefetch', so this flag is useless now.
org.apache.hadoop.hbase.client.ImmutableScan.setAsyncPrefetch(boolean)
org.apache.hadoop.hbase.client.RegionInfoBuilder.setOffline(boolean)
org.apache.hadoop.hbase.client.BufferedMutator.setOperationTimeout(int) Since 3.0.0, will be removed in 4.0.0. Please set this through the BufferedMutatorParams.
org.apache.hadoop.hbase.client.AsyncAdminBuilder.setRetryPauseForCQTBE(long, TimeUnit) Since 2.5.0, will be removed in 4.0.0. Please use AsyncAdminBuilder.setRetryPauseForServerOverloaded(long, TimeUnit) instead.
org.apache.hadoop.hbase.client.AsyncTableBuilder.setRetryPauseForCQTBE(long, TimeUnit) Since 2.5.0, will be removed in 4.0.0. Please use AsyncTableBuilder.setRetryPauseForServerOverloaded(long, TimeUnit) instead.
org.apache.hadoop.hbase.client.Scan.setRowPrefixFilter(byte[]) since 2.5.0, will be removed in 4.0.0. The name of this method is considered to be confusing as it does not use a Filter but uses setting the startRow and stopRow instead. Use Scan.setStartStopRowForPrefixScan(byte[]) instead.
org.apache.hadoop.hbase.client.BufferedMutator.setRpcTimeout(int) Since 3.0.0, will be removed in 4.0.0. Please set this through the BufferedMutatorParams.
org.apache.hadoop.hbase.client.BufferedMutatorParams.setWriteBufferPeriodicFlushTimerTickMs(long) Since 3.0.0, will be removed in 4.0.0. We use a common timer in the whole client implementation so you can not set it any more.
org.apache.hadoop.hbase.client.AsyncAdmin.unassign(byte[], boolean) since 2.4.0 and will be removed in 4.0.0. Use AsyncAdmin.unassign(byte[]) instead.
org.apache.hadoop.hbase.client.Admin.unassign(byte[], boolean) since 2.4.0 and will be removed in 4.0.0. Use Admin.unassign(byte[]) instead.

Deprecated Constructors

Constructor and Description
org.apache.hadoop.hbase.ipc.ServerTooBusyException(InetSocketAddress, long)
org.apache.hadoop.hbase.client.SnapshotDescription(String, TableName, SnapshotType, String, long, int) since 2.3.0 and will be removed in 4.0.0. Use SnapshotDescription(String, TableName, SnapshotType, String, long, int, Map)