org.apache.hadoop.hbase.client

Class Delete

java.lang.Object

org.apache.hadoop.hbase.client.Operation

org.apache.hadoop.hbase.client.OperationWithAttributes

org.apache.hadoop.hbase.client.Mutation

org.apache.hadoop.hbase.client.Delete

All Implemented Interfaces:

Comparable<Row>, CellScannable, Attributes, Row, HeapSize

@InterfaceAudience.Public
@InterfaceStability.Stable
public class Delete
extends Mutation
implements Comparable<Row>

Used to perform Delete operations on a single row.

To delete an entire row, instantiate a Delete object with the row to delete. To further define the scope of what to delete, perform additional methods as outlined below.

To delete specific families, execute deleteFamily for each family to delete.

To delete multiple versions of specific columns, execute deleteColumns for each column to delete.

To delete specific versions of specific columns, execute deleteColumn for each column version to delete.

Specifying timestamps, deleteFamily and deleteColumns will delete all versions with a timestamp less than or equal to that passed. If no timestamp is specified, an entry is added with a timestamp of 'now' where 'now' is the servers's System.currentTimeMillis(). Specifying a timestamp to the deleteColumn method will delete versions only with a timestamp equal to that specified. If no timestamp is passed to deleteColumn, internally, it figures the most recent cell's timestamp and adds a delete at that timestamp; i.e. it deletes the most recently added cell.

The timestamp passed to the constructor is used ONLY for delete of rows. For anything less -- a deleteColumn, deleteColumns or deleteFamily -- then you need to use the method overrides that take a timestamp. The constructor timestamp is not referenced.

Field Summary

Fields inherited from class org.apache.hadoop.hbase.client.Mutation

durability, familyMap, MUTATION_OVERHEAD, row, ts

Fields inherited from class org.apache.hadoop.hbase.client.OperationWithAttributes

ID_ATRIBUTE

Constructor Summary

Constructors

Constructor and Description
Delete(byte[] row) Create a Delete operation for the specified row.
Delete(byte[] rowArray, int rowOffset, int rowLength) Create a Delete operation for the specified row and timestamp.
Delete(byte[] rowArray, int rowOffset, int rowLength, long ts) Create a Delete operation for the specified row and timestamp.
Delete(byte[] row, long timestamp) Create a Delete operation for the specified row and timestamp.
Delete(Delete d)

Method Summary

Methods

Modifier and Type	Method and Description
Delete	addDeleteMarker(Cell kv) Advanced use only.
Delete	deleteColumn(byte[] family, byte[] qualifier) Delete the latest version of the specified column.
Delete	deleteColumn(byte[] family, byte[] qualifier, long timestamp) Delete the specified version of the specified column.
Delete	deleteColumns(byte[] family, byte[] qualifier) Delete all versions of the specified column.
Delete	deleteColumns(byte[] family, byte[] qualifier, long timestamp) Delete all versions of the specified column with a timestamp less than or equal to the specified timestamp.
Delete	deleteFamily(byte[] family) Delete all versions of all columns of the specified family.
Delete	deleteFamily(byte[] family, long timestamp) Delete all columns of the specified family with a timestamp less than or equal to the specified timestamp.
Delete	deleteFamilyVersion(byte[] family, long timestamp) Delete all columns of the specified family with a timestamp equal to the specified timestamp.
void	setTimestamp(long timestamp) Set the timestamp of the delete.
Map<String,Object>	toMap(int maxCols) Compile the details beyond the scope of getFingerprint (row, columns, timestamps, etc.) into a Map along with the fingerprinted information.

Methods inherited from class org.apache.hadoop.hbase.client.Mutation

cellScanner, compareTo, extraHeapSize, getACL, getACLStrategy, getCellVisibility, getClusterIds, getDurability, getFamilyCellMap, getFamilyMap, getFingerprint, getRow, getTimeStamp, getWriteToWAL, heapSize, isEmpty, numFamilies, setACL, setACL, setACLStrategy, setCellVisibility, setClusterIds, setDurability, setFamilyCellMap, setFamilyMap, setWriteToWAL, size

Methods inherited from class org.apache.hadoop.hbase.client.OperationWithAttributes

getAttribute, getAttributeSize, getAttributesMap, getId, setAttribute, setId

Methods inherited from class org.apache.hadoop.hbase.client.Operation

toJSON, toJSON, toMap, toString, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Comparable

compareTo

Constructor Detail

Delete

