org.apache.phoenix.query

Class ConnectionQueryServicesImpl

java.lang.Object

org.apache.phoenix.query.DelegateQueryServices

org.apache.phoenix.query.ConnectionQueryServicesImpl

All Implemented Interfaces:

ConnectionQueryServices, MetaDataMutated, QueryServices, SQLCloseable

public class ConnectionQueryServicesImpl
extends DelegateQueryServices
implements ConnectionQueryServices

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.phoenix.query.ConnectionQueryServices

ConnectionQueryServices.Feature

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.hadoop.conf.Configuration	config
protected PhoenixEmbeddedDriver.ConnectionInfo	connectionInfo
static byte[]	UPGRADE_MUTEX
static byte[]	UPGRADE_MUTEX_LOCKED
static byte[]	UPGRADE_MUTEX_UNLOCKED

Fields inherited from interface org.apache.phoenix.query.ConnectionQueryServices

INITIAL_META_DATA_TABLE_CAPACITY

Fields inherited from interface org.apache.phoenix.query.QueryServices

AGGREGATE_CHUNK_SIZE_INCREASE_ATTRIB, ALLOW_LOCAL_INDEX_ATTRIB, ALLOW_ONLINE_TABLE_SCHEMA_UPDATE, ALLOW_USER_DEFINED_FUNCTIONS_ATTRIB, ALLOW_VIEWS_ADD_NEW_CF_BASE_TABLE, AUTO_COMMIT_ATTRIB, AUTO_FLUSH_ATTRIB, AUTO_UPGRADE_ENABLED, AUTO_UPGRADE_WHITELIST_ATTRIB, CALL_QUEUE_PRODUCER_ATTRIB_NAME, CALL_QUEUE_ROUND_ROBIN_ATTRIB, CLIENT_CACHE_ENCODING, CLIENT_CONNECTION_CACHE_MAX_DURATION_MILLISECONDS, CLIENT_CONNECTION_MAX_ALLOWED_CONNECTIONS, CLOCK_SKEW_INTERVAL_ATTRIB, COLLECT_REQUEST_LEVEL_METRICS, COMMIT_STATS_ASYNC, CONSISTENCY_ATTRIB, COPROCESSOR_PRIORITY_ATTRIB, COST_BASED_OPTIMIZER_ENABLED, DATE_FORMAT_ATTRIB, DATE_FORMAT_TIMEZONE_ATTRIB, DEFAULT_COLUMN_ENCODED_BYTES_ATRRIB, DEFAULT_IMMUTABLE_STORAGE_SCHEME_ATTRIB, DEFAULT_MULTITENANT_IMMUTABLE_STORAGE_SCHEME_ATTRIB, DEFAULT_STORE_NULLS_ATTRIB, DEFAULT_SYSTEM_KEEP_DELETED_CELLS_ATTRIB, DEFAULT_SYSTEM_MAX_VERSIONS_ATTRIB, DEFAULT_TABLE_ISTRANSACTIONAL_ATTRIB, DEFAULT_TRANSACTION_PROVIDER_ATTRIB, DEFAULT_UPDATE_CACHE_FREQUENCY_ATRRIB, DELAY_FOR_SCHEMA_UPDATE_CHECK, DISTINCT_VALUE_COMPRESS_THRESHOLD_ATTRIB, DRIVER_SHUTDOWN_TIMEOUT_MS, DROP_METADATA_ATTRIB, DYNAMIC_JARS_DIR_KEY, ENABLE_SERVER_UPSERT_SELECT, EXPLAIN_CHUNK_COUNT_ATTRIB, EXPLAIN_ROW_COUNT_ATTRIB, EXTRA_JDBC_ARGUMENTS_ATTRIB, FORCE_ROW_KEY_ORDER_ATTRIB, GLOBAL_METRICS_ENABLED, GROUPBY_ESTIMATED_DISTINCT_VALUES_ATTRIB, GROUPBY_MAX_CACHE_SIZE_ATTRIB, GROUPBY_SPILL_FILES_ATTRIB, GROUPBY_SPILLABLE_ATTRIB, HBASE_CLIENT_KEYTAB, HBASE_CLIENT_PRINCIPAL, HBASE_CLIENT_SCANNER_TIMEOUT_ATTRIB, HCONNECTION_POOL_CORE_SIZE, HCONNECTION_POOL_MAX_SIZE, HTABLE_MAX_THREADS, IMMUTABLE_ROWS_ATTRIB, INDEX_ASYNC_BUILD_ENABLED, INDEX_FAILURE_BLOCK_WRITE, INDEX_FAILURE_DISABLE_INDEX, INDEX_FAILURE_HANDLING_REBUILD_ATTRIB, INDEX_FAILURE_HANDLING_REBUILD_INTERVAL_ATTRIB, INDEX_FAILURE_HANDLING_REBUILD_NUMBER_OF_BATCHES_PER_TABLE, INDEX_FAILURE_HANDLING_REBUILD_OVERLAP_BACKWARD_TIME_ATTRIB, INDEX_FAILURE_HANDLING_REBUILD_OVERLAP_FORWARD_TIME_ATTRIB, INDEX_FAILURE_HANDLING_REBUILD_OVERLAP_TIME_ATTRIB, INDEX_FAILURE_HANDLING_REBUILD_PERIOD, INDEX_FAILURE_KILL_SERVER, INDEX_FAILURE_THROW_EXCEPTION_ATTRIB, INDEX_HANDLER_COUNT_ATTRIB, INDEX_MUTATE_BATCH_SIZE_THRESHOLD_ATTRIB, INDEX_PENDING_DISABLE_THRESHOLD, INDEX_POPULATION_SLEEP_TIME, INDEX_PRIOIRTY_ATTRIB, INDEX_REBUILD_CLIENT_SCANNER_TIMEOUT_ATTRIB, INDEX_REBUILD_DISABLE_TIMESTAMP_THRESHOLD, INDEX_REBUILD_QUERY_TIMEOUT_ATTRIB, INDEX_REBUILD_RPC_RETRIES_COUNTER, INDEX_REBUILD_RPC_RETRY_PAUSE_TIME, INDEX_REBUILD_RPC_TIMEOUT_ATTRIB, INDEX_REBUILD_TASK_INITIAL_DELAY, IS_NAMESPACE_MAPPING_ENABLED, IS_SYSTEM_TABLE_MAPPED_TO_NAMESPACE, KEEP_ALIVE_MS_ATTRIB, LIMITED_QUERY_SERIAL_THRESHOLD, LOCAL_INDEX_CLIENT_UPGRADE_ATTRIB, LOG_BUFFER_SIZE, LOG_BUFFER_WAIT_STRATEGY, LOG_LEVEL, LOG_SALT_BUCKETS_ATTRIB, LOG_SAMPLE_RATE, MASTER_INFO_PORT_ATTRIB, MAX_CLIENT_METADATA_CACHE_SIZE_ATTRIB, MAX_INDEXES_PER_TABLE, MAX_MEMORY_PERC_ATTRIB, MAX_MEMORY_SIZE_ATTRIB, MAX_MUTATION_SIZE_ATTRIB, MAX_MUTATION_SIZE_BYTES_ATTRIB, MAX_SERVER_CACHE_SIZE_ATTRIB, MAX_SERVER_CACHE_TIME_TO_LIVE_MS_ATTRIB, MAX_SERVER_METADATA_CACHE_SIZE_ATTRIB, MAX_SERVER_METADATA_CACHE_TIME_TO_LIVE_MS_ATTRIB, MAX_SPOOL_TO_DISK_BYTES_ATTRIB, MAX_TENANT_MEMORY_PERC_ATTRIB, MAX_VERSIONS_TRANSACTIONAL_ATTRIB, METADATA_HANDLER_COUNT_ATTRIB, METADATA_PRIOIRTY_ATTRIB, METADATA_WRITE_RETRIES_NUMBER, METADATA_WRITE_RETRY_PAUSE, MIN_STATS_UPDATE_FREQ_MS_ATTRIB, MUTATE_BATCH_SIZE_ATTRIB, MUTATE_BATCH_SIZE_BYTES_ATTRIB, NUM_RETRIES_FOR_SCHEMA_UPDATE_CHECK, NUMBER_FORMAT_ATTRIB, PHOENIX_ACLS_ENABLED, PHOENIX_QUERY_SERVER_CLUSTER_BASE_PATH, PHOENIX_QUERY_SERVER_LOADBALANCER_ENABLED, PHOENIX_QUERY_SERVER_SERVICE_NAME, PHOENIX_QUERY_SERVER_ZK_ACL_PASSWORD, PHOENIX_QUERY_SERVER_ZK_ACL_USERNAME, PROPERTY_POLICY_PROVIDER_ENABLED, QUERY_SERVER_CUSTOM_AUTH_ENABLED, QUERY_SERVER_CUSTOMIZERS_ENABLED, QUERY_SERVER_DISABLE_KERBEROS_LOGIN, QUERY_SERVER_DNS_INTERFACE_ATTRIB, QUERY_SERVER_DNS_NAMESERVER_ATTRIB, QUERY_SERVER_ENV_LOGGING_ATTRIB, QUERY_SERVER_ENV_LOGGING_SKIPWORDS_ATTRIB, QUERY_SERVER_HBASE_SECURITY_CONF_ATTRIB, QUERY_SERVER_HTTP_KEYTAB_FILENAME_ATTRIB, QUERY_SERVER_HTTP_PORT_ATTRIB, QUERY_SERVER_KERBEROS_ALLOWED_REALMS, QUERY_SERVER_KERBEROS_HTTP_PRINCIPAL_ATTRIB, QUERY_SERVER_KERBEROS_HTTP_PRINCIPAL_ATTRIB_LEGACY, QUERY_SERVER_KERBEROS_PRINCIPAL_ATTRIB, QUERY_SERVER_KEYTAB_FILENAME_ATTRIB, QUERY_SERVER_META_FACTORY_ATTRIB, QUERY_SERVER_REMOTEUSEREXTRACTOR_PARAM, QUERY_SERVER_SERIALIZATION_ATTRIB, QUERY_SERVER_SPNEGO_AUTH_DISABLED_ATTRIB, QUERY_SERVER_UGI_CACHE_CONCURRENCY, QUERY_SERVER_UGI_CACHE_INITIAL_SIZE, QUERY_SERVER_UGI_CACHE_MAX_SIZE, QUERY_SERVER_WITH_REMOTEUSEREXTRACTOR_ATTRIB, QUEUE_SIZE_ATTRIB, REGIONSERVER_INFO_PORT_ATTRIB, RENEW_LEASE_ENABLED, RENEW_LEASE_THREAD_POOL_SIZE, RENEW_LEASE_THRESHOLD_MILLISECONDS, RETURN_SEQUENCE_VALUES_ATTRIB, ROW_KEY_ORDER_SALTED_TABLE_ATTRIB, RPC_TIMEOUT_ATTRIB, RUN_RENEW_LEASE_FREQUENCY_INTERVAL_MILLISECONDS, RUN_UPDATE_STATS_ASYNC, SCAN_CACHE_SIZE_ATTRIB, SCAN_RESULT_CHUNK_SIZE, SCHEMA_ATTRIB, SEQUENCE_CACHE_SIZE_ATTRIB, SEQUENCE_SALT_BUCKETS_ATTRIB, SMALL_SCAN_THRESHOLD_ATTRIB, SPOOL_DIRECTORY, SPOOL_THRESHOLD_BYTES_ATTRIB, STATS_COLLECTION_ENABLED, STATS_ENABLED_ATTRIB, STATS_GUIDEPOST_PER_REGION_ATTRIB, STATS_GUIDEPOST_WIDTH_BYTES_ATTRIB, STATS_MAX_CACHE_SIZE, STATS_SERVER_POOL_SIZE, STATS_UPDATE_FREQ_MS_ATTRIB, STATS_USE_CURRENT_TIME_ATTRIB, THREAD_POOL_SIZE_ATTRIB, THREAD_TIMEOUT_MS_ATTRIB, TIME_FORMAT_ATTRIB, TIMESTAMP_FORMAT_ATTRIB, TRACING_BATCH_SIZE, TRACING_CUSTOM_ANNOTATION_ATTRIB_PREFIX, TRACING_ENABLED, TRACING_FREQ_ATTRIB, TRACING_PAGE_SIZE_ATTRIB, TRACING_PROBABILITY_THRESHOLD_ATTRIB, TRACING_STATS_TABLE_NAME_ATTRIB, TRACING_THREAD_POOL_SIZE, TRACING_TRACE_BUFFER_SIZE, TRANSACTIONS_ENABLED, UPLOAD_BINARY_DATA_TYPE_ENCODING, USE_BYTE_BASED_REGEX_ATTRIB, USE_INDEXES_ATTRIB, USE_REVERSE_SCAN_ATTRIB, USE_STATS_FOR_PARALLELIZATION, ZOOKEEPER_PORT_ATTRIB, ZOOKEEPER_QUORUM_ATTRIB, ZOOKEEPER_ROOT_NODE_ATTRIB

