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

Modifier and Type	Method and Description
Delete	addColumn(byte[] family, byte[] qualifier) Delete the latest version of the specified column.
Delete	addColumn(byte[] family, byte[] qualifier, long timestamp) Delete the specified version of the specified column.
Delete	addColumns(byte[] family, byte[] qualifier) Delete all versions of the specified column.
Delete	addColumns(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	addDeleteMarker(Cell kv) Advanced use only.
Delete	addFamily(byte[] family) Delete all versions of all columns of the specified family.
Delete	addFamily(byte[] family, long timestamp) Delete all columns of the specified family with a timestamp less than or equal to the specified timestamp.
Delete	addFamilyVersion(byte[] family, long timestamp) Delete all columns of the specified family with a timestamp equal to the specified timestamp.
Delete	deleteColumn(byte[] family, byte[] qualifier) Deprecated. Since hbase-1.0.0. Use addColumn(byte[], byte[])
Delete	deleteColumn(byte[] family, byte[] qualifier, long timestamp) Deprecated. Since hbase-1.0.0. Use addColumn(byte[], byte[], long)
Delete	deleteColumns(byte[] family, byte[] qualifier) Deprecated. Since hbase-1.0.0. Use addColumns(byte[], byte[])
Delete	deleteColumns(byte[] family, byte[] qualifier, long timestamp) Deprecated. Since hbase-1.0.0. Use addColumns(byte[], byte[], long)
Delete	deleteFamily(byte[] family) Deprecated. Since 1.0.0. Use addFamily(byte[])
Delete	deleteFamily(byte[] family, long timestamp) Deprecated. Since 1.0.0. Use addFamily(byte[], long)
Delete	deleteFamilyVersion(byte[] family, long timestamp) Deprecated. Since hbase-1.0.0. Use addFamilyVersion(byte[], long)
Delete	setACL(Map<String,Permission> perms)
Delete	setACL(String user, Permission perms)
Delete	setAttribute(String name, byte[] value) Sets an attribute.
Delete	setCellVisibility(CellVisibility expression) Sets the visibility expression associated with cells in this Mutation.
Delete	setClusterIds(List<UUID> clusterIds) Marks that the clusters with the given clusterIds have consumed the mutation
Delete	setDurability(Durability d) Set the durability for this mutation
Delete	setFamilyCellMap(NavigableMap<byte[],List<Cell>> map) Method for setting the put's familyMap
Delete	setFamilyMap(NavigableMap<byte[],List<KeyValue>> map) Deprecated.
Delete	setId(String id) This method allows you to set an identifier on an operation.
Delete	setTimestamp(long timestamp) Set the timestamp of the delete.
Delete	setTTL(long ttl) Set the TTL desired for the result of the mutation, in milliseconds.
Delete	setWriteToWAL(boolean write) Deprecated.
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, getCellVisibility, getClusterIds, getDurability, getFamilyCellMap, getFamilyMap, getFingerprint, getRow, getTimeStamp, getTTL, getWriteToWAL, heapSize, isEmpty, numFamilies, size

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

getAttribute, getAttributeSize, getAttributesMap, getId

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

@Deprecated
public Delete deleteFamily(byte[] family)

Deprecated. Since 1.0.0. Use addFamily(byte[])

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

addFamily

public Delete addFamily(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

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

Deprecated. Since 1.0.0. Use addFamily(byte[], long)

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

addFamily

public Delete addFamily(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

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

Deprecated. Since hbase-1.0.0. Use addFamilyVersion(byte[], long)

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

addFamilyVersion

public Delete addFamilyVersion(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

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

Deprecated. Since hbase-1.0.0. Use addColumns(byte[], byte[])

Delete all versions of the specified column.

Parameters:

family - family name

qualifier - column qualifier

Returns:

this for invocation chaining

addColumns

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

Delete all versions of the specified column.

Parameters:

family - family name

qualifier - column qualifier

Returns:

this for invocation chaining

deleteColumns

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

Deprecated. Since hbase-1.0.0. Use addColumns(byte[], byte[], long)

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

addColumns

public Delete addColumns(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

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

Deprecated. Since hbase-1.0.0. Use addColumn(byte[], byte[])

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

addColumn

public Delete addColumn(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

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

Deprecated. Since hbase-1.0.0. Use addColumn(byte[], byte[], long)

Delete the specified version of the specified column.

Parameters:

family - family name

qualifier - column qualifier

timestamp - version timestamp

Returns:

this for invocation chaining

addColumn

public Delete addColumn(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 Delete 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

setAttribute

public Delete setAttribute(String name,
                           byte[] value)

Description copied from interface: Attributes

Sets an attribute. In case value = null attribute is removed from the attributes map. Attribute names starting with _ indicate system attributes.

Specified by:

setAttribute in interface Attributes

Overrides:

setAttribute in class OperationWithAttributes

Parameters:

name - attribute name

value - attribute value

setId

public Delete setId(String id)

Description copied from class: OperationWithAttributes

This method allows you to set an identifier on an operation. The original motivation for this was to allow the identifier to be used in slow query logging, but this could obviously be useful in other places. One use of this could be to put a class.method identifier in here to see where the slow query is coming from.

Overrides:

setId in class OperationWithAttributes

Parameters:

id - id to set for the scan

setWriteToWAL

@Deprecated
public Delete setWriteToWAL(boolean write)

Deprecated.

Description copied from class: Mutation

Set whether this Delete should be written to the WAL or not. Not writing the WAL means you may lose edits on server crash. This method will reset any changes made via Mutation.setDurability(Durability)

Overrides:

setWriteToWAL in class Mutation

Parameters:

write - true if edits should be written to WAL, false if not

setDurability

public Delete setDurability(Durability d)

Description copied from class: Mutation

Set the durability for this mutation

Overrides:

setDurability in class Mutation

setFamilyCellMap

public Delete setFamilyCellMap(NavigableMap<byte[],List<Cell>> map)

Description copied from class: Mutation

Method for setting the put's familyMap

Overrides:

setFamilyCellMap in class Mutation

setFamilyMap

@Deprecated
public Delete setFamilyMap(NavigableMap<byte[],List<KeyValue>> map)

Deprecated.

Description copied from class: Mutation

Method for setting the put's familyMap that is deprecated and inefficient.

Overrides:

setFamilyMap in class Mutation

setClusterIds

public Delete setClusterIds(List<UUID> clusterIds)

Description copied from class: Mutation

Marks that the clusters with the given clusterIds have consumed the mutation

Overrides:

setClusterIds in class Mutation

Parameters:

clusterIds - of the clusters that have consumed the mutation

setCellVisibility

public Delete setCellVisibility(CellVisibility expression)

Description copied from class: Mutation

Sets the visibility expression associated with cells in this Mutation. It is illegal to set CellVisibility on Delete mutation.

Overrides:

setCellVisibility in class Mutation

setACL

public Delete setACL(String user,
                     Permission perms)

Overrides:

setACL in class Mutation

Parameters:

user - User short name

perms - Permissions for the user

setACL

public Delete setACL(Map<String,Permission> perms)

Overrides:

setACL in class Mutation

Parameters:

perms - A map of permissions for a user or users

setTTL

public Delete setTTL(long ttl)

Description copied from class: Mutation

Set the TTL desired for the result of the mutation, in milliseconds.

Overrides:

setTTL in class Mutation

Parameters:

ttl - the TTL desired for the result of the mutation, in milliseconds

Returns:

this