HColumnDescriptor (Apache HBase - Client 2.0.0-alpha-1 API)

java.lang.Object
- org.apache.hadoop.hbase.HColumnDescriptor

All Implemented Interfaces:

Comparable<HColumnDescriptor>
```
@InterfaceAudience.Public
public class HColumnDescriptor
extends Object
implements Comparable<HColumnDescriptor>
```
An HColumnDescriptor contains information about a column family such as the number of versions, compression settings, etc. It is used as input when creating a table or adding a column.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`BLOCKCACHE` Key for the BLOCKCACHE attribute.
`static String`	`BLOCKSIZE` Size of storefile/hfile 'blocks'.
`static String`	`BLOOMFILTER`
`static String`	`CACHE_BLOOMS_ON_WRITE`
`static String`	`CACHE_DATA_IN_L1` Key for cache data into L1 if cache is set up with more than one tier.
`static String`	`CACHE_DATA_ON_WRITE`
`static String`	`CACHE_INDEX_ON_WRITE`
`static String`	`COMPRESS_TAGS`
`static String`	`COMPRESSION`
`static String`	`COMPRESSION_COMPACT`
`static String`	`DATA_BLOCK_ENCODING`
`static boolean`	`DEFAULT_BLOCKCACHE` Default setting for whether to use a block cache or not.
`static int`	`DEFAULT_BLOCKSIZE` Default size of blocks in files stored to the filesytem (hfiles).
`static String`	`DEFAULT_BLOOMFILTER` Default setting for whether or not to use bloomfilters.
`static boolean`	`DEFAULT_CACHE_BLOOMS_ON_WRITE` Default setting for whether to cache bloom filter blocks on write if block caching is enabled.
`static boolean`	`DEFAULT_CACHE_DATA_IN_L1` Default setting for whether to cache data blocks in L1 tier.
`static boolean`	`DEFAULT_CACHE_DATA_ON_WRITE` Default setting for whether to cache data blocks on write if block caching is enabled.
`static boolean`	`DEFAULT_CACHE_INDEX_ON_WRITE` Default setting for whether to cache index blocks on write if block caching is enabled.
`static boolean`	`DEFAULT_COMPRESS_TAGS` Default compress tags along with any type of DataBlockEncoding.
`static String`	`DEFAULT_COMPRESSION` Default compression type.
`static String`	`DEFAULT_DATA_BLOCK_ENCODING` Default data block encoding algorithm.
`static short`	`DEFAULT_DFS_REPLICATION`
`static boolean`	`DEFAULT_ENCODE_ON_DISK` Default value of the flag that enables data block encoding on disk, as opposed to encoding in cache only.
`static boolean`	`DEFAULT_EVICT_BLOCKS_ON_CLOSE` Default setting for whether to evict cached blocks from the blockcache on close.
`static boolean`	`DEFAULT_IN_MEMORY` Default setting for whether to try and serve this column family from memory or not.
`static KeepDeletedCells`	`DEFAULT_KEEP_DELETED` Default setting for preventing deleted from being collected immediately.
`static int`	`DEFAULT_MIN_VERSIONS` Default is not to keep a minimum of versions.
`static MobCompactPartitionPolicy`	`DEFAULT_MOB_COMPACT_PARTITION_POLICY`
`static long`	`DEFAULT_MOB_THRESHOLD`
`static boolean`	`DEFAULT_PREFETCH_BLOCKS_ON_OPEN`
`static int`	`DEFAULT_REPLICATION_SCOPE` Default scope.
`static int`	`DEFAULT_TTL` Default time to live of cell contents.
`static int`	`DEFAULT_VERSIONS` Default number of versions of a record to keep.
`static String`	`DFS_REPLICATION`
`static String`	`ENCODE_ON_DISK`
`static String`	`ENCRYPTION`
`static String`	`ENCRYPTION_KEY`
`static String`	`EVICT_BLOCKS_ON_CLOSE`
`static String`	`FOREVER`
`static String`	`IN_MEMORY_COMPACTION`
`static String`	`IS_MOB`
`static byte[]`	`IS_MOB_BYTES`
`static String`	`KEEP_DELETED_CELLS` Retain all cells across flushes and compactions even if they fall behind a delete tombstone.
`static String`	`LENGTH`
`static String`	`MIN_VERSIONS`
`static String`	`MOB_COMPACT_PARTITION_POLICY`
`static byte[]`	`MOB_COMPACT_PARTITION_POLICY_BYTES`
`static String`	`MOB_THRESHOLD`
`static byte[]`	`MOB_THRESHOLD_BYTES`
`static String`	`PREFETCH_BLOCKS_ON_OPEN` Key for the PREFETCH_BLOCKS_ON_OPEN attribute.
`static String`	`REPLICATION_SCOPE`
`static byte[]`	`REPLICATION_SCOPE_BYTES`
`static String`	`STORAGE_POLICY`
`static String`	`TTL`

Constructor Summary