Constructor Summary

Constructors

Constructor and Description
ConnectionQueryServicesImpl(QueryServices services, PhoenixEmbeddedDriver.ConnectionInfo connectionInfo, Properties info) Construct a ConnectionQueryServicesImpl that represents a connection to an HBase cluster.

Method Summary

Modifier and Type	Method and Description
boolean	acquireUpgradeMutex(long currentServerSideTableTimestamp, byte[] rowToLock) Acquire distributed mutex of sorts to make sure only one JVM is able to run the upgrade code by making use of HBase's checkAndPut api.
MetaDataProtocol.MetaDataMutationResult	addColumn(List<Mutation> tableMetaData, PTable table, Map<String,List<Pair<String,Object>>> stmtProperties, Set<String> colFamiliesForPColumnsToBeAdded, List<PColumn> columns)
void	addConnection(PhoenixConnection connection)
void	addFunction(PFunction function)
void	addSchema(PSchema schema)
void	addTable(PTable table, long resolvedTime)
void	addTableStats(GuidePostsKey key, GuidePostsInfo info) Manually adds GuidePostsInfo for a table to the client-side cache.
long	clearCache() Clears the Phoenix meta data cache on each region server
void	clearTableFromCache(byte[] tenantId, byte[] schemaName, byte[] tableName, long clientTS)
void	clearTableRegionCache(byte[] tableName)
void	close() Closes the underlying connection to zookeeper.
PhoenixConnection	connect(String url, Properties info)
MetaDataProtocol.MetaDataMutationResult	createFunction(List<Mutation> functionData, PFunction function, boolean temporary)
MetaDataProtocol.MetaDataMutationResult	createSchema(List<Mutation> schemaMutations, String schemaName)
long	createSequence(String tenantId, String schemaName, String sequenceName, long startWith, long incrementBy, long cacheSize, long minValue, long maxValue, boolean cycle, long timestamp)
MetaDataProtocol.MetaDataMutationResult	createTable(List<Mutation> tableMetaData, byte[] physicalTableName, PTableType tableType, Map<String,Object> tableProps, List<Pair<byte[],Map<String,Object>>> families, byte[][] splits, boolean isNamespaceMapped, boolean allocateIndexId, boolean isDoNotUpgradePropSet)
long	currentSequenceValue(SequenceKey sequenceKey, long timestamp) Gets the current sequence value
MetaDataProtocol.MetaDataMutationResult	dropColumn(List<Mutation> tableMetaData, PTableType tableType)
MetaDataProtocol.MetaDataMutationResult	dropFunction(List<Mutation> functionData, boolean ifExists)
MetaDataProtocol.MetaDataMutationResult	dropSchema(List<Mutation> schemaMetaData, String schemaName)
long	dropSequence(String tenantId, String schemaName, String sequenceName, long timestamp)
MetaDataProtocol.MetaDataMutationResult	dropTable(List<Mutation> tableMetaData, PTableType tableType, boolean cascade)
HBaseAdmin	getAdmin()
List<HRegionLocation>	getAllTableRegions(byte[] tableName)
List<LinkedBlockingQueue<WeakReference<PhoenixConnection>>>	getCachedConnections()
ConnectionQueryServices	getChildQueryServices(ImmutableBytesWritable tenantId) Get (and create if necessary) a child QueryService for a given tenantId.
org.apache.hadoop.conf.Configuration	getConfiguration()
MetaDataProtocol.MetaDataMutationResult	getFunctions(PName tenantId, List<Pair<byte[],Long>> functions, long clientTimestamp)
protected String	getFunctionTableDDL()
KeyValueBuilder	getKeyValueBuilder()
protected String	getLogTableDDL()
int	getLowestClusterHBaseVersion()
ReadOnlyProps	getProps() Get the properties from the HBase configuration in a read-only structure that avoids any synchronization
QueryLoggerDisruptor	getQueryDisruptor()
long	getRenewLeaseThresholdMilliSeconds()
MetaDataProtocol.MetaDataMutationResult	getSchema(String schemaName, long clientTimestamp)
int	getSequenceSaltBuckets()
protected String	getSystemCatalogTableDDL()
protected String	getSystemSequenceTableDDL(int nSaltBuckets)
protected long	getSystemTableVersion()
HTableInterface	getTable(byte[] tableName) Get an HTableInterface by the given name.
MetaDataProtocol.MetaDataMutationResult	getTable(PName tenantId, byte[] schemaBytes, byte[] tableBytes, long tableTimestamp, long clientTimestamp)
HTableDescriptor	getTableDescriptor(byte[] tableName)
HRegionLocation	getTableRegionLocation(byte[] tableName, byte[] row)
GuidePostsInfo	getTableStats(GuidePostsKey key)
User	getUser()
String	getUserName()
boolean	hasIndexWALCodec()
void	incrementSequences(List<SequenceAllocation> sequenceAllocations, long timestamp, long[] values, SQLException[] exceptions) Increment any of the set of sequences that need more values.
void	init(String url, Properties props)
PhoenixTransactionClient	initTransactionClient(TransactionFactory.Provider provider)
void	invalidateStats(GuidePostsKey key) Removes cache GuidePostsInfo for the table with the given name.
protected boolean	isInitialized()
boolean	isRenewingLeasesEnabled()
boolean	isUpgradeRequired()
protected ConnectionQueryServices	newChildQueryService()
boolean	releaseUpgradeMutex(byte[] mutexRowKey)
void	removeColumn(PName tenantId, String tableName, List<PColumn> columnsToRemove, long tableTimeStamp, long tableSeqNum, long resolvedTime)
void	removeConnection(PhoenixConnection connection)
void	removeFunction(PName tenantId, String function, long functionTimeStamp)
void	removeSchema(PSchema schema, long schemaTimeStamp)
void	removeTable(PName tenantId, String tableName, String parentTableName, long tableTimeStamp)
void	returnSequences(List<SequenceKey> keys, long timestamp, SQLException[] exceptions)
protected void	setInitialized(boolean isInitialized)
protected void	setUpgradeRequired()
boolean	supportsFeature(ConnectionQueryServices.Feature feature)
MutationState	updateData(MutationPlan plan)
MetaDataProtocol.MetaDataMutationResult	updateIndexState(List<Mutation> tableMetaData, String parentTableName)
MetaDataProtocol.MetaDataMutationResult	updateIndexState(List<Mutation> tableMetaData, String parentTableName, Map<String,List<Pair<String,Object>>> stmtProperties, PTable table)
void	updateResolvedTimestamp(PTable table, long resolvedTime)
protected PhoenixConnection	upgradeSystemCatalogIfRequired(PhoenixConnection metaConnection, long currentServerSideTableTimeStamp) Upgrade the SYSCAT schema if required
void	upgradeSystemTables(String url, Properties props) There is no other locking needed here since only one connection (on the same or different JVM) will be able to acquire the upgrade mutex via acquireUpgradeMutex(long, byte[]).
void	validateSequences(List<SequenceAllocation> sequenceAllocations, long timestamp, long[] values, SQLException[] exceptions, Sequence.ValueOp action) Verifies that sequences exist and reserves values for them if reserveValues is true

