Impala impala-shell 配置选项

命令行选项

配置文件设置

解释

-B或

–定界

write_delimited=true

使所有查询结果以纯格式打印为带分隔符的文本文件。用于生成与其他Hadoop组件一起使用的数据文件。对于避免漂亮打印所有输出的性能开销也很有用，尤其是在使用返回大结果集的查询运行基准测试时。使用–output_delimiter选项指定分隔符。将所有查询结果存储在一个文件中，而不是使用该-B选项打印到屏幕上。在Impala1.0.1中添加。

-b或

–kerberos_host_fqdn

kerberos_host_fqdn=

load-balancer-hostname

如果设置，该设置将覆盖Impala守护进程的Kerberos服务主体的预期主机名。impala-shell将检查服务器的主体是否与此主机名匹配。这可以在impalad配置为通过负载平衡器访问时使用，但希望impala-shellimpalad直接与特定对象对话。

–print_header

print_header=true

-o文件名或

–output_file文件名

output_file=filename

将所有查询结果存储在指定文件中。通常用于存储从带有-q选项的命令行发出的单个查询的结果。也适用于交互式会话；您会看到诸如获取的行数之类的消息，但不会看到实际的结果集。要在组合-q和-o选项时抑制这些附带消息，请重定向stderr到/dev/null。在Impala1.0.1中添加。

–output_delimiter=character

output_delimiter=character

指定在-B选项以纯格式打印查询结果时用作字段之间的分隔符的字符。默认为制表符(‘\t’)。如果输出值包含定界符，则该字段被引用，通过双引号转义，或两者兼而有之。在Impala1.0.1中添加。

-p或

–show_profiles

show_profiles=true

EXPLAIN对于shell执行的每个查询，显示查询执行计划（与语句相同的输出）和执行步骤的更详细的低级细分。

-h或

-帮助

N/A

显示帮助信息。

不适用

history_max=1000

设置要存储在历史文件中的最大查询数。

-i主机名或

–impalad=主机名[：端口编号]

impalad=主机名[：端口编号]

连接到impalad指定主机上的守护进程。除非您提供其他值，否则默认端口为21050。您可以连接到集群中正在运行的任何主机impalad。如果您连接到使用标志impalad指定的备用端口启动的实例–fe_port，请提供该备用端口。

-q查询或

–query=查询

query=query

从命令行传递查询或其他impala-shell命令。该黑斑羚壳解释处理语句后立即退出。它仅限于一个单一的说法，这可能是一个SELECT，CREATETABLE，SHOWTABLES或任何其他声明的认可impala-shell。因为您不能传递USE语句和另一个查询，所以完全限定default数据库外任何表的名称。（或者使用该-f选项传递带有USE语句后跟其他查询的文件。）

-fquery_file或

–query_file=query_file

query_file=path_to_query_file

从文件传递SQL查询。多个语句必须以分号(;)分隔。在Impala2.3及更高版本中，您可以指定一个文件名-来表示标准输入。此功能使将impala-shell用作Unix管道的一部分很方便，其中SQL语句由其他工具动态生成。

–query_option=

“选项=

值”

-Q”选项=

值”

标题行[impala.query_options]，后面的行后面是option=value，每行一个选项。

为impala-shell命令的调用设置默认查询选项。要一次设置多个查询选项，请使用此命令行选项的多个实例。查询选项名称不区分大小写。

-k或

–kerberos

use_kerberos=true

当shell连接到impalad.如果impalad您要连接的实例上未启用Kerberos，则会显示错误。

-skerberos_service_name或

–kerberos_service_name=名称

kerberos_service_name=name

指示impala-shell对特定impalad服务主体进行身份验证。如果未指定kerberos_service_name，impala则默认使用。如果此选项与不支持Kerberos的连接结合使用，则会返回错误。

-V或

—verbose

verbose=true

启用详细输出。

–quiet

verbose=false

禁用详细输出。

-v或

-version

version=true

显示版本信息。

-C

ignore_query_failure=true

在查询失败时继续。

-ddefault_db或

–database=default_db

default_db=default_db

指定要在启动时使用的数据库。与USE连接后运行语句相同。如果未指定，DEFAULT则使用名为的数据库。

-ssl

ssl=true

为impala-shell启用TLS/SSL。

–ca_cert=path_to_certificate

ca_cert=path_to_certificate

指向第三方CA证书或自签名服务器证书的服务器证书副本的本地路径名。如果–ca_cert未设置，impala-shell将启用TLS/SSL，但不会验证服务器证书。当证书副本不可用时（例如调试客户安装时），这对于连接到仅通过TLS/SSL运行的已知良好Impala非常有用。

-这

use_ldap=true

启用LDAP身份验证。

-u

user=USER_NAME

提供用户名，当通过-l选项启用LDAP身份验证时。（指定短用户名，而不是完整的LDAP专有名称。）然后shell以交互方式提示输入密码。

–ldap_password_cmd=命令

N/A

指定要运行以检索LDAP密码的命令，当通过-l选项启用LDAP身份验证时。如果命令包含以空格分隔的参数，请将命令及其参数用引号引起来。

–config_file=path_to_config_file

N/A

指定包含impala-shell配置设置的文件的路径。默认为/etc/impalarc。此设置只能在命令行上指定。

–live_progress

live_progress=true

打印一个进度条，大致显示每个查询的完成百分比。随着查询的进行，信息以交互方式更新。

–disable_live_progress

live_progress=false

命令行标志允许用户在交互模式下禁用live_progress。

–live_summary

N/A

打印详细报告，类似于SUMMARY命令，显示查询执行的每个阶段的进度详细信息。随着查询的进行，信息以交互方式更新。

–var=variable_name=值

N/A

定义可在impala-shell会话中使用的替换变量。该变量可以替换为由-q或-f选项处理的语句，或在交互式shell会话中。在SQL语句中，您可以使用表示法替换该值。此功能在Impala2.5及更高版本中可用。${var:variable_name}

–auth_creds_ok_in_clear

N/A

允许LDAP身份验证与不安全的shell连接一起使用。警告：这将允许以未加密的方式发送身份验证凭据，因此可能容易受到攻击。

–protocol=protocol

N/A

用于连接Impala的协议。

有效的协议值为：

• ‘hs2’：Impala-shell使用基于二进制TCP的传输通过HiveServer2协议与ImpalaDaemon对话。这是当前的默认设置。
• ‘hs2-http’：Impala-shell使用HTTP传输通过HiveServer2协议与ImpalaDaemon对话。
• ‘beeswax’：Impala-shell使用基于二进制TCP的传输通过Beeswax与ImpalaDaemon对话。

您无法使用’hs2’或’hs2-http’选项连接到3.2或更早版本的Impala。

蜂蜡支持已弃用，将来会被删除。