Constructors
Constructor and Description
`HColumnDescriptor(byte[] familyName)` Construct a column descriptor specifying only the family name The other attributes are defaulted.
`HColumnDescriptor(HColumnDescriptor desc)` Constructor.
`HColumnDescriptor(String familyName)` Construct a column descriptor specifying only the family name The other attributes are defaulted.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`int`	`compareTo(HColumnDescriptor o)`
`boolean`	`equals(Object obj)`
`int`	`getBlocksize()`
`BloomType`	`getBloomFilterType()`
`Compression.Algorithm`	`getCompactionCompression()` Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0 (HBASE-13655). Use `getCompactionCompressionType()`.
`Compression.Algorithm`	`getCompactionCompressionType()`
`Compression.Algorithm`	`getCompression()` Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0 (HBASE-13655). Use `getCompressionType()`.
`Compression.Algorithm`	`getCompressionType()`
`Map<String,String>`	`getConfiguration()` Getter for fetching an unmodifiable `configuration` map.
`String`	`getConfigurationValue(String key)` Getter for accessing the configuration value by key.
`DataBlockEncoding`	`getDataBlockEncoding()`
`static Map<String,String>`	`getDefaultValues()`
`short`	`getDFSReplication()`
`byte[]`	`getEncryptionKey()` Return the raw crypto key attribute for the family, or null if not set
`String`	`getEncryptionType()` Return the encryption algorithm in use by this family
`MemoryCompactionPolicy`	`getInMemoryCompaction()`
`KeepDeletedCells`	`getKeepDeletedCells()`
`int`	`getMaxVersions()`
`int`	`getMinVersions()`
`MobCompactPartitionPolicy`	`getMobCompactPartitionPolicy()` Get the mob compact partition policy for this family
`long`	`getMobThreshold()` Gets the mob threshold of the family.
`byte[]`	`getName()`
`String`	`getNameAsString()`
`int`	`getScope()`
`String`	`getStoragePolicy()` Return the storage policy in use by this family Not using `enum` here because HDFS is not using `enum` for storage policy, see org.apache.hadoop.hdfs.server.blockmanagement.BlockStoragePolicySuite for more details
`int`	`getTimeToLive()`
`static PrettyPrinter.Unit`	`getUnit(String key)`
`byte[]`	`getValue(byte[] key)`
`String`	`getValue(String key)`
`Map<Bytes,Bytes>`	`getValues()`
`int`	`hashCode()`
`boolean`	`isBlockCacheEnabled()`
`boolean`	`isCacheBloomsOnWrite()`
`boolean`	`isCacheDataInL1()`
`boolean`	`isCacheDataOnWrite()`
`boolean`	`isCacheIndexesOnWrite()`
`boolean`	`isCompressTags()`
`boolean`	`isEvictBlocksOnClose()`
`boolean`	`isInMemory()`
`static byte[]`	`isLegalFamilyName(byte[] b)`
`boolean`	`isMobEnabled()` Gets whether the mob is enabled for the family.
`boolean`	`isPrefetchBlocksOnOpen()`
`static HColumnDescriptor`	`parseFrom(byte[] bytes)`
`void`	`remove(byte[] key)`
`void`	`removeConfiguration(String key)` Remove a configuration setting represented by the key from the `configuration` map.
`HColumnDescriptor`	`setBlockCacheEnabled(boolean blockCacheEnabled)`
`HColumnDescriptor`	`setBlocksize(int s)`
`HColumnDescriptor`	`setBloomFilterType(BloomType bt)`
`HColumnDescriptor`	`setCacheBloomsOnWrite(boolean value)`
`HColumnDescriptor`	`setCacheDataInL1(boolean value)`
`HColumnDescriptor`	`setCacheDataOnWrite(boolean value)`
`HColumnDescriptor`	`setCacheIndexesOnWrite(boolean value)`
`HColumnDescriptor`	`setCompactionCompressionType(Compression.Algorithm type)` Compression types supported in hbase.
`HColumnDescriptor`	`setCompressionType(Compression.Algorithm type)` Compression types supported in hbase.
`HColumnDescriptor`	`setCompressTags(boolean compressTags)` Set whether the tags should be compressed along with DataBlockEncoding.
`HColumnDescriptor`	`setConfiguration(String key, String value)` Setter for storing a configuration setting in `configuration` map.
`HColumnDescriptor`	`setDataBlockEncoding(DataBlockEncoding type)` Set data block encoding algorithm used in block cache.
`HColumnDescriptor`	`setDFSReplication(short replication)` Set the replication factor to hfile(s) belonging to this family
`HColumnDescriptor`	`setEncryptionKey(byte[] keyBytes)` Set the raw crypto key attribute for the family
`HColumnDescriptor`	`setEncryptionType(String algorithm)` Set the encryption algorithm for use with this family
`HColumnDescriptor`	`setEvictBlocksOnClose(boolean value)`
`HColumnDescriptor`	`setInMemory(boolean inMemory)`
`HColumnDescriptor`	`setInMemoryCompaction(MemoryCompactionPolicy inMemoryCompaction)`
`HColumnDescriptor`	`setKeepDeletedCells(KeepDeletedCells keepDeletedCells)`
`HColumnDescriptor`	`setMaxVersions(int maxVersions)`
`HColumnDescriptor`	`setMinVersions(int minVersions)`
`HColumnDescriptor`	`setMobCompactPartitionPolicy(MobCompactPartitionPolicy policy)` Set the mob compact partition policy for the family.
`HColumnDescriptor`	`setMobEnabled(boolean isMobEnabled)` Enables the mob for the family.
`HColumnDescriptor`	`setMobThreshold(long threshold)` Sets the mob threshold of the family.
`HColumnDescriptor`	`setPrefetchBlocksOnOpen(boolean value)`
`HColumnDescriptor`	`setScope(int scope)`
`HColumnDescriptor`	`setStoragePolicy(String policy)` Set the storage policy for use with this family
`HColumnDescriptor`	`setTimeToLive(int timeToLive)`
`HColumnDescriptor`	`setTimeToLive(String timeToLive)`
`HColumnDescriptor`	`setValue(byte[] key, byte[] value)`
`HColumnDescriptor`	`setValue(String key, String value)`
`HColumnDescriptor`	`setVersions(int minVersions, int maxVersions)` Set minimum and maximum versions to keep
`byte[]`	`toByteArray()`
`String`	`toString()`
`String`	`toStringCustomizedValues()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - IN_MEMORY_COMPACTION
```
public static final String IN_MEMORY_COMPACTION
```
    See Also:
    
    Constant Field Values
  - COMPRESSION
```
public static final String COMPRESSION
```
    See Also:
    
    Constant Field Values
  - COMPRESSION_COMPACT
```
public static final String COMPRESSION_COMPACT
```
    See Also:
    
    Constant Field Values
  - ENCODE_ON_DISK
```
public static final String ENCODE_ON_DISK
```
    See Also:
    
    Constant Field Values
  - DATA_BLOCK_ENCODING
```
public static final String DATA_BLOCK_ENCODING
```
    See Also:
    
    Constant Field Values
  - BLOCKCACHE
```
public static final String BLOCKCACHE
```
    Key for the BLOCKCACHE attribute. A more exact name would be CACHE_DATA_ON_READ because this flag sets whether or not we cache DATA blocks. We always cache INDEX and BLOOM blocks; caching these blocks cannot be disabled.
    
    See Also:
    
    Constant Field Values
  - CACHE_DATA_ON_WRITE
```
public static final String CACHE_DATA_ON_WRITE
```
    See Also:
    
    Constant Field Values
  - CACHE_INDEX_ON_WRITE
```
public static final String CACHE_INDEX_ON_WRITE
```
    See Also:
    
    Constant Field Values
  - CACHE_BLOOMS_ON_WRITE
```
public static final String CACHE_BLOOMS_ON_WRITE
```
    See Also:
    
    Constant Field Values
  - EVICT_BLOCKS_ON_CLOSE
```
public static final String EVICT_BLOCKS_ON_CLOSE
```
    See Also:
    
    Constant Field Values
  - CACHE_DATA_IN_L1
```
public static final String CACHE_DATA_IN_L1
```
    Key for cache data into L1 if cache is set up with more than one tier. To set in the shell, do something like this: hbase(main):003:0> create 't', {NAME => 't', CONFIGURATION => {CACHE_DATA_IN_L1 => 'true'}}
    
    See Also:
    
    Constant Field Values
  - PREFETCH_BLOCKS_ON_OPEN
```
public static final String PREFETCH_BLOCKS_ON_OPEN
```
    Key for the PREFETCH_BLOCKS_ON_OPEN attribute. If set, all INDEX, BLOOM, and DATA blocks of HFiles belonging to this family will be loaded into the cache as soon as the file is opened. These loads will not count as cache misses.
    
    See Also:
    
    Constant Field Values
  - BLOCKSIZE
```
public static final String BLOCKSIZE
```
    Size of storefile/hfile 'blocks'. Default is DEFAULT_BLOCKSIZE. Use smaller block sizes for faster random-access at expense of larger indices (more memory consumption). Note that this is a soft limit and that blocks have overhead (metadata, CRCs) so blocks will tend to be the size specified here and then some; i.e. don't expect that setting BLOCKSIZE=4k means hbase data will align with an SSDs 4k page accesses (TODO).
    
    See Also:
    
    Constant Field Values
  - LENGTH
```
public static final String LENGTH
```
    See Also:
    
    Constant Field Values
  - TTL
```
public static final String TTL
```
    See Also:
    
    Constant Field Values
  - BLOOMFILTER
```
public static final String BLOOMFILTER
```
    See Also:
    
    Constant Field Values
  - FOREVER
```
public static final String FOREVER
```
    See Also:
    
    Constant Field Values
  - REPLICATION_SCOPE
```
public static final String REPLICATION_SCOPE
```
    See Also:
    
    Constant Field Values
  - REPLICATION_SCOPE_BYTES
```
public static final byte[] REPLICATION_SCOPE_BYTES
```
  - MIN_VERSIONS
```
public static final String MIN_VERSIONS
```
    See Also:
    
    Constant Field Values
  - KEEP_DELETED_CELLS
```
public static final String KEEP_DELETED_CELLS
```
    Retain all cells across flushes and compactions even if they fall behind a delete tombstone. To see all retained cells, do a 'raw' scan; see Scan#setRaw or pass RAW => true attribute in the shell.
    
    See Also:
    
    Constant Field Values
  - COMPRESS_TAGS
```
public static final String COMPRESS_TAGS
```
    See Also:
    
    Constant Field Values
  - ENCRYPTION
```
public static final String ENCRYPTION
```
    See Also:
    
    Constant Field Values
  - ENCRYPTION_KEY
```
public static final String ENCRYPTION_KEY
```
    See Also:
    
    Constant Field Values
  - IS_MOB
```
public static final String IS_MOB
```
    See Also:
    
    Constant Field Values
  - IS_MOB_BYTES
```
public static final byte[] IS_MOB_BYTES
```
  - MOB_THRESHOLD
```
public static final String MOB_THRESHOLD
```
    See Also:
    
    Constant Field Values
  - MOB_THRESHOLD_BYTES
```
public static final byte[] MOB_THRESHOLD_BYTES
```
  - DEFAULT_MOB_THRESHOLD
```
public static final long DEFAULT_MOB_THRESHOLD
```
    See Also:
    
    Constant Field Values
  - MOB_COMPACT_PARTITION_POLICY
```
public static final String MOB_COMPACT_PARTITION_POLICY
```
    See Also:
    
    Constant Field Values
  - MOB_COMPACT_PARTITION_POLICY_BYTES
```
public static final byte[] MOB_COMPACT_PARTITION_POLICY_BYTES
```
  - DEFAULT_MOB_COMPACT_PARTITION_POLICY
```
public static final MobCompactPartitionPolicy DEFAULT_MOB_COMPACT_PARTITION_POLICY
```
  - DFS_REPLICATION
```
public static final String DFS_REPLICATION
```
    See Also:
    
    Constant Field Values
  - DEFAULT_DFS_REPLICATION
```
public static final short DEFAULT_DFS_REPLICATION
```
    See Also:
    
    Constant Field Values
  - STORAGE_POLICY
```
public static final String STORAGE_POLICY
```
    See Also:
    
    Constant Field Values
  - DEFAULT_COMPRESSION
```
public static final String DEFAULT_COMPRESSION
```
    Default compression type.
  - DEFAULT_ENCODE_ON_DISK
```
public static final boolean DEFAULT_ENCODE_ON_DISK
```
    Default value of the flag that enables data block encoding on disk, as opposed to encoding in cache only. We encode blocks everywhere by default, as long as DATA_BLOCK_ENCODING is not NONE.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_DATA_BLOCK_ENCODING
```
public static final String DEFAULT_DATA_BLOCK_ENCODING
```
    Default data block encoding algorithm.
  - DEFAULT_VERSIONS
```
public static final int DEFAULT_VERSIONS
```
    Default number of versions of a record to keep.
  - DEFAULT_MIN_VERSIONS
```
public static final int DEFAULT_MIN_VERSIONS
```
    Default is not to keep a minimum of versions.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_IN_MEMORY
```
public static final boolean DEFAULT_IN_MEMORY
```
    Default setting for whether to try and serve this column family from memory or not.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_KEEP_DELETED
```
public static final KeepDeletedCells DEFAULT_KEEP_DELETED
```
    Default setting for preventing deleted from being collected immediately.
  - DEFAULT_BLOCKCACHE
```
public static final boolean DEFAULT_BLOCKCACHE
```
    Default setting for whether to use a block cache or not.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_CACHE_DATA_ON_WRITE
```
public static final boolean DEFAULT_CACHE_DATA_ON_WRITE
```
    Default setting for whether to cache data blocks on write if block caching is enabled.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_CACHE_DATA_IN_L1
```
public static final boolean DEFAULT_CACHE_DATA_IN_L1
```
    Default setting for whether to cache data blocks in L1 tier. Only makes sense if more than one tier in operations: i.e. if we have an L1 and a L2. This will be the cases if we are using BucketCache.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_CACHE_INDEX_ON_WRITE
```
public static final boolean DEFAULT_CACHE_INDEX_ON_WRITE
```
    Default setting for whether to cache index blocks on write if block caching is enabled.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_BLOCKSIZE
```
public static final int DEFAULT_BLOCKSIZE
```
    Default size of blocks in files stored to the filesytem (hfiles).
    
    See Also:
    
    Constant Field Values
  - DEFAULT_BLOOMFILTER
```
public static final String DEFAULT_BLOOMFILTER
```
    Default setting for whether or not to use bloomfilters.
  - DEFAULT_CACHE_BLOOMS_ON_WRITE
```
public static final boolean DEFAULT_CACHE_BLOOMS_ON_WRITE
```
    Default setting for whether to cache bloom filter blocks on write if block caching is enabled.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_TTL
```
public static final int DEFAULT_TTL
```
    Default time to live of cell contents.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_REPLICATION_SCOPE
```
public static final int DEFAULT_REPLICATION_SCOPE
```
    Default scope.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_EVICT_BLOCKS_ON_CLOSE
```
public static final boolean DEFAULT_EVICT_BLOCKS_ON_CLOSE
```
    Default setting for whether to evict cached blocks from the blockcache on close.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_COMPRESS_TAGS
```
public static final boolean DEFAULT_COMPRESS_TAGS
```
    Default compress tags along with any type of DataBlockEncoding.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_PREFETCH_BLOCKS_ON_OPEN
```
public static final boolean DEFAULT_PREFETCH_BLOCKS_ON_OPEN
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - HColumnDescriptor
```
public HColumnDescriptor(String familyName)
```
    Construct a column descriptor specifying only the family name The other attributes are defaulted.
    
    Parameters:
    
    familyName - Column family name. Must be 'printable' -- digit or letter -- and may not contain a :
  - HColumnDescriptor
