org.apache.hadoop.hbase.client

类 HTable

java.lang.Object

org.apache.hadoop.hbase.client.HTable

所有已实现的接口:

Closeable, AutoCloseable, Table

@InterfaceAudience.Private
 @InterfaceStability.Stable
public class HTable
extends Object
implements Table

An implementation of Table. Used to communicate with a single HBase table. Lightweight. Get as needed and just close when done. Instances of this class SHOULD NOT be constructed directly. Obtain an instance via Connection. See ConnectionFactory class comment for an example of how.

This class is thread safe since 2.0.0 if not invoking any of the setter methods. All setters are moved into TableBuilder and reserved here only for keeping backward compatibility, and TODO will be removed soon.

HTable is no longer a client API. Use Table instead. It is marked InterfaceAudience.Private indicating that this is an HBase-internal class as defined in Hadoop Interface Classification There are no guarantees for backwards source / binary compatibility and methods or class can change or go away without deprecation.

另请参阅:

Table, Admin, Connection, ConnectionFactory

嵌套类概要

从接口继承的嵌套类/接口 org.apache.hadoop.hbase.client.Table

Table.CheckAndMutateBuilder

构造器概要

构造器

限定符	构造器和说明
protected	HTable(org.apache.hadoop.hbase.client.ConnectionImplementation connection, org.apache.hadoop.hbase.client.TableBuilderBase builder, RpcRetryingCallerFactory rpcCallerFactory, RpcControllerFactory rpcControllerFactory, ExecutorService pool) Creates an object to access a HBase table.

方法概要