Methods inherited from class org.apache.phoenix.query.DelegateQueryServices

getDelegate, getExecutor, getMemoryManager, getOptimizer

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.phoenix.query.QueryServices

getExecutor, getMemoryManager, getOptimizer

Field Detail

config

protected final org.apache.hadoop.conf.Configuration config

connectionInfo

protected final PhoenixEmbeddedDriver.ConnectionInfo connectionInfo

UPGRADE_MUTEX

public static final byte[] UPGRADE_MUTEX

UPGRADE_MUTEX_LOCKED

public static final byte[] UPGRADE_MUTEX_LOCKED

UPGRADE_MUTEX_UNLOCKED

public static final byte[] UPGRADE_MUTEX_UNLOCKED

Constructor Detail

ConnectionQueryServicesImpl

public ConnectionQueryServicesImpl(QueryServices services,
                                   PhoenixEmbeddedDriver.ConnectionInfo connectionInfo,
                                   Properties info)

Construct a ConnectionQueryServicesImpl that represents a connection to an HBase cluster.

Parameters:

services - base services from where we derive our default configuration

connectionInfo - to provide connection information

info - hbase configuration properties

Throws:

SQLException

Method Detail

getTable

public HTableInterface getTable(byte[] tableName)
                         throws SQLException

Description copied from interface: ConnectionQueryServices