```
public HColumnDescriptor(byte[] familyName)
```
    Construct a column descriptor specifying only the family name The other attributes are defaulted.
    
    Parameters:
    
    familyName - Column family name. Must be 'printable' -- digit or letter -- and may not contain a :
  - HColumnDescriptor
```
public HColumnDescriptor(HColumnDescriptor desc)
```
    Constructor. Makes a deep copy of the supplied descriptor. Can make a modifiable descriptor from an UnmodifyableHColumnDescriptor.
    
    Parameters:
    
    desc - The descriptor.
- Method Detail
  - isLegalFamilyName
```
public static byte[] isLegalFamilyName(byte[] b)
```
    Parameters:
    
    b - Family name.
    
    Returns:
    
    b
    
    Throws:
    
    IllegalArgumentException - If not null and not a legitimate family name: i.e. 'printable' and ends in a ':' (Null passes are allowed because b can be null when deserializing). Cannot start with a '.' either. Also Family can not be an empty value or equal "recovered.edits".
  - getName
```
public byte[] getName()
```
    Returns:
    
    Name of this column family
  - getNameAsString
```
public String getNameAsString()
```
    Returns:
    
    Name of this column family
  - getValue
```
public byte[] getValue(byte[] key)
```
    Parameters:
    
    key - The key.
    
    Returns:
    
    The value.
  - getValue