限定符和类型	方法和说明
Result	append(Append append) Appends values to one or more columns within a single row.
void	batch(List<? extends Row> actions, Object[] results) Method that does a batch call on Deletes, Gets, Puts, Increments, Appends, RowMutations.
void	batch(List<? extends Row> actions, Object[] results, int rpcTimeout)
<R> void	batchCallback(List<? extends Row> actions, Object[] results, Batch.Callback<R> callback) Same as Table.batch(List, Object[]), but with a callback.
<R extends com.google.protobuf.Message> Map<byte[],R>	batchCoprocessorService(com.google.protobuf.Descriptors.MethodDescriptor methodDescriptor, com.google.protobuf.Message request, byte[] startKey, byte[] endKey, R responsePrototype) Creates an instance of the given Service subclass for each table region spanning the range from the startKey row to endKey row (inclusive), all the invocations to the same region server will be batched into one call.
<R extends com.google.protobuf.Message> void	batchCoprocessorService(com.google.protobuf.Descriptors.MethodDescriptor methodDescriptor, com.google.protobuf.Message request, byte[] startKey, byte[] endKey, R responsePrototype, Batch.Callback<R> callback) Creates an instance of the given Service subclass for each table region spanning the range from the startKey row to endKey row (inclusive), all the invocations to the same region server will be batched into one call.
boolean	checkAndDelete(byte[] row, byte[] family, byte[] qualifier, byte[] value, Delete delete) 已过时。
boolean	checkAndDelete(byte[] row, byte[] family, byte[] qualifier, CompareFilter.CompareOp compareOp, byte[] value, Delete delete) 已过时。
boolean	checkAndDelete(byte[] row, byte[] family, byte[] qualifier, CompareOperator op, byte[] value, Delete delete) 已过时。
Table.CheckAndMutateBuilder	checkAndMutate(byte[] row, byte[] family) Atomically checks if a row/family/qualifier value matches the expected value.
boolean	checkAndMutate(byte[] row, byte[] family, byte[] qualifier, CompareFilter.CompareOp compareOp, byte[] value, RowMutations rm) 已过时。
boolean	checkAndMutate(byte[] row, byte[] family, byte[] qualifier, CompareOperator op, byte[] value, RowMutations rm) 已过时。
boolean	checkAndPut(byte[] row, byte[] family, byte[] qualifier, byte[] value, Put put) 已过时。
boolean	checkAndPut(byte[] row, byte[] family, byte[] qualifier, CompareFilter.CompareOp compareOp, byte[] value, Put put) 已过时。
boolean	checkAndPut(byte[] row, byte[] family, byte[] qualifier, CompareOperator op, byte[] value, Put put) 已过时。
void	clearRegionCache() Explicitly clears the region cache to fetch the latest value from META.
void	close() Releases any resources held or pending changes in internal buffers.
CoprocessorRpcChannel	coprocessorService(byte[] row) Creates and returns a RpcChannel instance connected to the table region containing the specified row.
<T extends com.google.protobuf.Service,R> Map<byte[],R>	coprocessorService(Class<T> service, byte[] startKey, byte[] endKey, Batch.Call<T,R> callable) Creates an instance of the given Service subclass for each table region spanning the range from the startKey row to endKey row (inclusive), and invokes the passed Batch.Call.call(T) method with each Service instance.
<T extends com.google.protobuf.Service,R> void	coprocessorService(Class<T> service, byte[] startKey, byte[] endKey, Batch.Call<T,R> callable, Batch.Callback<R> callback) Creates an instance of the given Service subclass for each table region spanning the range from the startKey row to endKey row (inclusive), and invokes the passed Batch.Call.call(T) method with each Service instance.
void	delete(Delete delete) Deletes the specified cells/row.
void	delete(List<Delete> deletes) Batch Deletes the specified cells/rows from the table.
static <R> void	doBatchWithCallback(List<? extends Row> actions, Object[] results, Batch.Callback<R> callback, ClusterConnection connection, ExecutorService pool, TableName tableName)
boolean	exists(Get get) Test for the existence of columns in the table, as specified by the Get.
boolean[]	exists(List<Get> gets) Test for the existence of columns in the table, as specified by the Gets.
Result	get(Get get) Extracts certain cells from a given row.
Result[]	get(List<Get> gets) Extracts specified cells from the given rows, as a batch.
org.apache.hadoop.conf.Configuration	getConfiguration() Returns the Configuration object used by this instance.
protected Connection	getConnection() INTERNAL Used by unit tests and tools to do low-level manipulations.
static ThreadPoolExecutor	getDefaultExecutor(org.apache.hadoop.conf.Configuration conf)
TableDescriptor	getDescriptor() Gets the table descriptor for this table.
static int	getMaxKeyValueSize(org.apache.hadoop.conf.Configuration conf)
TableName	getName() Gets the fully qualified table name instance of this table.
int	getOperationTimeout() 已过时。
long	getOperationTimeout(TimeUnit unit) Get timeout of each operation in Table instance.
int	getReadRpcTimeout() 已过时。
long	getReadRpcTimeout(TimeUnit unit) Get timeout of each rpc read request in this Table instance.
RegionLocator	getRegionLocator()
int	getRpcTimeout() 已过时。
long	getRpcTimeout(TimeUnit unit) Get timeout of each rpc request in this Table instance.
ResultScanner	getScanner(byte[] family) The underlying HTable must not be closed.
ResultScanner	getScanner(byte[] family, byte[] qualifier) The underlying HTable must not be closed.
ResultScanner	getScanner(Scan scan) The underlying HTable must not be closed.
HTableDescriptor	getTableDescriptor() 已过时。
int	getWriteRpcTimeout() 已过时。
long	getWriteRpcTimeout(TimeUnit unit) Get timeout of each rpc write request in this Table instance.
Result	increment(Increment increment) Increments one or more columns within a single row.
long	incrementColumnValue(byte[] row, byte[] family, byte[] qualifier, long amount) See Table.incrementColumnValue(byte[], byte[], byte[], long, Durability) The Durability is defaulted to Durability.SYNC_WAL.
long	incrementColumnValue(byte[] row, byte[] family, byte[] qualifier, long amount, Durability durability) Atomically increments a column value.
void	mutateRow(RowMutations rm) Performs multiple mutations atomically on a single row.
<R> void	processBatchCallback(List<? extends Row> list, Object[] results, Batch.Callback<R> callback) Process a mixed batch of Get, Put and Delete actions.
void	put(List<Put> puts) Batch puts the specified data into the table.
void	put(Put put) Puts some data in the table.
void	setOperationTimeout(int operationTimeout) 已过时。
void	setReadRpcTimeout(int readRpcTimeout) 已过时。
void	setRpcTimeout(int rpcTimeout) 已过时。
void	setWriteRpcTimeout(int writeRpcTimeout) 已过时。
String	toString()

从类继承的方法 java.lang.Object

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

从接口继承的方法 org.apache.hadoop.hbase.client.Table

existsAll

构造器详细资料

HTable

@InterfaceAudience.Private
protected HTable(org.apache.hadoop.hbase.client.ConnectionImplementation connection,
                                            org.apache.hadoop.hbase.client.TableBuilderBase builder,
                                            RpcRetryingCallerFactory rpcCallerFactory,
                                            RpcControllerFactory rpcControllerFactory,
                                            ExecutorService pool)

Creates an object to access a HBase table. Used by HBase internally. DO NOT USE. See ConnectionFactory class comment for how to get a Table instance (use Table instead of HTable).

参数:

connection - Connection to be used.

builder - The table builder

rpcCallerFactory - The RPC caller factory

rpcControllerFactory - The RPC controller factory

pool - ExecutorService to be used.

方法详细资料

getDefaultExecutor

@InterfaceAudience.Private
public static ThreadPoolExecutor getDefaultExecutor(org.apache.hadoop.conf.Configuration conf)

getMaxKeyValueSize

public static int getMaxKeyValueSize(org.apache.hadoop.conf.Configuration conf)

返回:

maxKeyValueSize from configuration.

getConfiguration

public org.apache.hadoop.conf.Configuration getConfiguration()

从接口复制的说明: Table

Returns the Configuration object used by this instance.

The reference returned is not a copy, so any change made to it will affect this instance.