Get an HTableInterface by the given name. It is the callers responsibility to close the returned HTableInterface.

Specified by:

getTable in interface ConnectionQueryServices

Parameters:

tableName - the name of the HTable

Returns:

the HTableInterface

Throws:

SQLException

getTableDescriptor

public HTableDescriptor getTableDescriptor(byte[] tableName)
                                    throws SQLException

Specified by:

getTableDescriptor in interface ConnectionQueryServices

Throws:

SQLException

getProps

public ReadOnlyProps getProps()

Description copied from interface: QueryServices

Get the properties from the HBase configuration in a read-only structure that avoids any synchronization

Specified by:

getProps in interface QueryServices

Overrides:

getProps in class DelegateQueryServices

close

public void close()
           throws SQLException

Closes the underlying connection to zookeeper. The QueryServices may not be used after that point. When a Connection is closed, this is not called, since these instances are pooled by the Driver. Instead, the Driver should call this if the QueryServices is ever removed from the pool

Specified by:

close in interface SQLCloseable

Overrides:

close in class DelegateQueryServices

Throws:

SQLException

newChildQueryService

protected ConnectionQueryServices newChildQueryService()

getChildQueryServices

public ConnectionQueryServices getChildQueryServices(ImmutableBytesWritable tenantId)

Get (and create if necessary) a child QueryService for a given tenantId. The QueryService will be cached for the lifetime of the parent QueryService