```
public String getValue(String key)
```
    Parameters:
    
    key - The key.
    
    Returns:
    
    The value as a string.
  - getValues
```
public Map<Bytes,Bytes> getValues()
```
    Returns:
    
    All values.
  - setValue
```
public HColumnDescriptor setValue(byte[] key,
                                  byte[] value)
```
    Parameters:
    
    key - The key.
    
    value - The value.
    
    Returns:
    
    this (for chained invocation)
  - remove
```
public void remove(byte[] key)
```
    Parameters:
    
    key - Key whose key and value we're to remove from HCD parameters.
  - setValue
```
public HColumnDescriptor setValue(String key,
                                  String value)
```
    Parameters:
    
    key - The key.
    
    value - The value.
    
    Returns:
    
    this (for chained invocation)
  - getCompression
```
@Deprecated
public Compression.Algorithm getCompression()
```
    Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0 (HBASE-13655). Use getCompressionType().
    
    Returns:
    
    compression type being used for the column family
  - getCompactionCompression
```
@Deprecated
public Compression.Algorithm getCompactionCompression()
```
    Deprecated. As of release 2.0.0, this will be removed in HBase 3.0.0 (HBASE-13655). Use getCompactionCompressionType().
    
    Returns:
    
    compression type being used for the column family for major compaction
  - getMaxVersions
