Deprecated List (Apache HBase - Server 2.3.0 API)

Deprecated Interfaces
Interface and Description
org.apache.hadoop.hbase.coprocessor.CoprocessorService Since 2.0. Will be removed in 3.0
org.apache.hadoop.hbase.coprocessor.HasMasterServices Since 2.0.0 to be removed in 3.0.0. The hope is that by 3.0.0 we will not need this facility as CoreCoprocessors are integated into core.
org.apache.hadoop.hbase.coprocessor.HasRegionServerServices Since 2.0.0 to be removed in 3.0.0. The hope is that by 3.0.0 we will not need this facility as CoreCoprocessors are integated into core.
org.apache.hadoop.hbase.util.HbckErrorReporter Since 2.3.0. To be removed in hbase4. Use HBCK2 instead. Remove when `HBaseFsck` is removed.
org.apache.hadoop.hbase.master.procedure.MetaProcedureInterface only used for `RecoverMetaProcedure`. Should be removed along with `RecoverMetaProcedure`.
org.apache.hadoop.hbase.regionserver.RowProcessor As of release 2.0.0, this will be removed in HBase 3.0.0. For customization, use Coprocessors instead.
org.apache.hadoop.hbase.coprocessor.SingletonCoprocessorService Since 2.0. Will be removed in 3.0

Deprecated Classes
Class and Description
org.apache.hadoop.hbase.master.assignment.AssignProcedure Do not use any more.
org.apache.hadoop.hbase.coprocessor.CoprocessorServiceBackwardCompatiblity
org.apache.hadoop.hbase.master.assignment.GCMergedRegionsProcedure 2.3.0 Use `GCMultipleMergedRegionsProcedure`.
org.apache.hadoop.hbase.util.HBaseFsck For removal in hbase-4.0.0. Use HBCK2 instead.
org.apache.hadoop.hbase.mapreduce.LoadIncrementalHFiles As of release 2.0.0, this will be removed in HBase 3.0.0. Use `LoadIncrementalHFiles` instead.
org.apache.hadoop.hbase.tool.LoadIncrementalHFiles since 2.2.0, will be removed in 3.0.0. Use `BulkLoadHFiles` instead. Please rewrite your code if you rely on methods other than the `LoadIncrementalHFiles.run(Map, TableName)` and `LoadIncrementalHFiles.run(String, TableName)`, as all the methods other than them will be removed with no replacement.
org.apache.hadoop.hbase.mapreduce.LoadIncrementalHFiles.LoadQueueItem As of release 2.0.0, this will be removed in HBase 3.0.0. Use `LoadIncrementalHFiles.LoadQueueItem` instead.
org.apache.hadoop.hbase.tool.LoadIncrementalHFiles.LoadQueueItem since 2.2.0 and will be removed in 3.0.0. Use `BulkLoadHFiles` instead.
org.apache.hadoop.hbase.master.MirroringTableStateManager Since 2.0.0. To be removed in 3.0.0.
org.apache.hadoop.hbase.master.assignment.MoveRegionProcedure Do not use any more.
org.apache.hadoop.hbase.util.hbck.OfflineMetaRepair Since 2.0.0. Will be removed in 3.0.0. We've deprecated this tool in hbase-2+ because it destroyed the hbase2 meta table.
org.apache.hadoop.hbase.regionserver.handler.OpenRegionHandler Keep it here only for compatible
org.apache.hadoop.hbase.master.procedure.RecoverMetaProcedure Do not use any more, leave it here only for compatible. The recovery work will be done in `ServerCrashProcedure` directly, and the initial work for meta table will be done by `InitMetaProcedure`.
org.apache.hadoop.hbase.master.assignment.RegionTransitionProcedure Do not use any more.
org.apache.hadoop.hbase.master.cleaner.TimeToLiveProcedureWALCleaner Since 2.3.0, will be removed in 4.0.0. We will not use the procedure wal to store procedure any more.
org.apache.hadoop.hbase.master.assignment.UnassignProcedure Do not use any more.
org.apache.hadoop.hbase.util.ZKDataMigrator Since 2.0.0. To be removed in hbase-3.0.0.

Deprecated Exceptions
Exceptions and Description

org.apache.hadoop.hbase.regionserver.RowTooBigException
since 0.99.0. Use RowTooBigException instead.

Deprecated Exceptions
Exceptions and Description
org.apache.hadoop.hbase.regionserver.RowTooBigException since 0.99.0. Use `RowTooBigException` instead.