Specified by:

getChildQueryServices in interface ConnectionQueryServices

Parameters:

tenantId - the tenant ID

Returns:

the child QueryService

clearTableRegionCache

public void clearTableRegionCache(byte[] tableName)
                           throws SQLException

Specified by:

clearTableRegionCache in interface ConnectionQueryServices

Throws:

SQLException

getAllTableRegions

public List<HRegionLocation> getAllTableRegions(byte[] tableName)
                                         throws SQLException

Specified by:

getAllTableRegions in interface ConnectionQueryServices

Throws:

SQLException

addTable

public void addTable(PTable table,
                     long resolvedTime)
              throws SQLException

Specified by:

addTable in interface MetaDataMutated

Throws:

SQLException

updateResolvedTimestamp

public void updateResolvedTimestamp(PTable table,
                                    long resolvedTime)
                             throws SQLException

Specified by:

updateResolvedTimestamp in interface MetaDataMutated

Throws:

SQLException

removeTable

public void removeTable(PName tenantId,
                        String tableName,
                        String parentTableName,
                        long tableTimeStamp)
                 throws SQLException

Specified by:

removeTable in interface MetaDataMutated

Throws:

SQLException

removeColumn

public void removeColumn(PName tenantId,
                         String tableName,
                         List<PColumn> columnsToRemove,
                         long tableTimeStamp,
                         long tableSeqNum,
                         long resolvedTime)
                  throws SQLException