```
public int getMaxVersions()
```
    Returns:
    
    maximum number of versions
  - setMaxVersions
```
public HColumnDescriptor setMaxVersions(int maxVersions)
```
    Parameters:
    
    maxVersions - maximum number of versions
    
    Returns:
    
    this (for chained invocation)
  - setVersions
```
public HColumnDescriptor setVersions(int minVersions,
                                     int maxVersions)
```
    Set minimum and maximum versions to keep
    
    Parameters:
    
    minVersions - minimal number of versions
    
    maxVersions - maximum number of versions
    
    Returns:
    
    this (for chained invocation)
  - getBlocksize
```
public int getBlocksize()
```
    Returns:
    
    The storefile/hfile blocksize for this column family.
  - setBlocksize
```
public HColumnDescriptor setBlocksize(int s)
```
    Parameters:
    
    s - Blocksize to use when writing out storefiles/hfiles on this column family.
    
    Returns:
    
    this (for chained invocation)
  - getCompressionType
```
public Compression.Algorithm getCompressionType()
```
    Returns:
    
    Compression type setting.
  - setCompressionType
```
public HColumnDescriptor setCompressionType(Compression.Algorithm type)
```
    Compression types supported in hbase. LZO is not bundled as part of the hbase distribution. See LZO Compression for how to enable it.
    
    Parameters:
    
    type - Compression type setting.
    
    Returns:
    
    this (for chained invocation)
  - getDataBlockEncoding
```
public DataBlockEncoding getDataBlockEncoding()
```
    Returns:
    
    the data block encoding algorithm used in block cache and optionally on disk
  - setDataBlockEncoding
