配置Impala支持JDBC（翻译）

配置Impala支持JDBC

Impala支持JDBC集成。经过使用 JDBC 驱动，你编写的 Java 程序、BI应用、或相似的使用 JDBC 访问不一样数据库产品的工具，能够访问 Impala。创建到 Impala 的 JDBC 链接包括如下步骤：

• 指定可用的通信端口，见配置 JDBC 端口
• 在每台运行 JDBC 应用的机器上安装 JDBC 驱动。见在客户端系统启用 Impala 的 JDBC 支持
• 为 JDBC 应用链接运行 impalad 守护进程的服务器配置链接字符串、以及相应的安全设置。见创建JDBC链接

配置 JDBC 端口

默认的 JDBC 2.0 端口是 21050；Impala 服务器默认经过相同的 21050 端口接收 JDBC 链接。请确认该端口能够与网络中的其余主机通信，例如，没有被防火墙阻断。假如你的 JDBC 客户端软件使用其余端口链接，当启动 Impalad 时使用 --hs2_port 选项指定其余的端口。参见启动 Impala 了解详细信息。

在客户端启用 Impala JDBC 支持

Impala提供 JDBC 客户端驱动，是一个 JAR 包，存在于一个zip压缩文件里(The Impala JDBC integration is made possible by a client-side JDBC driver, which is contained in JAR files within a zip file)。下载该zip文件到每台须要链接到Impala的客户端机器上。

在运行 JDBC 应用的系统上启用 Impala JDBC支持：

1. 下载 Impala JDBC zip file 到将要链接 Imapla 服务器的客户端机器
     Note: For Maven users, see  this sample github page for an example of the dependencies you could add to a pom file instead of downloading the individual JARs.
2. 解压zip文件到指定目录。例如：
   • Linux上能够解压到/opt/jars/.
   • Windows上能够解压到 C:\Program Files 下的子目录
3. 为了成功加载 Impala JDBC 驱动，客户端程序必须能正肯定位这个 JAR 文件。这一般意味着设置 CLASSPATH 包含该 JAR 文件。查阅文档了解如何为你的 JDBC 客户端安装新的 JDBC 驱动，一般设置CLASSPATH 变量以下：
   • Linux上，假如解压 JAR 文件到/opt/jars/，执行如下命令在已有classpath前面添加JAR文件：

     export CLASSPATH=/opt/jars/*.jar:$CLASSPATH

   • Windows上，使用 System Properties 控制面板修改系统的 Environment Variables 。修改变量包含你解压文件的路径。
       注意： 假如在客户端机器上的 CLASSPATH 包含许多旧版本的 Hive JAR 文件，请确保最新的 JAR 文件在是列出的第一个。或者把最新的 JAR 文件放在最前面，或者删掉其余引用的 Hive JAR 文件。

创建 JDBC 链接

Impala JDBC 驱动类是 org.apache.hive.jdbc.HiveDriver。当你已经配置 Impala 支持 JDBC，你能够在二者之间创建链接。使用链接字符串"jdbc:hive2://host:port/;auth=noSasl"，为集群创建不须要 Kerberos 认证的链接。例如：

jdbc:hive2://myhost.example.com:21050/;auth=noSasl

使用链接字符串"jdbc:hive2://host:port/;principal=principal_name"，创建须要 Kerberos 认证的链接。最重要是使用与启动 Impala 相同的用户创建链接(The principal must be the same user principal you used when starting Impala)。例如：

jdbc:hive2://myhost.example.com:21050/;principal=impala/myhost.example.com@H2.EXAMPLE.COM