Deprecated Fields
Field and Description
org.apache.hadoop.hbase.wal.WALEdit.COMPACTION Since 2.3.0. Make it protected, internal-use only. Use `WALEdit.isCompactionMarker(Cell)`
org.apache.hadoop.hbase.wal.WALEdit.FLUSH Since 2.3.0. Make it protected, internal-use only.
org.apache.hadoop.hbase.wal.WALEdit.METAROW Since 2.3.0. Not used.
org.apache.hadoop.hbase.tool.LoadIncrementalHFiles.NAME since 2.2.0, will be removed in 3.0.0, with no replacement. End user should not depend on this value.
org.apache.hadoop.hbase.regionserver.KeyPrefixRegionSplitPolicy.PREFIX_LENGTH_KEY_DEPRECATED
org.apache.hadoop.hbase.wal.WALEdit.REGION_EVENT Since 2.3.0. Remove. Not for external use. Not used.
org.apache.hadoop.hbase.snapshot.SnapshotDescriptionUtils.SNAPSHOT_TIMEOUT_MILLIS_DEFAULT Use `SnapshotDescriptionUtils.DEFAULT_MAX_WAIT_TIME` instead.
org.apache.hadoop.hbase.snapshot.SnapshotDescriptionUtils.SNAPSHOT_TIMEOUT_MILLIS_KEY Use `SnapshotDescriptionUtils.MASTER_SNAPSHOT_TIMEOUT_MILLIS` instead.