```
public HColumnDescriptor setDataBlockEncoding(DataBlockEncoding type)
```
    Set data block encoding algorithm used in block cache.
    
    Parameters:
    
    type - What kind of data block encoding will be used.
    
    Returns:
    
    this (for chained invocation)
  - setCompressTags
```
public HColumnDescriptor setCompressTags(boolean compressTags)
```
    Set whether the tags should be compressed along with DataBlockEncoding. When no DataBlockEncoding is been used, this is having no effect.
    
    Parameters:
    
    compressTags -
    
    Returns:
    
    this (for chained invocation)
  - isCompressTags
```
public boolean isCompressTags()
```
    Returns:
    
    Whether KV tags should be compressed along with DataBlockEncoding. When no DataBlockEncoding is been used, this is having no effect.
  - getCompactionCompressionType
```
public Compression.Algorithm getCompactionCompressionType()
```
    Returns:
    
    Compression type setting.
  - setCompactionCompressionType
```
public HColumnDescriptor setCompactionCompressionType(Compression.Algorithm type)
```
    Compression types supported in hbase. LZO is not bundled as part of the hbase distribution. See LZO Compression for how to enable it.
    
    Parameters:
    
    type - Compression type setting.
    
    Returns:
    
    this (for chained invocation)
  - isInMemory
```
public boolean isInMemory()
```
    Returns:
    
    True if we are to favor keeping all values for this column family in the HRegionServer cache.
  - setInMemory
```
public HColumnDescriptor setInMemory(boolean inMemory)
```
    Parameters:
    
    inMemory - True if we are to favor keeping all values for this column family in the HRegionServer cache
    
    Returns:
    
    this (for chained invocation)
  - getInMemoryCompaction
```
public MemoryCompactionPolicy getInMemoryCompaction()
```
    Returns:
    
    in-memory compaction policy if set for the cf. Returns null if no policy is set for for this column family
  - setInMemoryCompaction
```
public HColumnDescriptor setInMemoryCompaction(MemoryCompactionPolicy inMemoryCompaction)
```
    Parameters:
    
    inMemoryCompaction - the prefered in-memory compaction policy for this column family
    
    Returns:
    
    this (for chained invocation)
  - getKeepDeletedCells
```
public KeepDeletedCells getKeepDeletedCells()
```
  - setKeepDeletedCells
```
public HColumnDescriptor setKeepDeletedCells(KeepDeletedCells keepDeletedCells)
```
    Parameters:
    
    keepDeletedCells - True if deleted rows should not be collected immediately.
    
    Returns:
    
    this (for chained invocation)
  - getTimeToLive
```
public int getTimeToLive()
```
    Returns:
    
    Time-to-live of cell contents, in seconds.
  - setTimeToLive
```
public HColumnDescriptor setTimeToLive(int timeToLive)
```
    Parameters:
    
    timeToLive - Time-to-live of cell contents, in seconds.
    
    Returns:
    
    this (for chained invocation)
  - setTimeToLive
```
public HColumnDescriptor setTimeToLive(String timeToLive)
                                throws HBaseException
```
    Parameters:
    
    timeToLive - Time to live of cell contents, in human readable format
    
    Returns:
    
    this (for chained invocation)
    
    Throws:
    
    HBaseException
    
    See Also:
    
    PrettyPrinter.format(String, Unit)
  - getMinVersions
```
public int getMinVersions()
```
    Returns:
    
    The minimum number of versions to keep.
  - setMinVersions
```
public HColumnDescriptor setMinVersions(int minVersions)
```
    Parameters:
    
    minVersions - The minimum number of versions to keep. (used when timeToLive is set)
    
    Returns:
    
    this (for chained invocation)
  - isBlockCacheEnabled
```
public boolean isBlockCacheEnabled()
```
    Returns:
    
    True if hfile DATA type blocks should be cached (You cannot disable caching of INDEX and BLOOM type blocks).
  - setBlockCacheEnabled
```
public HColumnDescriptor setBlockCacheEnabled(boolean blockCacheEnabled)
```
    Parameters:
    
    blockCacheEnabled - True if hfile DATA type blocks should be cached (We always cache INDEX and BLOOM blocks; you cannot turn this off).
    
    Returns:
    
    this (for chained invocation)
  - getBloomFilterType
```
public BloomType getBloomFilterType()
```
    Returns:
    
    bloom filter type used for new StoreFiles in ColumnFamily
  - setBloomFilterType
```
public HColumnDescriptor setBloomFilterType(BloomType bt)
```
    Parameters:
    
    bt - bloom filter type
    
    Returns:
    
    this (for chained invocation)
  - getScope
```
public int getScope()
```
    Returns:
    
    the scope tag
  - setScope
```
public HColumnDescriptor setScope(int scope)
```
    Parameters:
    
    scope - the scope tag
    
    Returns:
    
    this (for chained invocation)
  - isCacheDataOnWrite
```
public boolean isCacheDataOnWrite()
```
    Returns:
    
    true if we should cache data blocks on write
  - setCacheDataOnWrite