Specified by:

removeColumn in interface MetaDataMutated

Throws:

SQLException

connect

public PhoenixConnection connect(String url,
                                 Properties info)
                          throws SQLException

Specified by:

connect in interface ConnectionQueryServices

Throws:

SQLException

createTable

public MetaDataProtocol.MetaDataMutationResult createTable(List<Mutation> tableMetaData,
                                                           byte[] physicalTableName,
                                                           PTableType tableType,
                                                           Map<String,Object> tableProps,
                                                           List<Pair<byte[],Map<String,Object>>> families,
                                                           byte[][] splits,
                                                           boolean isNamespaceMapped,
                                                           boolean allocateIndexId,
                                                           boolean isDoNotUpgradePropSet)
                                                    throws SQLException

Specified by:

createTable in interface ConnectionQueryServices

Throws:

SQLException

getTable

public MetaDataProtocol.MetaDataMutationResult getTable(PName tenantId,
                                                        byte[] schemaBytes,
                                                        byte[] tableBytes,
                                                        long tableTimestamp,
                                                        long clientTimestamp)
                                                 throws SQLException

Specified by:

getTable in interface ConnectionQueryServices

Throws:

SQLException

dropTable

public MetaDataProtocol.MetaDataMutationResult dropTable(List<Mutation> tableMetaData,
                                                         PTableType tableType,
                                                         boolean cascade)
                                                  throws SQLException

Specified by:

dropTable in interface ConnectionQueryServices

Throws:

SQLException

dropFunction

public MetaDataProtocol.MetaDataMutationResult dropFunction(List<Mutation> functionData,
                                                            boolean ifExists)
                                                     throws SQLException

Specified by:

dropFunction in interface ConnectionQueryServices

Throws:

SQLException

addColumn

public MetaDataProtocol.MetaDataMutationResult addColumn(List<Mutation> tableMetaData,
                                                         PTable table,
                                                         Map<String,List<Pair<String,Object>>> stmtProperties,
                                                         Set<String> colFamiliesForPColumnsToBeAdded,
                                                         List<PColumn> columns)
                                                  throws SQLException

Specified by:

addColumn in interface ConnectionQueryServices

Throws:

SQLException

dropColumn

public MetaDataProtocol.MetaDataMutationResult dropColumn(List<Mutation> tableMetaData,
                                                          PTableType tableType)
                                                   throws SQLException

Specified by:

dropColumn in interface ConnectionQueryServices

Throws:

SQLException

getSystemTableVersion

protected long getSystemTableVersion()

setUpgradeRequired

protected void setUpgradeRequired()

isInitialized

protected boolean isInitialized()

setInitialized

protected void setInitialized(boolean isInitialized)

getSystemCatalogTableDDL

protected String getSystemCatalogTableDDL()

getSystemSequenceTableDDL

protected String getSystemSequenceTableDDL(int nSaltBuckets)

getFunctionTableDDL

protected String getFunctionTableDDL()

getLogTableDDL

protected String getLogTableDDL()

init

public void init(String url,
                 Properties props)
          throws SQLException

Specified by:

init in interface ConnectionQueryServices

Throws:

SQLException

upgradeSystemCatalogIfRequired

protected PhoenixConnection upgradeSystemCatalogIfRequired(PhoenixConnection metaConnection,
                                                           long currentServerSideTableTimeStamp)
                                                    throws SQLException,
                                                           IOException,
                                                           TimeoutException,
                                                           InterruptedException

Upgrade the SYSCAT schema if required

Parameters:

metaConnection -

currentServerSideTableTimeStamp -

Returns:

Phoenix connection object

Throws:

SQLException

IOException

TimeoutException

InterruptedException

upgradeSystemTables

public void upgradeSystemTables(String url,
                                Properties props)
                         throws SQLException

There is no other locking needed here since only one connection (on the same or different JVM) will be able to acquire the upgrade mutex via acquireUpgradeMutex(long, byte[]).

Specified by:

upgradeSystemTables in interface ConnectionQueryServices