public Delete(byte[] row)

Create a Delete operation for the specified row.

If no further operations are done, this will delete everything associated with the specified row (all versions of all columns in all families).

Parameters:

row - row key

Delete

public Delete(byte[] row,
      long timestamp)

Create a Delete operation for the specified row and timestamp.

If no further operations are done, this will delete all columns in all families of the specified row with a timestamp less than or equal to the specified timestamp.

This timestamp is ONLY used for a delete row operation. If specifying families or columns, you must specify each timestamp individually.

Parameters:

row - row key

timestamp - maximum version timestamp (only for delete row)

Delete

public Delete(byte[] rowArray,
      int rowOffset,
      int rowLength)

Create a Delete operation for the specified row and timestamp.

If no further operations are done, this will delete all columns in all families of the specified row with a timestamp less than or equal to the specified timestamp.

This timestamp is ONLY used for a delete row operation. If specifying families or columns, you must specify each timestamp individually.

Parameters:

rowArray - We make a local copy of this passed in row.

rowOffset -

rowLength -

Delete

public Delete(byte[] rowArray,
      int rowOffset,
      int rowLength,
      long ts)

Create a Delete operation for the specified row and timestamp.

If no further operations are done, this will delete all columns in all families of the specified row with a timestamp less than or equal to the specified timestamp.

This timestamp is ONLY used for a delete row operation. If specifying families or columns, you must specify each timestamp individually.

Parameters:

rowArray - We make a local copy of this passed in row.

rowOffset -

rowLength -

ts - maximum version timestamp (only for delete row)

Delete

public Delete(Delete d)

Parameters:

d - Delete to clone.

Method Detail

addDeleteMarker

public Delete addDeleteMarker(Cell kv)
                       throws IOException

Advanced use only. Add an existing delete marker to this Delete object.

Parameters:

kv - An existing KeyValue of type "delete".

Returns:

this for invocation chaining

Throws:

IOException

deleteFamily

public Delete deleteFamily(byte[] family)

Delete all versions of all columns of the specified family.

Overrides previous calls to deleteColumn and deleteColumns for the specified family.

Parameters:

family - family name

Returns:

this for invocation chaining

deleteFamily

public Delete deleteFamily(byte[] family,
                  long timestamp)

Delete all columns of the specified family with a timestamp less than or equal to the specified timestamp.

Overrides previous calls to deleteColumn and deleteColumns for the specified family.

Parameters:

family - family name

timestamp - maximum version timestamp

Returns:

this for invocation chaining

deleteFamilyVersion

public Delete deleteFamilyVersion(byte[] family,
                         long timestamp)

Delete all columns of the specified family with a timestamp equal to the specified timestamp.

Parameters:

family - family name

timestamp - version timestamp

Returns:

this for invocation chaining

deleteColumns

public Delete deleteColumns(byte[] family,
                   byte[] qualifier)

Delete all versions of the specified column.

Parameters:

family - family name

qualifier - column qualifier

Returns:

this for invocation chaining

deleteColumns

public Delete deleteColumns(byte[] family,
                   byte[] qualifier,
                   long timestamp)

Delete all versions of the specified column with a timestamp less than or equal to the specified timestamp.

Parameters:

family - family name

qualifier - column qualifier

timestamp - maximum version timestamp

Returns:

this for invocation chaining

deleteColumn

public Delete deleteColumn(byte[] family,
                  byte[] qualifier)

Delete the latest version of the specified column. This is an expensive call in that on the server-side, it first does a get to find the latest versions timestamp. Then it adds a delete using the fetched cells timestamp.

Parameters:

family - family name

qualifier - column qualifier

Returns:

this for invocation chaining

deleteColumn

public Delete deleteColumn(byte[] family,
                  byte[] qualifier,
                  long timestamp)

Delete the specified version of the specified column.

Parameters:

family - family name

qualifier - column qualifier

timestamp - version timestamp

Returns:

this for invocation chaining

setTimestamp

public void setTimestamp(long timestamp)

Set the timestamp of the delete.

Parameters:

timestamp -

toMap

public Map<String,Object> toMap(int maxCols)

Description copied from class: Mutation

Compile the details beyond the scope of getFingerprint (row, columns, timestamps, etc.) into a Map along with the fingerprinted information. Useful for debugging, logging, and administration tools.

Overrides:

toMap in class Mutation

Parameters:

maxCols - a limit on the number of columns output prior to truncation

Returns:

Map