```
public HColumnDescriptor setCacheDataOnWrite(boolean value)
```
    Parameters:
    
    value - true if we should cache data blocks on write
    
    Returns:
    
    this (for chained invocation)
  - isCacheDataInL1
```
public boolean isCacheDataInL1()
```
    Returns:
    
    true if we should cache data blocks in the L1 cache (if block cache deploy has more than one tier; e.g. we are using CombinedBlockCache).
  - setCacheDataInL1
```
public HColumnDescriptor setCacheDataInL1(boolean value)
```
    Parameters:
    
    value - true if we should cache data blocks in the L1 cache (if block cache deploy has more than one tier; e.g. we are using CombinedBlockCache).
    
    Returns:
    
    this (for chained invocation)
  - isCacheIndexesOnWrite
```
public boolean isCacheIndexesOnWrite()
```
    Returns:
    
    true if we should cache index blocks on write
  - setCacheIndexesOnWrite
```
public HColumnDescriptor setCacheIndexesOnWrite(boolean value)
```
    Parameters:
    
    value - true if we should cache index blocks on write
    
    Returns:
    
    this (for chained invocation)
  - isCacheBloomsOnWrite
```
public boolean isCacheBloomsOnWrite()
```
    Returns:
    
    true if we should cache bloomfilter blocks on write
  - setCacheBloomsOnWrite
```
public HColumnDescriptor setCacheBloomsOnWrite(boolean value)
```
    Parameters:
    
    value - true if we should cache bloomfilter blocks on write
    
    Returns:
    
    this (for chained invocation)
  - isEvictBlocksOnClose
```
public boolean isEvictBlocksOnClose()
```
    Returns:
    
    true if we should evict cached blocks from the blockcache on close
  - setEvictBlocksOnClose
```
public HColumnDescriptor setEvictBlocksOnClose(boolean value)
```
    Parameters:
    
    value - true if we should evict cached blocks from the blockcache on close
    
    Returns:
    
    this (for chained invocation)
  - isPrefetchBlocksOnOpen
```
public boolean isPrefetchBlocksOnOpen()
```
    Returns:
    
    true if we should prefetch blocks into the blockcache on open
  - setPrefetchBlocksOnOpen
```
public HColumnDescriptor setPrefetchBlocksOnOpen(boolean value)
```
    Parameters:
    
    value - true if we should prefetch blocks into the blockcache on open
    
    Returns:
    
    this (for chained invocation)
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
    
    See Also:
    
    Object.toString()
  - toStringCustomizedValues
```
public String toStringCustomizedValues()
```
    Returns:
    
    Column family descriptor with only the customized attributes.
  - getUnit
```
public static PrettyPrinter.Unit getUnit(String key)
```
  - getDefaultValues
```
public static Map<String,String> getDefaultValues()
```
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
    
    See Also:
    
    Object.equals(java.lang.Object)
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
    
    See Also:
    
    Object.hashCode()
  - compareTo
```
public int compareTo(HColumnDescriptor o)
```
    Specified by:
    
    compareTo in interface Comparable<HColumnDescriptor>
  - toByteArray
```
public byte[] toByteArray()
```
    Returns:
    
    This instance serialized with pb with pb magic prefix
    
    See Also:
    
    parseFrom(byte[])
  - parseFrom
```
public static HColumnDescriptor parseFrom(byte[] bytes)
                                   throws DeserializationException
```
    Parameters:
    
    bytes - A pb serialized HColumnDescriptor instance with pb magic prefix
    
    Returns:
    
    An instance of HColumnDescriptor made from bytes
    
    Throws:
    
    DeserializationException
    
    See Also:
    
    toByteArray()
  - getConfigurationValue
```
public String getConfigurationValue(String key)
```
    Getter for accessing the configuration value by key.
  - getConfiguration
```
public Map<String,String> getConfiguration()
```
    Getter for fetching an unmodifiable configuration map.
  - setConfiguration
```
public HColumnDescriptor setConfiguration(String key,
                                          String value)
```
    Setter for storing a configuration setting in configuration map.
    
    Parameters:
    
    key - Config key. Same as XML config key e.g. hbase.something.or.other.
    
    value - String value. If null, removes the configuration.
  - removeConfiguration
```
public void removeConfiguration(String key)
```
    Remove a configuration setting represented by the key from the configuration map.
  - getEncryptionType
```
public String getEncryptionType()
```
    Return the encryption algorithm in use by this family
  - setEncryptionType
```
public HColumnDescriptor setEncryptionType(String algorithm)
```
    Set the encryption algorithm for use with this family
    
    Parameters:
    
    algorithm -
  - getEncryptionKey
```
public byte[] getEncryptionKey()
```
    Return the raw crypto key attribute for the family, or null if not set
  - setEncryptionKey
```
public HColumnDescriptor setEncryptionKey(byte[] keyBytes)
```
    Set the raw crypto key attribute for the family
  - getMobThreshold
```
public long getMobThreshold()
```
    Gets the mob threshold of the family. If the size of a cell value is larger than this threshold, it's regarded as a mob. The default threshold is 1024*100(100K)B.
    
    Returns:
    
    The mob threshold.
  - setMobThreshold