指定者:

getConfiguration 在接口中 Table

getName

public TableName getName()

从接口复制的说明: Table

Gets the fully qualified table name instance of this table.

指定者:

getName 在接口中 Table

getConnection

protected Connection getConnection()

INTERNAL Used by unit tests and tools to do low-level manipulations.

返回:

A Connection instance.

getTableDescriptor

@Deprecated
public HTableDescriptor getTableDescriptor()
                                                throws IOException

已过时。

从接口复制的说明: Table

Gets the table descriptor for this table.

指定者:

getTableDescriptor 在接口中 Table

抛出:

IOException - if a remote or network exception occurs.

getDescriptor

public TableDescriptor getDescriptor()
                              throws IOException

从接口复制的说明: Table

Gets the table descriptor for this table.

指定者:

getDescriptor 在接口中 Table

抛出:

IOException - if a remote or network exception occurs.

getScanner

public ResultScanner getScanner(Scan scan)
                         throws IOException

The underlying HTable must not be closed. Table.getScanner(Scan) has other usage details.

指定者:

getScanner 在接口中 Table

参数:

scan - A configured Scan object.

返回:

A scanner.

抛出:

IOException - if a remote or network exception occurs.

getScanner

public ResultScanner getScanner(byte[] family)
                         throws IOException

The underlying HTable must not be closed. Table.getScanner(byte[]) has other usage details.

指定者:

getScanner 在接口中 Table

参数:

family - The column family to scan.

返回:

A scanner.

抛出:

IOException - if a remote or network exception occurs.

getScanner

public ResultScanner getScanner(byte[] family,
                                byte[] qualifier)
                         throws IOException

The underlying HTable must not be closed. Table.getScanner(byte[], byte[]) has other usage details.

指定者:

getScanner 在接口中 Table

参数:

family - The column family to scan.

qualifier - The column qualifier to scan.

返回:

A scanner.

抛出:

IOException - if a remote or network exception occurs.

get

public Result get(Get get)
           throws IOException

从接口复制的说明: Table

Extracts certain cells from a given row.

指定者:

get 在接口中 Table

参数:

get - The object that specifies what data to fetch and from which row.

返回:

The data coming from the specified row, if it exists. If the row specified doesn't exist, the Result instance returned won't contain any KeyValue, as indicated by Result.isEmpty().

抛出:

IOException - if a remote or network exception occurs.

get

public Result[] get(List<Get> gets)
             throws IOException

从接口复制的说明: Table

Extracts specified cells from the given rows, as a batch.

指定者:

get 在接口中 Table

参数:

gets - The objects that specify what data to fetch and from which rows.

返回:

The data coming from the specified rows, if it exists. If the row specified doesn't exist, the Result instance returned won't contain any Cells, as indicated by Result.isEmpty(). If there are any failures even after retries, there will be a null in the results' array for those Gets, AND an exception will be thrown. The ordering of the Result array corresponds to the order of the list of passed in Gets.

抛出:

IOException - if a remote or network exception occurs.

batch

public void batch(List<? extends Row> actions,
                  Object[] results)
           throws InterruptedException,
                  IOException

从接口复制的说明: Table

Method that does a batch call on Deletes, Gets, Puts, Increments, Appends, RowMutations. The ordering of execution of the actions is not defined. Meaning if you do a Put and a Get in the same Table.batch(java.util.List<? extends org.apache.hadoop.hbase.client.Row>, java.lang.Object[]) call, you will not necessarily be guaranteed that the Get returns what the Put had put.

指定者:

batch 在接口中 Table

参数:

actions - list of Get, Put, Delete, Increment, Append, RowMutations.

results - Empty Object[], same size as actions. Provides access to partial results, in case an exception is thrown. A null in the result array means that the call for that action failed, even after retries. The order of the objects in the results array corresponds to the order of actions in the request list.

抛出:

IOException

InterruptedException

batch

public void batch(List<? extends Row> actions,
                  Object[] results,
                  int rpcTimeout)
           throws InterruptedException,
                  IOException

抛出:

InterruptedException

IOException

batchCallback

public <R> void batchCallback(List<? extends Row> actions,
                              Object[] results,
                              Batch.Callback<R> callback)
                       throws IOException,
                              InterruptedException

从接口复制的说明: Table

Same as Table.batch(List, Object[]), but with a callback.

指定者:

batchCallback 在接口中 Table

抛出:

IOException

InterruptedException

doBatchWithCallback

public static <R> void doBatchWithCallback(List<? extends Row> actions,
                                           Object[] results,
                                           Batch.Callback<R> callback,
                                           ClusterConnection connection,
                                           ExecutorService pool,
                                           TableName tableName)
                                    throws InterruptedIOException,
                                           RetriesExhaustedWithDetailsException

抛出:

InterruptedIOException

RetriesExhaustedWithDetailsException

delete

public void delete(Delete delete)
            throws IOException

从接口复制的说明: Table

Deletes the specified cells/row.

