org.apache.hadoop.hbase.client.ColumnFamilyDescriptor Maven / Gradle / Ivy
/**
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.hadoop.hbase.client;
import java.util.Comparator;
import java.util.HashMap;
import java.util.Map;
import org.apache.hadoop.hbase.KeepDeletedCells;
import org.apache.hadoop.hbase.MemoryCompactionPolicy;
import org.apache.yetus.audience.InterfaceAudience;
import org.apache.hadoop.hbase.io.compress.Compression;
import org.apache.hadoop.hbase.io.encoding.DataBlockEncoding;
import org.apache.hadoop.hbase.regionserver.BloomType;
import org.apache.hadoop.hbase.util.Bytes;
/**
* An ColumnFamilyDescriptor 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.
*
* To construct a new instance, use the {@link ColumnFamilyDescriptorBuilder} methods
* @since 2.0.0
*/
@InterfaceAudience.Public
public interface ColumnFamilyDescriptor {
@InterfaceAudience.Private
static final Comparator COMPARATOR
= (ColumnFamilyDescriptor lhs, ColumnFamilyDescriptor rhs) -> {
int result = Bytes.compareTo(lhs.getName(), rhs.getName());
if (result != 0) {
return result;
}
// punt on comparison for ordering, just calculate difference.
result = lhs.getValues().hashCode() - rhs.getValues().hashCode();
if (result != 0) {
return result;
}
return lhs.getConfiguration().hashCode() - rhs.getConfiguration().hashCode();
};
static final Bytes REPLICATION_SCOPE_BYTES = new Bytes(
Bytes.toBytes(ColumnFamilyDescriptorBuilder.REPLICATION_SCOPE));
@InterfaceAudience.Private
static final Comparator COMPARATOR_IGNORE_REPLICATION = (
ColumnFamilyDescriptor lcf, ColumnFamilyDescriptor rcf) -> {
int result = Bytes.compareTo(lcf.getName(), rcf.getName());
if (result != 0) {
return result;
}
// ColumnFamilyDescriptor.getValues is a immutable map, so copy it and remove
// REPLICATION_SCOPE_BYTES
Map lValues = new HashMap<>();
lValues.putAll(lcf.getValues());
lValues.remove(REPLICATION_SCOPE_BYTES);
Map rValues = new HashMap<>();
rValues.putAll(rcf.getValues());
rValues.remove(REPLICATION_SCOPE_BYTES);
result = lValues.hashCode() - rValues.hashCode();
if (result != 0) {
return result;
}
return lcf.getConfiguration().hashCode() - rcf.getConfiguration().hashCode();
};
/**
* @return The storefile/hfile blocksize for this column family.
*/
int getBlocksize();
/**
* @return bloom filter type used for new StoreFiles in ColumnFamily
*/
BloomType getBloomFilterType();
/**
* @return Compression type setting.
*/
Compression.Algorithm getCompactionCompressionType();
/**
* @return Compression type setting.
*/
Compression.Algorithm getCompressionType();
/**
* @return an unmodifiable map.
*/
Map getConfiguration();
/**
* @param key the key whose associated value is to be returned
* @return accessing the configuration value by key.
*/
String getConfigurationValue(String key);
/**
* @return replication factor set for this CF
*/
short getDFSReplication();
/**
* @return the data block encoding algorithm used in block cache and
* optionally on disk
*/
DataBlockEncoding getDataBlockEncoding();
/**
* @return Return the raw crypto key attribute for the family, or null if not set
*/
byte[] getEncryptionKey();
/**
* @return Return the encryption algorithm in use by this family
*/
String getEncryptionType();
/**
* @return in-memory compaction policy if set for the cf. Returns null if no policy is set for
* for this column family
*/
MemoryCompactionPolicy getInMemoryCompaction();
/**
* @return return the KeepDeletedCells
*/
KeepDeletedCells getKeepDeletedCells();
/**
* @return maximum number of versions
*/
int getMaxVersions();
/**
* @return The minimum number of versions to keep.
*/
int getMinVersions();
/**
* Get the mob compact partition policy for this family
* @return MobCompactPartitionPolicy
*/
MobCompactPartitionPolicy getMobCompactPartitionPolicy();
/**
* 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.
* @return The mob threshold.
*/
long getMobThreshold();
/**
* @return a copy of Name of this column family
*/
byte[] getName();
/**
* @return Name of this column family
*/
String getNameAsString();
/**
* @return the scope tag
*/
int getScope();
/**
* Not using {@code enum} here because HDFS is not using {@code enum} for storage policy, see
* org.apache.hadoop.hdfs.server.blockmanagement.BlockStoragePolicySuite for more details.
* @return Return the storage policy in use by this family
*/
String getStoragePolicy();
/**
* @return Time-to-live of cell contents, in seconds.
*/
int getTimeToLive();
/**
* @param key The key.
* @return A clone value. Null if no mapping for the key
*/
Bytes getValue(Bytes key);
/**
* @param key The key.
* @return A clone value. Null if no mapping for the key
*/
byte[] getValue(byte[] key);
/**
* It clone all bytes of all elements.
* @return All values
*/
Map getValues();
/**
* @return True if hfile DATA type blocks should be cached (You cannot disable caching of INDEX
* and BLOOM type blocks).
*/
boolean isBlockCacheEnabled();
/**
* @return true if we should cache bloomfilter blocks on write
*/
boolean isCacheBloomsOnWrite();
/**
* @return true if we should cache data blocks on write
*/
boolean isCacheDataOnWrite();
/**
* @return true if we should cache index blocks on write
*/
boolean isCacheIndexesOnWrite();
/**
* @return Whether KV tags should be compressed along with DataBlockEncoding. When no
* DataBlockEncoding is been used, this is having no effect.
*/
boolean isCompressTags();
/**
* @return true if we should evict cached blocks from the blockcache on close
*/
boolean isEvictBlocksOnClose();
/**
* @return True if we are to favor keeping all values for this column family in the
* HRegionServer cache.
*/
boolean isInMemory();
/**
* Gets whether the mob is enabled for the family.
* @return True if the mob is enabled for the family.
*/
boolean isMobEnabled();
/**
* @return true if we should prefetch blocks into the blockcache on open
*/
boolean isPrefetchBlocksOnOpen();
/**
* @return Column family descriptor with only the customized attributes.
*/
String toStringCustomizedValues();
/**
* By default, HBase only consider timestamp in versions. So a previous Delete with higher ts
* will mask a later Put with lower ts. Set this to true to enable new semantics of versions.
* We will also consider mvcc in versions. See HBASE-15968 for details.
*/
boolean isNewVersionBehavior();
}