Throws:

SQLException

acquireUpgradeMutex

public boolean acquireUpgradeMutex(long currentServerSideTableTimestamp,
                                   byte[] rowToLock)
                            throws IOException,
                                   SQLException

Acquire distributed mutex of sorts to make sure only one JVM is able to run the upgrade code by making use of HBase's checkAndPut api.

Returns:

true if client won the race, false otherwise

Throws:

IOException

SQLException

releaseUpgradeMutex

public boolean releaseUpgradeMutex(byte[] mutexRowKey)
                            throws IOException,
                                   SQLException

Throws:

IOException

SQLException

updateData

public MutationState updateData(MutationPlan plan)
                         throws SQLException

Specified by:

updateData in interface ConnectionQueryServices

Throws:

SQLException

getLowestClusterHBaseVersion

public int getLowestClusterHBaseVersion()

Specified by:

getLowestClusterHBaseVersion in interface ConnectionQueryServices

hasIndexWALCodec

public boolean hasIndexWALCodec()

Specified by:

hasIndexWALCodec in interface ConnectionQueryServices

clearCache

public long clearCache()
                throws SQLException

Clears the Phoenix meta data cache on each region server

Specified by:

clearCache in interface ConnectionQueryServices

Throws:

SQLException

getAdmin

public HBaseAdmin getAdmin()
                    throws SQLException

Specified by:

getAdmin in interface ConnectionQueryServices

Throws:

SQLException

updateIndexState

public MetaDataProtocol.MetaDataMutationResult updateIndexState(List<Mutation> tableMetaData,
                                                                String parentTableName)
                                                         throws SQLException

Specified by:

updateIndexState in interface ConnectionQueryServices

Throws:

SQLException

updateIndexState

public MetaDataProtocol.MetaDataMutationResult updateIndexState(List<Mutation> tableMetaData,
                                                                String parentTableName,
                                                                Map<String,List<Pair<String,Object>>> stmtProperties,
                                                                PTable table)
                                                         throws SQLException

Specified by:

updateIndexState in interface ConnectionQueryServices

Throws:

SQLException

createSequence

public long createSequence(String tenantId,
                           String schemaName,
                           String sequenceName,
                           long startWith,
                           long incrementBy,
                           long cacheSize,
                           long minValue,
                           long maxValue,
                           boolean cycle,
                           long timestamp)
                    throws SQLException

Specified by:

createSequence in interface ConnectionQueryServices

Throws:

SQLException

dropSequence

public long dropSequence(String tenantId,
                         String schemaName,
                         String sequenceName,
                         long timestamp)
                  throws SQLException

Specified by:

dropSequence in interface ConnectionQueryServices

Throws:

SQLException

currentSequenceValue

public long currentSequenceValue(SequenceKey sequenceKey,
                                 long timestamp)
                          throws SQLException

Gets the current sequence value

Specified by:

currentSequenceValue in interface ConnectionQueryServices

Throws:

SQLException - if cached sequence cannot be found

validateSequences

public void validateSequences(List<SequenceAllocation> sequenceAllocations,
                              long timestamp,
                              long[] values,
                              SQLException[] exceptions,
                              Sequence.ValueOp action)
                       throws SQLException

Verifies that sequences exist and reserves values for them if reserveValues is true

Specified by:

validateSequences in interface ConnectionQueryServices

Throws:

SQLException

incrementSequences

public void incrementSequences(List<SequenceAllocation> sequenceAllocations,
                               long timestamp,
                               long[] values,
                               SQLException[] exceptions)
                        throws SQLException

Increment any of the set of sequences that need more values. These are the sequences that are asking for the next value within a given statement. The returned sequences are the ones that were not found because they were deleted by another client.

Specified by:

incrementSequences in interface ConnectionQueryServices

Parameters:

sequenceKeys - sorted list of sequence kyes

timestamp -

Throws:

SQLException - if any of the sequences cannot be found

clearTableFromCache

public void clearTableFromCache(byte[] tenantId,
                                byte[] schemaName,
                                byte[] tableName,
                                long clientTS)
                         throws SQLException

Specified by:

clearTableFromCache in interface ConnectionQueryServices

Throws:

SQLException

returnSequences

public void returnSequences(List<SequenceKey> keys,
                            long timestamp,
                            SQLException[] exceptions)
                     throws SQLException

Specified by:

returnSequences in interface ConnectionQueryServices

Throws:

SQLException

addConnection

public void addConnection(PhoenixConnection connection)
                   throws SQLException

Specified by:

addConnection in interface ConnectionQueryServices

Throws:

SQLException

removeConnection

public void removeConnection(PhoenixConnection connection)
                      throws SQLException

Specified by:

removeConnection in interface ConnectionQueryServices

Throws:

SQLException

getKeyValueBuilder