指定者:

delete 在接口中 Table

参数:

delete - The object that specifies what to delete.

抛出:

IOException - if a remote or network exception occurs.

delete

public void delete(List<Delete> deletes)
            throws IOException

从接口复制的说明: Table

Batch Deletes the specified cells/rows from the table.

If a specified row does not exist, Delete will report as though sucessful delete; no exception will be thrown. If there are any failures even after retries, a RetriesExhaustedWithDetailsException will be thrown. RetriesExhaustedWithDetailsException contains lists of failed Deletes and corresponding remote exceptions.

指定者:

delete 在接口中 Table

参数:

deletes - List of things to delete. The input list gets modified by this method. All successfully applied Deletes in the list are removed (in particular it gets re-ordered, so the order in which the elements are inserted in the list gives no guarantee as to the order in which the Deletes are executed).

抛出:

IOException - if a remote or network exception occurs. In that case the deletes argument will contain the Delete instances that have not be successfully applied.

put

public void put(Put put)
         throws IOException

从接口复制的说明: Table

Puts some data in the table.

指定者:

put 在接口中 Table

参数:

put - The data to put.

抛出:

IOException - if a remote or network exception occurs.

put

public void put(List<Put> puts)
         throws IOException

从接口复制的说明: Table

Batch puts the specified data into the table.

This can be used for group commit, or for submitting user defined batches. Before sending a batch of mutations to the server, the client runs a few validations on the input list. If an error is found, for example, a mutation was supplied but was missing it's column an IllegalArgumentException will be thrown and no mutations will be applied. If there are any failures even after retries, a RetriesExhaustedWithDetailsException will be thrown. RetriesExhaustedWithDetailsException contains lists of failed mutations and corresponding remote exceptions. The ordering of mutations and exceptions in the encapsulating exception corresponds to the order of the input list of Put requests.

指定者:

put 在接口中 Table

参数:

puts - The list of mutations to apply.

抛出:

IOException - if a remote or network exception occurs.

mutateRow

public void mutateRow(RowMutations rm)
               throws IOException

从接口复制的说明: Table

Performs multiple mutations atomically on a single row. Currently Put and Delete are supported.

指定者:

mutateRow 在接口中 Table

参数:

rm - object that specifies the set of mutations to perform atomically

抛出:

IOException

append

public Result append(Append append)
              throws IOException

从接口复制的说明: Table

Appends values to one or more columns within a single row.

This operation guaranteed atomicity to readers. Appends are done under a single row lock, so write operations to a row are synchronized, and readers are guaranteed to see this operation fully completed.

指定者:

append 在接口中 Table

参数:

append - object that specifies the columns and values to be appended

返回:

values of columns after the append operation (maybe null)

抛出:

IOException - e

increment

public Result increment(Increment increment)
                 throws IOException

从接口复制的说明: Table

Increments one or more columns within a single row.

This operation ensures atomicity to readers. Increments are done under a single row lock, so write operations to a row are synchronized, and readers are guaranteed to see this operation fully completed.

指定者:

increment 在接口中 Table

参数:

increment - object that specifies the columns and amounts to be used for the increment operations

返回:

values of columns after the increment

抛出:

IOException - e

incrementColumnValue

public long incrementColumnValue(byte[] row,
                                 byte[] family,
                                 byte[] qualifier,
                                 long amount)
                          throws IOException

从接口复制的说明: Table

See Table.incrementColumnValue(byte[], byte[], byte[], long, Durability)

The Durability is defaulted to Durability.SYNC_WAL.

指定者:

incrementColumnValue 在接口中 Table

参数:

row - The row that contains the cell to increment.

family - The column family of the cell to increment.

qualifier - The column qualifier of the cell to increment.

amount - The amount to increment the cell with (or decrement, if the amount is negative).

返回:

The new value, post increment.

抛出:

IOException - if a remote or network exception occurs.

incrementColumnValue

public long incrementColumnValue(byte[] row,
                                 byte[] family,
                                 byte[] qualifier,
                                 long amount,
                                 Durability durability)
                          throws IOException

从接口复制的说明: Table

Atomically increments a column value. If the column value already exists and is not a big-endian long, this could throw an exception. If the column value does not yet exist it is initialized to amount and written to the specified column.

Setting durability to Durability.SKIP_WAL means that in a fail scenario you will lose any increments that have not been flushed.

指定者:

incrementColumnValue 在接口中 Table

参数:

row - The row that contains the cell to increment.

family - The column family of the cell to increment.

qualifier - The column qualifier of the cell to increment.

amount - The amount to increment the cell with (or decrement, if the amount is negative).

durability - The persistence guarantee for this increment.

返回:

The new value, post increment.

抛出:

IOException - if a remote or network exception occurs.

checkAndPut

@Deprecated
public boolean checkAndPut(byte[] row,
                                       byte[] family,
                                       byte[] qualifier,
                                       byte[] value,
                                       Put put)
                                throws IOException

