org.apache.kyuubi.jdbc.hive

Class Utils

java.lang.Object

org.apache.kyuubi.jdbc.hive.Utils

public class Utils
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	HADOOP_CONFIGURATION_CLASS
static String	HADOOP_SECURITY_CREDENTIAL_PATH
static String	HIVE_SERVER2_RETRY_FALSE
static String	HIVE_SERVER2_RETRY_KEY
static String	HIVE_SERVER2_RETRY_TRUE
static String	KYUUBI_CLIENT_VERSION_KEY
static Pattern	KYUUBI_OPERATION_HINT_PATTERN
static List<String>	URL_PREFIX_LIST The required prefix list for the connection URL.

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Modifier and Type	Method and Description
static JdbcConnectionParams	extractURLComponents(String uri, Properties info) This method handles the base parsing of the given jdbc uri.
static String	getCanonicalHostName(String hostName) Method to get canonical-ized hostname, given a hostname (possibly a CNAME).
static String	getPassword(Map<String,String> confMap, String key) Method to get the password from the configuration map if available.
static String	getVersion()
static boolean	isKyuubiOperationHint(String hint)
static String	parsePropertyFromUrl(String url, String key)
static JdbcConnectionParams	parseURL(String uri)
static JdbcConnectionParams	parseURL(String uri, Properties info) Parse JDBC connection URL The new format of the URL is: jdbc:hive2://:,:/dbName;sess_var_list?hive_conf_list#hive_var_list where the optional sess, conf and var lists are semicolon separated = pairs.
static String	updateSql(String sql, HashMap<Integer,String> parameters) update the SQL string with parameters set by setXXX methods of PreparedStatement

Methods inherited from class java.lang.Object

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

Field Detail

URL_PREFIX_LIST

public static final List<String> URL_PREFIX_LIST

The required prefix list for the connection URL.

HIVE_SERVER2_RETRY_KEY

public static final String HIVE_SERVER2_RETRY_KEY

See Also:

Constant Field Values

HIVE_SERVER2_RETRY_TRUE

public static final String HIVE_SERVER2_RETRY_TRUE

See Also:

Constant Field Values

HIVE_SERVER2_RETRY_FALSE

public static final String HIVE_SERVER2_RETRY_FALSE

See Also:

Constant Field Values

HADOOP_CONFIGURATION_CLASS

public static final String HADOOP_CONFIGURATION_CLASS

See Also:

Constant Field Values

HADOOP_SECURITY_CREDENTIAL_PATH

public static final String HADOOP_SECURITY_CREDENTIAL_PATH

See Also:

Constant Field Values

KYUUBI_OPERATION_HINT_PATTERN

public static final Pattern KYUUBI_OPERATION_HINT_PATTERN

KYUUBI_CLIENT_VERSION_KEY

public static final String KYUUBI_CLIENT_VERSION_KEY

See Also:

Constant Field Values

Constructor Detail

Utils

public Utils()

Method Detail

updateSql

public static String updateSql(String sql,
                               HashMap<Integer,String> parameters)
                        throws SQLException

update the SQL string with parameters set by setXXX methods of PreparedStatement

Throws:

SQLException

parseURL

public static JdbcConnectionParams parseURL(String uri)
                                     throws JdbcUriParseException,
                                            SQLException,
                                            ZooKeeperHiveClientException

Throws:

JdbcUriParseException

SQLException

ZooKeeperHiveClientException

parseURL

public static JdbcConnectionParams parseURL(String uri,
                                            Properties info)
                                     throws JdbcUriParseException,
                                            SQLException,
                                            ZooKeeperHiveClientException

Parse JDBC connection URL The new format of the URL is: jdbc:hive2://:,:/dbName;sess_var_list?hive_conf_list#hive_var_list where the optional sess, conf and var lists are semicolon separated = pairs. For utilizing dynamic service discovery with HiveServer2 multiple comma separated host:port pairs can be specified as shown above. The JDBC driver resolves the list of uris and picks a specific server instance to connect to. Currently, dynamic service discovery using ZooKeeper is supported, in which case the host:port pairs represent a ZooKeeper ensemble.

As before, if the host/port is not specified, it the driver runs an embedded hive. examples - jdbc:hive2://ubuntu:11000/db2?hive.cli.conf.printheader=true;hive.exec.mode.local.auto.inputbytes.max=9999#stab=salesTable;icol=customerID jdbc:hive2://?hive.cli.conf.printheader=true;hive.exec.mode.local.auto.inputbytes.max=9999#stab=salesTable;icol=customerID jdbc:hive2://ubuntu:11000/db2;user=foo;password=bar

Connect to http://server:10001/hs2, with specified basicAuth credentials and initial database: jdbc:hive2://server:10001/db;user=foo;password=bar?hive.server2.transport.mode=http;hive.server2.thrift.http.path=hs2

Throws:

JdbcUriParseException

SQLException

ZooKeeperHiveClientException

extractURLComponents

public static JdbcConnectionParams extractURLComponents(String uri,
                                                        Properties info)
                                                 throws JdbcUriParseException

This method handles the base parsing of the given jdbc uri. Some of JdbcConnectionParams returned from this method are updated if ZooKeeper is used for service discovery

Throws:

JdbcUriParseException

parsePropertyFromUrl

public static String parsePropertyFromUrl(String url,
                                          String key)

getCanonicalHostName

public static String getCanonicalHostName(String hostName)

Method to get canonical-ized hostname, given a hostname (possibly a CNAME). This should allow for service-principals to use simplified CNAMEs.

Parameters:

hostName - The hostname to be canonical-ized.

Returns:

Given a CNAME, the canonical-ized hostname is returned. If not found, the original hostname is returned.

isKyuubiOperationHint

public static boolean isKyuubiOperationHint(String hint)

getVersion

public static String getVersion()

getPassword

public static String getPassword(Map<String,String> confMap,
                                 String key)

Method to get the password from the configuration map if available. Otherwise, get it from the Hadoop CredentialProvider if Hadoop classes are available

Parameters:

confMap - configuration map

key - param

Returns:

password