Impala Shell Configuration Options
You can specify the following options when starting
control how shell commands are executed. You can specify options on the command line or in the
impala-shell configuration file.
|Configuration File Setting
Causes all query results to be printed in plain format as a delimited text file.
Useful for producing data files to be used with other Hadoop components. Also useful
for avoiding the performance overhead of pretty-printing all output, especially when
running benchmark tests using queries returning large result sets. Specify the
delimiter character with the
Causes all query results to print in vertical format. In this mode, impala-shell will print each row in the following style.
To enable this mode, use the shell option '-E' or '--vertical', or 'set VERTICAL= true' in the interactive mode. To disable it in interactive mode, 'set VERTICAL=false'. NOTE: This vertical option will be disabled if the '-B' option or 'set WRITE_DELIMITED=true' is specified.
|Sets the maximum number of attempts to connect to a coordinator. Currently, the
maximum number of attempts to connect to a coordinator is hard coded to 4 in hs2-HTTP
mode. From this release, you can configure the maximum number of attempts impala-shell
can make using this option
--connect_max_tries. The default value of this option is 4.
After the number of attempts specified through this option, impala-shell returns with
error "Not connected to Impala"
|hs2_fp_format=<a Python-based format specification expression which will get parsed and applied to floating-pointcolumn values>
Sets the printing format specification for floating point values when using HS2 protocol. The default behaviour makes the values handled by Python's str() built-in method. Use '16G' to match Beeswax protocol's floating-point output format.
|Prints a progress bar showing roughly the percentage complete for each query. Information is updated interactively as the query progresses.
|Disables live_progress in the interactive mode.
If set, the setting overrides the expected hostname of the Impala daemon's
Kerberos service principal. impala-shell will check that the
server's principal matches this hostname. This may be used when
-o filename or
Stores all query results in the specified file. Typically used to store the
results of a single query issued from the command line with the
Specifies the character to use as a delimiter between fields when query results
are printed in plain format by the
Displays the query execution plan (same output as the
prettyjson output the JSON
representation of each profile in a dense single-line form and in a human-readable
multi-line form respectively.
Displays help information.
Sets the maximum number of queries to store in the history file.
-i hostname or
Connects to the
-q query or
Passes a query or other impala-shell command from the command
line. The impala-shell interpreter immediately exits after
processing the statement. It is limited to a single statement, which could be a
-f query_file or
Passes a SQL query from a file. Multiple statements must be semicolon (;) delimited.
Kerberos authentication is used when the shell connects to
Sets default query options for an invocation of the impala-shell command. To set multiple query options at once, use more than one instance of this command-line option. The query option names are not case-sensitive.
-s kerberos_service_name or
-V or --verbose
Enables verbose output.
Disables verbose output.
-v or --version
Displays version information.
Continues on query failure.
-d default_db or
Specifies the database to be used on startup. Same as running the
|Enables TLS/SSL for impala-shell.
| Sets the timeout in seconds after which the socket will time out if the
associated operation cannot be completed. Set to None to disable any timeout. This
configurable option is only supported for hs2-http mode and the
DEFAULT is NONE.
| The local pathname pointing to the third-party CA certificate, or to a copy of
the server certificate for self-signed server certificates. If
--ca_cert is not set, impala-shell enables
TLS/SSL, but does not validate the server certificate. This is useful for connecting
to a known-good Impala that is only running over TLS/SSL, when a copy of the
certificate is not available (such as when debugging customer installations).
|Enables LDAP authentication.
| Supplies the username, when LDAP authentication is enabled by the
-l option. (Specify the short username, not the full LDAP
distinguished name.) The shell then prompts interactively for the password.
| Specifies a command to run to retrieve the LDAP password, when LDAP
authentication is enabled by the
-l option. If the command includes
space-separated arguments, enclose the command and its arguments in quotation marks.
|Specifies the path of the file containing impala-shell configuration settings. The default is /etc/impalarc. This setting can only be specified on the command line.
|Prints a progress bar showing roughly the percentage complete for each query. The information is updated interactively as the query progresses.
|Prints a detailed report, similar to the
showing progress details for each phase of query execution. The information is updated
interactively as the query progresses.
| Defines a substitution variable that can be used within the
impala-shell session. The variable can be substituted into
statements processed by the
-f options, or in
an interactive shell session. Within a SQL statement, you substitute the value by
using the notation
|Allows LDAP authentication to be used with an insecure connection to the shell. WARNING: This will allow authentication credentials to be sent unencrypted, and hence may be vulnerable to an attack.
|Protocol to use for the connection to Impala.
Valid protocol values are:
You cannot connect to the 3.2 or earlier versions of Impala using the
Beeswax support is deprecated and will be removed in the future.