已过时。

从接口复制的说明: Table

Atomically checks if a row/family/qualifier value matches the expected value. If it does, it adds the put. If the passed value is null, the check is for the lack of column (ie: non-existance)

指定者:

checkAndPut 在接口中 Table

参数:

row - to check

family - column family to check

qualifier - column qualifier to check

value - the expected value

put - data to put if check succeeds

返回:

true if the new put was executed, false otherwise

抛出:

IOException - e

checkAndPut

@Deprecated
public boolean checkAndPut(byte[] row,
                                       byte[] family,
                                       byte[] qualifier,
                                       CompareFilter.CompareOp compareOp,
                                       byte[] value,
                                       Put put)
                                throws IOException

已过时。

从接口复制的说明: Table

Atomically checks if a row/family/qualifier value matches the expected value. If it does, it adds the put. If the passed value is null, the check is for the lack of column (ie: non-existence) The expected value argument of this call is on the left and the current value of the cell is on the right side of the comparison operator. Ie. eg. GREATER operator means expected value > existing <=> add the put.

指定者:

checkAndPut 在接口中 Table

参数:

row - to check

family - column family to check

qualifier - column qualifier to check

compareOp - comparison operator to use

value - the expected value

put - data to put if check succeeds

返回:

true if the new put was executed, false otherwise

抛出:

IOException - e

checkAndPut

@Deprecated
public boolean checkAndPut(byte[] row,
                                       byte[] family,
                                       byte[] qualifier,
                                       CompareOperator op,
                                       byte[] value,
                                       Put put)
                                throws IOException

已过时。

从接口复制的说明: Table

Atomically checks if a row/family/qualifier value matches the expected value. If it does, it adds the put. If the passed value is null, the check is for the lack of column (ie: non-existence) The expected value argument of this call is on the left and the current value of the cell is on the right side of the comparison operator. Ie. eg. GREATER operator means expected value > existing <=> add the put.

指定者:

checkAndPut 在接口中 Table

参数:

row - to check

family - column family to check

qualifier - column qualifier to check

op - comparison operator to use

value - the expected value

put - data to put if check succeeds

返回:

true if the new put was executed, false otherwise

抛出:

IOException - e

checkAndDelete

@Deprecated
public boolean checkAndDelete(byte[] row,
                                          byte[] family,
                                          byte[] qualifier,
                                          byte[] value,
                                          Delete delete)
                                   throws IOException

已过时。

从接口复制的说明: Table

Atomically checks if a row/family/qualifier value matches the expected value. If it does, it adds the delete. If the passed value is null, the check is for the lack of column (ie: non-existance)

指定者:

checkAndDelete 在接口中 Table

参数:

row - to check

family - column family to check

qualifier - column qualifier to check

value - the expected value

delete - data to delete if check succeeds

返回:

true if the new delete was executed, false otherwise

抛出:

IOException - e

checkAndDelete

@Deprecated
public boolean checkAndDelete(byte[] row,
                                          byte[] family,
                                          byte[] qualifier,
                                          CompareFilter.CompareOp compareOp,
                                          byte[] value,
                                          Delete delete)
                                   throws IOException

已过时。

从接口复制的说明: Table

Atomically checks if a row/family/qualifier value matches the expected value. If it does, it adds the delete. If the passed value is null, the check is for the lack of column (ie: non-existence) The expected value argument of this call is on the left and the current value of the cell is on the right side of the comparison operator. Ie. eg. GREATER operator means expected value > existing <=> add the delete.

指定者:

checkAndDelete 在接口中 Table

参数:

row - to check

family - column family to check

qualifier - column qualifier to check

compareOp - comparison operator to use

value - the expected value

delete - data to delete if check succeeds

返回:

true if the new delete was executed, false otherwise

抛出:

IOException - e

checkAndDelete

@Deprecated
public boolean checkAndDelete(byte[] row,
                                          byte[] family,
                                          byte[] qualifier,
                                          CompareOperator op,
                                          byte[] value,
                                          Delete delete)
                                   throws IOException

已过时。

从接口复制的说明: Table

Atomically checks if a row/family/qualifier value matches the expected value. If it does, it adds the delete. If the passed value is null, the check is for the lack of column (ie: non-existence) The expected value argument of this call is on the left and the current value of the cell is on the right side of the comparison operator. Ie. eg. GREATER operator means expected value > existing <=> add the delete.

指定者:

checkAndDelete 在接口中 Table

参数:

row - to check

family - column family to check

qualifier - column qualifier to check

op - comparison operator to use

value - the expected value

delete - data to delete if check succeeds

返回:

true if the new delete was executed, false otherwise

抛出:

IOException - e

checkAndMutate

public Table.CheckAndMutateBuilder checkAndMutate(byte[] row,
                                                  byte[] family)

从接口复制的说明: Table

Atomically checks if a row/family/qualifier value matches the expected value. If it does, it adds the Put/Delete/RowMutations.

