org.apache.nifi.dbcp.hive

Class HiveConnectionPool

java.lang.Object

org.apache.nifi.components.AbstractConfigurableComponent

org.apache.nifi.controller.AbstractControllerService

org.apache.nifi.dbcp.hive.HiveConnectionPool

All Implemented Interfaces:

ConfigurableComponent, ControllerService, DBCPService, HiveDBCPService

@Tags(value={"hive","dbcp","jdbc","database","connection","pooling","store"})
 @CapabilityDescription(value="Provides Database Connection Pooling Service for Apache Hive. Connections can be asked from pool and returned after usage.")
public class HiveConnectionPool
extends AbstractControllerService
implements HiveDBCPService

Implementation for Database Connection Pooling Service used for Apache Hive connections. Apache DBCP is used for connection pooling functionality.

Field Summary

Fields

Modifier and Type	Field and Description
private String	connectionUrl
static PropertyDescriptor	DATABASE_URL
private org.apache.commons.dbcp.BasicDataSource	dataSource
static PropertyDescriptor	DB_PASSWORD
static PropertyDescriptor	DB_USER
static PropertyDescriptor	HIVE_CONFIGURATION_RESOURCES
private HiveConfigurator	hiveConfigurator
private File	kerberosConfigFile
private KerberosProperties	kerberosProperties
static PropertyDescriptor	MAX_TOTAL_CONNECTIONS
static PropertyDescriptor	MAX_WAIT_TIME
private List<PropertyDescriptor>	properties
private static long	TICKET_RENEWAL_PERIOD
private org.apache.hadoop.security.UserGroupInformation	ugi
static PropertyDescriptor	VALIDATION_QUERY
private AtomicReference<ValidationResources>	validationResourceHolder

Constructor Summary

Constructors

Constructor and Description
HiveConnectionPool()

Method Summary

Modifier and Type	Method and Description
protected Collection<ValidationResult>	customValidate(ValidationContext validationContext)
Connection	getConnection()
String	getConnectionURL()
protected List<PropertyDescriptor>	getSupportedPropertyDescriptors()
protected void	init(ControllerServiceInitializationContext context)
void	onConfigured(ConfigurationContext context) Configures connection pool by creating an instance of the BasicDataSource based on configuration provided with ConfigurationContext.
void	shutdown() Shutdown pool, close all open connections.
String	toString()

Methods inherited from class org.apache.nifi.controller.AbstractControllerService

getControllerServiceLookup, getIdentifier, getLogger, getStateManager, initialize

Methods inherited from class org.apache.nifi.components.AbstractConfigurableComponent

equals, getPropertyDescriptor, getPropertyDescriptors, getSupportedDynamicPropertyDescriptor, hashCode, onPropertyModified, validate

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.nifi.controller.ControllerService

initialize

Methods inherited from interface org.apache.nifi.components.ConfigurableComponent

getIdentifier, getPropertyDescriptor, getPropertyDescriptors, onPropertyModified, validate

Field Detail

DATABASE_URL

public static final PropertyDescriptor DATABASE_URL

HIVE_CONFIGURATION_RESOURCES

public static final PropertyDescriptor HIVE_CONFIGURATION_RESOURCES

DB_USER

public static final PropertyDescriptor DB_USER

DB_PASSWORD

public static final PropertyDescriptor DB_PASSWORD

MAX_WAIT_TIME

public static final PropertyDescriptor MAX_WAIT_TIME

MAX_TOTAL_CONNECTIONS

public static final PropertyDescriptor MAX_TOTAL_CONNECTIONS

VALIDATION_QUERY

public static final PropertyDescriptor VALIDATION_QUERY

TICKET_RENEWAL_PERIOD

private static final long TICKET_RENEWAL_PERIOD

See Also:

Constant Field Values

properties

private List<PropertyDescriptor> properties

connectionUrl

private String connectionUrl

validationResourceHolder

private final AtomicReference<ValidationResources> validationResourceHolder

dataSource

private volatile org.apache.commons.dbcp.BasicDataSource dataSource

hiveConfigurator

private volatile HiveConfigurator hiveConfigurator

ugi

private volatile org.apache.hadoop.security.UserGroupInformation ugi

kerberosConfigFile

private volatile File kerberosConfigFile

kerberosProperties

private volatile KerberosProperties kerberosProperties

Constructor Detail

HiveConnectionPool

public HiveConnectionPool()

Method Detail

init

protected void init(ControllerServiceInitializationContext context)

Overrides:

init in class AbstractControllerService

getSupportedPropertyDescriptors

protected List<PropertyDescriptor> getSupportedPropertyDescriptors()

Overrides:

getSupportedPropertyDescriptors in class AbstractConfigurableComponent

customValidate

protected Collection<ValidationResult> customValidate(ValidationContext validationContext)

Overrides:

customValidate in class AbstractConfigurableComponent

onConfigured

@OnEnabled
public void onConfigured(ConfigurationContext context)
                             throws InitializationException

Configures connection pool by creating an instance of the BasicDataSource based on configuration provided with ConfigurationContext.

This operation makes no guarantees that the actual connection could be made since the underlying system may still go off-line during normal operation of the connection pool.

Parameters:

context - the configuration context

Throws:

InitializationException - if unable to create a database connection

shutdown

@OnDisabled
public void shutdown()

Shutdown pool, close all open connections.

getConnection

public Connection getConnection()
                         throws ProcessException

Specified by:

getConnection in interface DBCPService

Throws:

ProcessException

toString

public String toString()

Overrides:

toString in class AbstractConfigurableComponent

getConnectionURL

public String getConnectionURL()

Specified by:

getConnectionURL in interface HiveDBCPService