```
public HColumnDescriptor setMobThreshold(long threshold)
```
    Sets the mob threshold of the family.
    
    Parameters:
    
    threshold - The mob threshold.
    
    Returns:
    
    this (for chained invocation)
  - isMobEnabled
```
public boolean isMobEnabled()
```
    Gets whether the mob is enabled for the family.
    
    Returns:
    
    True if the mob is enabled for the family.
  - setMobEnabled
```
public HColumnDescriptor setMobEnabled(boolean isMobEnabled)
```
    Enables the mob for the family.
    
    Parameters:
    
    isMobEnabled - Whether to enable the mob for the family.
    
    Returns:
    
    this (for chained invocation)
  - getMobCompactPartitionPolicy
```
public MobCompactPartitionPolicy getMobCompactPartitionPolicy()
```
    Get the mob compact partition policy for this family
    
    Returns:
    
    MobCompactPartitionPolicy
  - setMobCompactPartitionPolicy
```
public HColumnDescriptor setMobCompactPartitionPolicy(MobCompactPartitionPolicy policy)
```
    Set the mob compact partition policy for the family.
    
    Parameters:
    
    policy - policy type
    
    Returns:
    
    this (for chained invocation)
  - getDFSReplication
```
public short getDFSReplication()
```
    Returns:
    
    replication factor set for this CF or DEFAULT_DFS_REPLICATION if not set.
    DEFAULT_DFS_REPLICATION value indicates that user has explicitly not set any block replication factor for this CF, hence use the default replication factor set in the file system.
  - setDFSReplication
```
public HColumnDescriptor setDFSReplication(short replication)
```
    Set the replication factor to hfile(s) belonging to this family
    
    Parameters:
    
    replication - number of replicas the blocks(s) belonging to this CF should have, or DEFAULT_DFS_REPLICATION for the default replication factor set in the filesystem
    
    Returns:
    
    this (for chained invocation)
  - getStoragePolicy
```
public String getStoragePolicy()
```
    Return the storage policy in use by this family
    Not using enum here because HDFS is not using enum for storage policy, see org.apache.hadoop.hdfs.server.blockmanagement.BlockStoragePolicySuite for more details
  - setStoragePolicy
```
public HColumnDescriptor setStoragePolicy(String policy)
```
    Set the storage policy for use with this family
    
    Parameters:
    
    policy - the policy to set, valid setting includes: "LAZY_PERSIST", "ALL_SSD", "ONE_SSD", "HOT", "WARM", "COLD"

Class HColumnDescriptor

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

IN_MEMORY_COMPACTION

COMPRESSION

COMPRESSION_COMPACT

ENCODE_ON_DISK

DATA_BLOCK_ENCODING

BLOCKCACHE

CACHE_DATA_ON_WRITE

CACHE_INDEX_ON_WRITE

CACHE_BLOOMS_ON_WRITE

EVICT_BLOCKS_ON_CLOSE

CACHE_DATA_IN_L1

PREFETCH_BLOCKS_ON_OPEN

BLOCKSIZE

LENGTH

TTL

BLOOMFILTER

FOREVER

REPLICATION_SCOPE

REPLICATION_SCOPE_BYTES

MIN_VERSIONS

KEEP_DELETED_CELLS

COMPRESS_TAGS

ENCRYPTION

ENCRYPTION_KEY

IS_MOB

IS_MOB_BYTES

MOB_THRESHOLD

MOB_THRESHOLD_BYTES

DEFAULT_MOB_THRESHOLD

MOB_COMPACT_PARTITION_POLICY

MOB_COMPACT_PARTITION_POLICY_BYTES

DEFAULT_MOB_COMPACT_PARTITION_POLICY

DFS_REPLICATION

DEFAULT_DFS_REPLICATION

STORAGE_POLICY

DEFAULT_COMPRESSION

DEFAULT_ENCODE_ON_DISK

DEFAULT_DATA_BLOCK_ENCODING

DEFAULT_VERSIONS

DEFAULT_MIN_VERSIONS

DEFAULT_IN_MEMORY

DEFAULT_KEEP_DELETED

DEFAULT_BLOCKCACHE

DEFAULT_CACHE_DATA_ON_WRITE

DEFAULT_CACHE_DATA_IN_L1

DEFAULT_CACHE_INDEX_ON_WRITE

DEFAULT_BLOCKSIZE

DEFAULT_BLOOMFILTER

DEFAULT_CACHE_BLOOMS_ON_WRITE

DEFAULT_TTL

DEFAULT_REPLICATION_SCOPE

DEFAULT_EVICT_BLOCKS_ON_CLOSE

DEFAULT_COMPRESS_TAGS

DEFAULT_PREFETCH_BLOCKS_ON_OPEN

Constructor Detail

HColumnDescriptor

HColumnDescriptor

HColumnDescriptor

Method Detail

isLegalFamilyName

getName

getNameAsString

getValue

getValue

getValues

setValue

remove

setValue

getCompression

getCompactionCompression

getMaxVersions

setMaxVersions

setVersions

getBlocksize