Use the returned Table.CheckAndMutateBuilder to construct your request and then execute it. This is a fluent style API, the code is like:

 
 table.checkAndMutate(row, family).qualifier(qualifier).ifNotExists().thenPut(put);
 
 

指定者:

checkAndMutate 在接口中 Table

checkAndMutate

@Deprecated
public boolean checkAndMutate(byte[] row,
                                          byte[] family,
                                          byte[] qualifier,
                                          CompareFilter.CompareOp compareOp,
                                          byte[] value,
                                          RowMutations rm)
                                   throws IOException

已过时。

从接口复制的说明: Table

Atomically checks if a row/family/qualifier value matches the expected value. If it does, it performs the row mutations. If the passed value is null, the check is for the lack of column (ie: non-existence) The expected value argument of this call is on the left and the current value of the cell is on the right side of the comparison operator. Ie. eg. GREATER operator means expected value > existing <=> perform row mutations.

指定者:

checkAndMutate 在接口中 Table

参数:

row - to check

family - column family to check

qualifier - column qualifier to check

compareOp - the comparison operator

value - the expected value

rm - mutations to perform if check succeeds

返回:

true if the new put was executed, false otherwise

抛出:

IOException - e

checkAndMutate

@Deprecated
public boolean checkAndMutate(byte[] row,
                                          byte[] family,
                                          byte[] qualifier,
                                          CompareOperator op,
                                          byte[] value,
                                          RowMutations rm)
                                   throws IOException

已过时。

从接口复制的说明: Table

Atomically checks if a row/family/qualifier value matches the expected value. If it does, it performs the row mutations. If the passed value is null, the check is for the lack of column (ie: non-existence) The expected value argument of this call is on the left and the current value of the cell is on the right side of the comparison operator. Ie. eg. GREATER operator means expected value > existing <=> perform row mutations.

指定者:

checkAndMutate 在接口中 Table

参数:

row - to check

family - column family to check

qualifier - column qualifier to check

op - the comparison operator

value - the expected value

rm - mutations to perform if check succeeds

返回:

true if the new put was executed, false otherwise

抛出:

IOException - e

exists

public boolean exists(Get get)
               throws IOException

从接口复制的说明: Table

Test for the existence of columns in the table, as specified by the Get.

This will return true if the Get matches one or more keys, false if not.

This is a server-side call so it prevents any data from being transfered to the client.

指定者:

exists 在接口中 Table

参数:

get - the Get

返回:

true if the specified Get matches one or more keys, false if not

抛出:

IOException - e

exists

public boolean[] exists(List<Get> gets)
                 throws IOException

从接口复制的说明: Table

Test for the existence of columns in the table, as specified by the Gets.

This will return an array of booleans. Each value will be true if the related Get matches one or more keys, false if not.

This is a server-side call so it prevents any data from being transferred to the client.

指定者:

exists 在接口中 Table

参数:

gets - the Gets

返回:

Array of boolean. True if the specified Get matches one or more keys, false if not.

抛出:

IOException - e

processBatchCallback

public <R> void processBatchCallback(List<? extends Row> list,
                                     Object[] results,
                                     Batch.Callback<R> callback)
                              throws IOException,
                                     InterruptedException

Process a mixed batch of Get, Put and Delete actions. All actions for a RegionServer are forwarded in one RPC call. Queries are executed in parallel.

参数:

list - The collection of actions.

results - An empty array, same size as list. If an exception is thrown, you can test here for partial results, and to determine which actions processed successfully.

抛出:

IOException - if there are problems talking to META. Per-item exceptions are stored in the results array.

InterruptedException

close

public void close()
           throws IOException

从接口复制的说明: Table

Releases any resources held or pending changes in internal buffers.

指定者:

close 在接口中 Closeable

指定者:

close 在接口中 AutoCloseable

指定者:

close 在接口中 Table

抛出:

IOException - if a remote or network exception occurs.

clearRegionCache

public void clearRegionCache()

Explicitly clears the region cache to fetch the latest value from META. This is a power user function: avoid unless you know the ramifications.

coprocessorService

public CoprocessorRpcChannel coprocessorService(byte[] row)

从接口复制的说明: Table

Creates and returns a RpcChannel instance connected to the table region containing the specified row. The row given does not actually have to exist. Whichever region would contain the row based on start and end keys will be used. Note that the row parameter is also not passed to the coprocessor handler registered for this protocol, unless the row is separately passed as an argument in the service request. The parameter here is only used to locate the region used to handle the call.

The obtained RpcChannel instance can be used to access a published coprocessor Service using standard protobuf service invocations:

 CoprocessorRpcChannel channel = myTable.coprocessorService(rowkey);
 MyService.BlockingInterface service = MyService.newBlockingStub(channel);
 MyCallRequest request = MyCallRequest.newBuilder()
     ...
     .build();
 MyCallResponse response = service.myCall(null, request);
 

指定者:

coprocessorService 在接口中 Table

参数:

row - The row key used to identify the remote region location

返回:

A CoprocessorRpcChannel instance

coprocessorService

public <T extends com.google.protobuf.Service,R> Map<byte[],R> coprocessorService(Class<T> service,
                                                                                  byte[] startKey,
                                                                                  byte[] endKey,
                                                                                  Batch.Call<T,R> callable)
                                                                           throws com.google.protobuf.ServiceException,
                                                                                  Throwable

从接口复制的说明: Table

Creates an instance of the given Service subclass for each table region spanning the range from the startKey row to endKey row (inclusive), and invokes the passed Batch.Call.call(T) method with each Service instance.

指定者:

coprocessorService 在接口中 Table

类型参数:

T - the Service subclass to connect to

R - Return type for the callable parameter's Batch.Call.call(T) method

参数:

service - the protocol buffer Service implementation to call

startKey - start region selection with region containing this row. If null, the selection will start with the first table region.

endKey - select regions up to and including the region containing this row. If null, selection will continue through the last table region.

callable - this instance's Batch.Call.call(T) method will be invoked once per table region, using the Service instance connected to that region.

返回:

a map of result values keyed by region name

抛出:

com.google.protobuf.ServiceException

Throwable

coprocessorService

public <T extends com.google.protobuf.Service,R> void coprocessorService(Class<T> service,
                                                                         byte[] startKey,
                                                                         byte[] endKey,
                                                                         Batch.Call<T,R> callable,
                                                                         Batch.Callback<R> callback)
                                                                  throws com.google.protobuf.ServiceException,
                                                                         Throwable

从接口复制的说明: Table

Creates an instance of the given Service subclass for each table region spanning the range from the startKey row to endKey row (inclusive), and invokes the passed Batch.Call.call(T) method with each Service instance.

The given Batch.Callback.update(byte[],byte[],Object) method will be called with the return value from each region's Batch.Call.call(T) invocation.

指定者:

coprocessorService 在接口中 Table

类型参数:

T - the Service subclass to connect to

R - Return type for the callable parameter's Batch.Call.call(T) method

参数:

service - the protocol buffer Service implementation to call

startKey - start region selection with region containing this row. If null, the selection will start with the first table region.

endKey - select regions up to and including the region containing this row. If null, selection will continue through the last table region.

callable - this instance's Batch.Call.call(T) method will be invoked once per table region, using the Service instance connected to that region.

抛出:

com.google.protobuf.ServiceException

Throwable

getRpcTimeout

public long getRpcTimeout(TimeUnit unit)

从接口复制的说明: Table

Get timeout of each rpc request in this Table instance. It will be overridden by a more specific rpc timeout config such as readRpcTimeout or writeRpcTimeout.

指定者:

getRpcTimeout 在接口中 Table

参数:

unit - the unit of time the timeout to be represented in

返回:

rpc timeout in the specified time unit

另请参阅:

Table.getReadRpcTimeout(TimeUnit), Table.getWriteRpcTimeout(TimeUnit)

getRpcTimeout

@Deprecated
public int getRpcTimeout()

已过时。

从接口复制的说明: Table

Get timeout (millisecond) of each rpc request in this Table instance.

指定者:

getRpcTimeout 在接口中 Table

返回:

Currently configured read timeout

setRpcTimeout

@Deprecated
public void setRpcTimeout(int rpcTimeout)

已过时。

从接口复制的说明: Table

Set timeout (millisecond) of each rpc request in operations of this Table instance, will override the value of hbase.rpc.timeout in configuration. If a rpc request waiting too long, it will stop waiting and send a new request to retry until retries exhausted or operation timeout reached.

NOTE: This will set both the read and write timeout settings to the provided value.

指定者:

setRpcTimeout 在接口中 Table

参数:

rpcTimeout - the timeout of each rpc request in millisecond.

getReadRpcTimeout

public long getReadRpcTimeout(TimeUnit unit)

从接口复制的说明: Table

Get timeout of each rpc read request in this Table instance.

指定者:

getReadRpcTimeout 在接口中 Table

参数:

unit - the unit of time the timeout to be represented in

返回:

read rpc timeout in the specified time unit

getReadRpcTimeout

@Deprecated
public int getReadRpcTimeout()

已过时。

从接口复制的说明: Table

Get timeout (millisecond) of each rpc read request in this Table instance.

指定者:

getReadRpcTimeout 在接口中 Table

setReadRpcTimeout

@Deprecated
public void setReadRpcTimeout(int readRpcTimeout)

已过时。

从接口复制的说明: Table

Set timeout (millisecond) of each rpc read request in operations of this Table instance, will override the value of hbase.rpc.read.timeout in configuration. If a rpc read request waiting too long, it will stop waiting and send a new request to retry until retries exhausted or operation timeout reached.

指定者:

setReadRpcTimeout 在接口中 Table

参数:

readRpcTimeout - the timeout for read rpc request in milliseconds

getWriteRpcTimeout