Deprecated Methods
Method and Description
org.apache.hadoop.hbase.ipc.RpcServerInterface.call(BlockingService, Descriptors.MethodDescriptor, Message, CellScanner, long, MonitoredRPCHandler) As of release 1.3, this will be removed in HBase 3.0
org.apache.hadoop.hbase.ipc.RpcServerInterface.call(BlockingService, Descriptors.MethodDescriptor, Message, CellScanner, long, MonitoredRPCHandler, long, int) As of release 2.0, this will be removed in HBase 3.0
org.apache.hadoop.hbase.security.access.AccessController.checkPermissions(RpcController, AccessControlProtos.CheckPermissionsRequest, RpcCallback<AccessControlProtos.CheckPermissionsResponse>) since 2.2.0 and will be removed 4.0.0. Use `Admin.hasUserPermissions(List)` instead.
org.apache.hadoop.hbase.regionserver.FifoRpcSchedulerFactory.create(Configuration, PriorityFunction)
org.apache.hadoop.hbase.regionserver.RpcSchedulerFactory.create(Configuration, PriorityFunction) since 1.0.0.
org.apache.hadoop.hbase.regionserver.SimpleRpcSchedulerFactory.create(Configuration, PriorityFunction) since 1.0.0.
org.apache.hadoop.hbase.coprocessor.ObserverContextImpl.createAndPrepare(E)
org.apache.hadoop.hbase.master.TableStateManager.deleteZooKeeper(TableName) Since 2.0.0. To be removed in hbase-3.0.0.
org.apache.hadoop.hbase.filter.FilterWrapper.filterKeyValue(Cell)
org.apache.hadoop.hbase.ipc.CallRunner.getCall() As of release 2.0, this will be removed in HBase 3.0
org.apache.hadoop.hbase.wal.WAL.getEarliestMemStoreSeqNum(byte[]) Since version 1.2.0. Removing because not used and exposes subtle internal workings. Use `WAL.getEarliestMemStoreSeqNum(byte[], byte[])`
org.apache.hadoop.hbase.master.MasterWalManager.getFailedServersFromLogFolders() With proc-v2, we can record the crash server with procedure store, so do not need to scan the wal directory to find out the splitting wal directory any more. Leave it here only because `RecoverMetaProcedure`(which is also deprecated) uses it.
org.apache.hadoop.hbase.regionserver.RegionServerServices.getFlushPressure()
org.apache.hadoop.hbase.io.hfile.HFileScanner.getKeyString() Since hbase-2.0.0
org.apache.hadoop.hbase.wal.WALKeyImpl.getLogSeqNum() Use `WALKeyImpl.getSequenceId()`
org.apache.hadoop.hbase.wal.WALSplitUtil.getMaxRegionSequenceId(Configuration, RegionInfo, ConcurrentMapUtils.IOExceptionSupplier<FileSystem>, ConcurrentMapUtils.IOExceptionSupplier<FileSystem>) Only for compatibility, will be removed in 4.0.0.
org.apache.hadoop.hbase.regionserver.StoreFile.getModificationTimeStamp() Since 2.0.0. Will be removed in 3.0.0.
org.apache.hadoop.hbase.regionserver.HRegion.getRegionDir(Path, String) For tests only; to be removed.
org.apache.hadoop.hbase.regionserver.StoreFileReader.getScanner(boolean, boolean) since 2.0.0 and will be removed in 3.0.0. Do not write further code which depends on this call. Instead use getStoreFileScanner() which uses the StoreFileScanner class/interface which is the preferred way to scan a store with higher level concepts.
org.apache.hadoop.hbase.regionserver.StoreFileReader.getScanner(boolean, boolean, boolean) since 2.0.0 and will be removed in 3.0.0. Do not write further code which depends on this call. Instead use getStoreFileScanner() which uses the StoreFileScanner class/interface which is the preferred way to scan a store with higher level concepts.
org.apache.hadoop.hbase.regionserver.HStore.getStoreHomedir(Path, RegionInfo, byte[]) Since 05/05/2013, HBase-7808, hbase-1.0.0
org.apache.hadoop.hbase.regionserver.HStore.getStoreHomedir(Path, String, byte[]) Since 05/05/2013, HBase-7808, hbase-1.0.0
org.apache.hadoop.hbase.util.FSUtils.getTableStoreFilePathMap(FileSystem, Path, PathFilter, ExecutorService, HbckErrorReporter) Since 2.3.0. Will be removed in hbase4. Used `FSUtils.getTableStoreFilePathMap(FileSystem, Path, PathFilter, ExecutorService, ProgressReporter)`
org.apache.hadoop.hbase.util.FSUtils.getTableStoreFilePathMap(Map<String, Path>, FileSystem, Path, TableName, PathFilter, ExecutorService, HbckErrorReporter) Since 2.3.0. For removal in hbase4. Use ProgressReporter override instead.
org.apache.hadoop.hbase.replication.regionserver.MetricsSink.getTimeStampOfLastAppliedOp() Since 2.0.0. Will be removed in 3.0.0.
org.apache.hadoop.hbase.replication.regionserver.MetricsSource.getTimeStampOfLastShippedOp() Since 2.0.0. Removed in 3.0.0.
org.apache.hadoop.hbase.security.access.AccessController.getUserPermissions(RpcController, AccessControlProtos.GetUserPermissionsRequest, RpcCallback<AccessControlProtos.GetUserPermissionsResponse>) since 2.2.0 and will be removed in 4.0.0. Use `Admin.getUserPermissions(GetUserPermissionsRequest)` instead.
org.apache.hadoop.hbase.io.hfile.HFileScanner.getValueString() Since hbase-2.0.0
org.apache.hadoop.hbase.security.access.AccessController.grant(RpcController, AccessControlProtos.GrantRequest, RpcCallback<AccessControlProtos.GrantResponse>) since 2.2.0 and will be removed in 4.0.0. Use `Admin.grant(UserPermission, boolean)` instead.
org.apache.hadoop.hbase.security.access.AccessController.hasPermission(RpcController, AccessControlProtos.HasPermissionRequest, RpcCallback<AccessControlProtos.HasPermissionResponse>) since 2.2.0 and will be removed in 4.0.0. Use `Admin.hasUserPermissions(String, List)` instead.
org.apache.hadoop.hbase.regionserver.HRegion.initialize() use HRegion.createHRegion() or HRegion.openHRegion()
org.apache.hadoop.hbase.wal.WALEdit.isMetaEditFamily(byte[]) Since 2.3.0. Do not expose. Make protected.
org.apache.hadoop.hbase.security.token.TokenUtil.obtainToken(Configuration) Since 2.0.0.
org.apache.hadoop.hbase.security.token.TokenUtil.obtainToken(Connection) External users should not use this method. Please post on the HBase dev mailing list if you need this method. Internal HBase code should use `ClientTokenUtil` instead.
org.apache.hadoop.hbase.security.token.TokenUtil.obtainToken(Connection, User) External users should not use this method. Please post on the HBase dev mailing list if you need this method. Internal HBase code should use `ClientTokenUtil` instead.
org.apache.hadoop.hbase.coprocessor.MasterObserver.postCompletedModifyTableAction(ObserverContext<MasterCoprocessorEnvironment>, TableName, TableDescriptor) Since 2.1. Will be removed in 3.0.
org.apache.hadoop.hbase.regionserver.RegionCoprocessorHost.postInstantiateDeleteTracker(DeleteTracker) Since 2.0 with out any replacement and will be removed in 3.0
org.apache.hadoop.hbase.coprocessor.RegionObserver.postInstantiateDeleteTracker(ObserverContext<RegionCoprocessorEnvironment>, DeleteTracker) Since 2.0 with out any replacement and will be removed in 3.0
org.apache.hadoop.hbase.coprocessor.MasterObserver.postModifyNamespace(ObserverContext<MasterCoprocessorEnvironment>, NamespaceDescriptor) Since 2.1. Will be removed in 3.0.
org.apache.hadoop.hbase.coprocessor.MasterObserver.postModifyTable(ObserverContext<MasterCoprocessorEnvironment>, TableName, TableDescriptor) Since 2.1. Will be removed in 3.0.
org.apache.hadoop.hbase.coprocessor.RegionObserver.postMutationBeforeWAL(ObserverContext<RegionCoprocessorEnvironment>, RegionObserver.MutationType, Mutation, Cell, Cell) since 2.2.0 and will be removedin 4.0.0. Use `RegionObserver.postIncrementBeforeWAL(ObserverContext, Mutation, List)` or `RegionObserver.postAppendBeforeWAL(ObserverContext, Mutation, List)` instead.
org.apache.hadoop.hbase.coprocessor.RegionServerObserver.postReplicateLogEntries(ObserverContext<RegionServerCoprocessorEnvironment>) As of release 2.0.0 with out any replacement. This is maintained for internal usage by AccessController. Do not use these hooks in custom co-processors.
org.apache.hadoop.hbase.coprocessor.RegionObserver.postStoreFileReaderOpen(ObserverContext<RegionCoprocessorEnvironment>, FileSystem, Path, FSDataInputStreamWrapper, long, CacheConfig, Reference, StoreFileReader) For Phoenix only, StoreFileReader is not a stable interface.
org.apache.hadoop.hbase.regionserver.RegionCoprocessorHost.postWALRestore(RegionInfo, WALKey, WALEdit) Since hbase-2.0.0. No replacement. To be removed in hbase-3.0.0 and replaced with something that doesn't expose IntefaceAudience.Private classes.
org.apache.hadoop.hbase.coprocessor.WALObserver.postWALWrite(ObserverContext<? extends WALCoprocessorEnvironment>, RegionInfo, WALKey, WALEdit) Since hbase-2.0.0. To be replaced with an alternative that does not expose InterfaceAudience classes such as WALKey and WALEdit. Will be removed in hbase-3.0.0.
org.apache.hadoop.hbase.coprocessor.MasterObserver.preModifyNamespace(ObserverContext<MasterCoprocessorEnvironment>, NamespaceDescriptor) Since 2.1. Will be removed in 3.0.
org.apache.hadoop.hbase.coprocessor.MasterObserver.preModifyTable(ObserverContext<MasterCoprocessorEnvironment>, TableName, TableDescriptor) Since 2.1. Will be removed in 3.0.
org.apache.hadoop.hbase.coprocessor.MasterObserver.preModifyTableAction(ObserverContext<MasterCoprocessorEnvironment>, TableName, TableDescriptor) Since 2.1. Will be removed in 3.0.
org.apache.hadoop.hbase.regionserver.RegionCoprocessorHost.prePrepareTimeStampForDeleteVersion(Mutation, Cell, byte[], Get) In hbase-2.0.0. Will be removed in hbase-3.0.0. Added explicitly for a single Coprocessor for its needs only. Will be removed.
org.apache.hadoop.hbase.coprocessor.RegionObserver.prePrepareTimeStampForDeleteVersion(ObserverContext<RegionCoprocessorEnvironment>, Mutation, Cell, byte[], Get) Since hbase-2.0.0. No replacement. To be removed in hbase-3.0.0 and replaced with something that doesn't expose IntefaceAudience.Private classes.
org.apache.hadoop.hbase.coprocessor.RegionServerObserver.preReplicateLogEntries(ObserverContext<RegionServerCoprocessorEnvironment>) As of release 2.0.0 with out any replacement. This is maintained for internal usage by AccessController. Do not use these hooks in custom co-processors.
org.apache.hadoop.hbase.coprocessor.RegionObserver.preStoreFileReaderOpen(ObserverContext<RegionCoprocessorEnvironment>, FileSystem, Path, FSDataInputStreamWrapper, long, CacheConfig, Reference, StoreFileReader) For Phoenix only, StoreFileReader is not a stable interface.
org.apache.hadoop.hbase.regionserver.RegionCoprocessorHost.preWALRestore(RegionInfo, WALKey, WALEdit) Since hbase-2.0.0. No replacement. To be removed in hbase-3.0.0 and replaced with something that doesn't expose IntefaceAudience.Private classes.
org.apache.hadoop.hbase.coprocessor.WALObserver.preWALWrite(ObserverContext<? extends WALCoprocessorEnvironment>, RegionInfo, WALKey, WALEdit) Since hbase-2.0.0. To be replaced with an alternative that does not expose InterfaceAudience classes such as WALKey and WALEdit. Will be removed in hbase-3.0.0.
org.apache.hadoop.hbase.regionserver.Region.processRowsWithLocks(RowProcessor<?, ?>) As of release 2.0.0, this will be removed in HBase 3.0.0. For customization, use Coprocessors instead.
org.apache.hadoop.hbase.regionserver.Region.processRowsWithLocks(RowProcessor<?, ?>, long, long) As of release 2.0.0, this will be removed in HBase 3.0.0. For customization, use Coprocessors instead.
org.apache.hadoop.hbase.regionserver.Region.processRowsWithLocks(RowProcessor<?, ?>, long, long, long) As of release 2.0.0, this will be removed in HBase 3.0.0. For customization, use Coprocessors instead.
org.apache.hadoop.hbase.util.ZKDataMigrator.queryForTableStates(ZKWatcher) Since 2.0.0. To be removed in hbase-3.0.0.
org.apache.hadoop.hbase.io.Reference.readFields(DataInput) Writables are going away. Use the pb serialization methods instead. Remove in a release after 0.96 goes out. This is here only to migrate old Reference files written with Writables before 0.96.
org.apache.hadoop.hbase.security.access.AccessController.revoke(RpcController, AccessControlProtos.RevokeRequest, RpcCallback<AccessControlProtos.RevokeResponse>) since 2.2.0 and will be removed in 4.0.0. Use `Admin.revoke(UserPermission)` instead.
org.apache.hadoop.hbase.wal.WALKeyImpl.setCompressionContext(CompressionContext) deparcated since hbase 2.1.0
org.apache.hadoop.hbase.wal.WAL.Entry.setCompressionContext(CompressionContext) deparcated since hbase 2.1.0
org.apache.hadoop.hbase.security.token.TokenUtil.toToken(AuthenticationProtos.Token) External users should not use this method. Please post on the HBase dev mailing list if you need this method. Internal HBase code should use `ClientTokenUtil` instead.
org.apache.hadoop.hbase.security.token.TokenUtil.toToken(Token<AuthenticationTokenIdentifier>) External users should not use this method. Please post on the HBase dev mailing list if you need this method. Internal HBase code should use `ClientTokenUtil` instead.
org.apache.hadoop.hbase.tool.LoadIncrementalHFiles.tryAtomicRegionLoad(ClientServiceCallable<byte[]>, TableName, byte[], Collection<LoadIncrementalHFiles.LoadQueueItem>) as of release 2.3.0. Use `BulkLoadHFiles` instead.
org.apache.hadoop.hbase.tool.LoadIncrementalHFiles.tryAtomicRegionLoad(Connection, TableName, byte[], Collection<LoadIncrementalHFiles.LoadQueueItem>, boolean) as of release 2.3.0. Use `BulkLoadHFiles` instead.
org.apache.hadoop.hbase.master.procedure.MasterProcedureScheduler.waitMetaExclusiveLock(Procedure<?>) only used for `RecoverMetaProcedure`. Should be removed along with `RecoverMetaProcedure`.
org.apache.hadoop.hbase.master.procedure.MasterProcedureScheduler.wakeMetaExclusiveLock(Procedure<?>) only used for `RecoverMetaProcedure`. Should be removed along with `RecoverMetaProcedure`.

Deprecated Constructors
Constructor and Description
org.apache.hadoop.hbase.regionserver.HRegion(Path, WAL, FileSystem, Configuration, RegionInfo, TableDescriptor, RegionServerServices) Use other constructors.
org.apache.hadoop.hbase.io.Reference() need by pb serialization
org.apache.hadoop.hbase.wal.WALEdit(boolean) since 2.0.1 and will be removed in 4.0.0. Use `WALEdit.WALEdit(int, boolean)` instead.
org.apache.hadoop.hbase.wal.WALEdit(int) since 2.0.1 and will be removed in 4.0.0. Use `WALEdit.WALEdit(int, boolean)` instead.

Deprecated API

Contents