public KeyValueBuilder getKeyValueBuilder()

Specified by:

getKeyValueBuilder in interface ConnectionQueryServices

Returns:

the KeyValueBuilder that is valid for the locally installed version of HBase.

supportsFeature

public boolean supportsFeature(ConnectionQueryServices.Feature feature)

Specified by:

supportsFeature in interface ConnectionQueryServices

getUserName

public String getUserName()

Specified by:

getUserName in interface ConnectionQueryServices

getUser

public User getUser()

Specified by:

getUser in interface ConnectionQueryServices

getTableStats

public GuidePostsInfo getTableStats(GuidePostsKey key)
                             throws SQLException

Specified by:

getTableStats in interface ConnectionQueryServices

Throws:

SQLException

getSequenceSaltBuckets

public int getSequenceSaltBuckets()

Specified by:

getSequenceSaltBuckets in interface ConnectionQueryServices

addFunction

public void addFunction(PFunction function)
                 throws SQLException

Specified by:

addFunction in interface MetaDataMutated

Throws:

SQLException

removeFunction

public void removeFunction(PName tenantId,
                           String function,
                           long functionTimeStamp)
                    throws SQLException

Specified by:

removeFunction in interface MetaDataMutated

Throws:

SQLException

getFunctions

public MetaDataProtocol.MetaDataMutationResult getFunctions(PName tenantId,
                                                            List<Pair<byte[],Long>> functions,
                                                            long clientTimestamp)
                                                     throws SQLException

Specified by:

getFunctions in interface ConnectionQueryServices

Throws:

SQLException

getSchema

public MetaDataProtocol.MetaDataMutationResult getSchema(String schemaName,
                                                         long clientTimestamp)
                                                  throws SQLException

Specified by:

getSchema in interface ConnectionQueryServices

Throws:

SQLException

createFunction

public MetaDataProtocol.MetaDataMutationResult createFunction(List<Mutation> functionData,
                                                              PFunction function,
                                                              boolean temporary)
                                                       throws SQLException

Specified by:

createFunction in interface ConnectionQueryServices

Throws:

SQLException

getRenewLeaseThresholdMilliSeconds

public long getRenewLeaseThresholdMilliSeconds()

Specified by:

getRenewLeaseThresholdMilliSeconds in interface ConnectionQueryServices

isRenewingLeasesEnabled

public boolean isRenewingLeasesEnabled()

Specified by:

isRenewingLeasesEnabled in interface ConnectionQueryServices

getTableRegionLocation

public HRegionLocation getTableRegionLocation(byte[] tableName,
                                              byte[] row)
                                       throws SQLException

Specified by:

getTableRegionLocation in interface ConnectionQueryServices

Throws:

SQLException

createSchema

public MetaDataProtocol.MetaDataMutationResult createSchema(List<Mutation> schemaMutations,
                                                            String schemaName)
                                                     throws SQLException

Specified by:

createSchema in interface ConnectionQueryServices

Throws:

SQLException

addSchema

public void addSchema(PSchema schema)
               throws SQLException

Specified by:

addSchema in interface MetaDataMutated

Throws:

SQLException

removeSchema

public void removeSchema(PSchema schema,
                         long schemaTimeStamp)

Specified by:

removeSchema in interface MetaDataMutated

dropSchema

public MetaDataProtocol.MetaDataMutationResult dropSchema(List<Mutation> schemaMetaData,
                                                          String schemaName)
                                                   throws SQLException

Specified by:

dropSchema in interface ConnectionQueryServices

Throws:

SQLException

addTableStats

public void addTableStats(GuidePostsKey key,
                          GuidePostsInfo info)

Manually adds GuidePostsInfo for a table to the client-side cache. Not a ConnectionQueryServices method. Exposed for testing purposes.

Parameters:

tableName - Table name

stats - Stats instance

invalidateStats

public void invalidateStats(GuidePostsKey key)

Description copied from interface: ConnectionQueryServices

Removes cache GuidePostsInfo for the table with the given name. If no cached guideposts are present, this does nothing.

Specified by:

invalidateStats in interface ConnectionQueryServices

isUpgradeRequired

public boolean isUpgradeRequired()

Specified by:

isUpgradeRequired in interface ConnectionQueryServices

getConfiguration

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

Specified by:

getConfiguration in interface ConnectionQueryServices

getQueryDisruptor

public QueryLoggerDisruptor getQueryDisruptor()

Specified by:

getQueryDisruptor in interface ConnectionQueryServices

initTransactionClient

public PhoenixTransactionClient initTransactionClient(TransactionFactory.Provider provider)

Specified by:

initTransactionClient in interface ConnectionQueryServices

getCachedConnections

public List<LinkedBlockingQueue<WeakReference<PhoenixConnection>>> getCachedConnections()