public long getWriteRpcTimeout(TimeUnit unit)

从接口复制的说明: Table

Get timeout of each rpc write request in this Table instance.

指定者:

getWriteRpcTimeout 在接口中 Table

参数:

unit - the unit of time the timeout to be represented in

返回:

write rpc timeout in the specified time unit

getWriteRpcTimeout

@Deprecated
public int getWriteRpcTimeout()

已过时。

从接口复制的说明: Table

Get timeout (millisecond) of each rpc write request in this Table instance.

指定者:

getWriteRpcTimeout 在接口中 Table

setWriteRpcTimeout

@Deprecated
public void setWriteRpcTimeout(int writeRpcTimeout)

已过时。

从接口复制的说明: Table

Set timeout (millisecond) of each rpc write request in operations of this Table instance, will override the value of hbase.rpc.write.timeout in configuration. If a rpc write request waiting too long, it will stop waiting and send a new request to retry until retries exhausted or operation timeout reached.

指定者:

setWriteRpcTimeout 在接口中 Table

参数:

writeRpcTimeout - the timeout for write rpc request in milliseconds

getOperationTimeout

public long getOperationTimeout(TimeUnit unit)

从接口复制的说明: Table

Get timeout of each operation in Table instance.

指定者:

getOperationTimeout 在接口中 Table

参数:

unit - the unit of time the timeout to be represented in

返回:

operation rpc timeout in the specified time unit

getOperationTimeout

@Deprecated
public int getOperationTimeout()

已过时。

从接口复制的说明: Table

Get timeout (millisecond) of each operation for in Table instance.

指定者:

getOperationTimeout 在接口中 Table

setOperationTimeout

@Deprecated
public void setOperationTimeout(int operationTimeout)

已过时。

从接口复制的说明: Table

Set timeout (millisecond) of each operation in this Table instance, will override the value of hbase.client.operation.timeout in configuration. Operation timeout is a top-level restriction that makes sure a blocking method will not be blocked more than this. In each operation, if rpc request fails because of timeout or other reason, it will retry until success or throw a RetriesExhaustedException. But if the total time being blocking reach the operation timeout before retries exhausted, it will break early and throw SocketTimeoutException.

指定者:

setOperationTimeout 在接口中 Table

参数:

operationTimeout - the total timeout of each operation in millisecond.

toString

public String toString()

覆盖:

toString 在类中 Object

batchCoprocessorService

public <R extends com.google.protobuf.Message> Map<byte[],R> batchCoprocessorService(com.google.protobuf.Descriptors.MethodDescriptor methodDescriptor,
                                                                                     com.google.protobuf.Message request,
                                                                                     byte[] startKey,
                                                                                     byte[] endKey,
                                                                                     R responsePrototype)
                                                                              throws com.google.protobuf.ServiceException,
                                                                                     Throwable

从接口复制的说明: Table

Creates an instance of the given Service subclass for each table region spanning the range from the startKey row to endKey row (inclusive), all the invocations to the same region server will be batched into one call. The coprocessor service is invoked according to the service instance, method name and parameters.

指定者:

batchCoprocessorService 在接口中 Table

类型参数:

R - the response type for the coprocessor Service method

参数:

methodDescriptor - the descriptor for the protobuf service method to call.

request - the method call parameters

startKey - start region selection with region containing this row. If null, the selection will start with the first table region.

endKey - select regions up to and including the region containing this row. If null, selection will continue through the last table region.

responsePrototype - the proto type of the response of the method in Service.

返回:

a map of result values keyed by region name

抛出:

com.google.protobuf.ServiceException

Throwable

batchCoprocessorService

public <R extends com.google.protobuf.Message> void batchCoprocessorService(com.google.protobuf.Descriptors.MethodDescriptor methodDescriptor,
                                                                            com.google.protobuf.Message request,
                                                                            byte[] startKey,
                                                                            byte[] endKey,
                                                                            R responsePrototype,
                                                                            Batch.Callback<R> callback)
                                                                     throws com.google.protobuf.ServiceException,
                                                                            Throwable

从接口复制的说明: Table

Creates an instance of the given Service subclass for each table region spanning the range from the startKey row to endKey row (inclusive), all the invocations to the same region server will be batched into one call. The coprocessor service is invoked according to the service instance, method name and parameters.

The given Batch.Callback.update(byte[],byte[],Object) method will be called with the return value from each region's invocation.

指定者:

batchCoprocessorService 在接口中 Table

类型参数:

R - the response type for the coprocessor Service method

参数:

methodDescriptor - the descriptor for the protobuf service method to call.

request - the method call parameters

startKey - start region selection with region containing this row. If null, the selection will start with the first table region.

endKey - select regions up to and including the region containing this row. If null, selection will continue through the last table region.

responsePrototype - the proto type of the response of the method in Service.

callback - callback to invoke with the response for each region

抛出:

com.google.protobuf.ServiceException

Throwable

getRegionLocator

public RegionLocator getRegionLocator()