# Impala Interactive Shell
You can use the Impala shell tool (impala-shell) to connect to an Impala
service. The shell allows you to set up databases and tables, insert data,
and issue queries. For ad hoc queries and exploration, you can submit SQL
statements in an interactive session. The impala-shell interpreter accepts
all the same SQL statements listed in
[Impala SQL Statements](http://impala.apache.org/docs/build/html/topics/impala_langref_sql.html),
plus some shell-only commands that you can use for tuning performance and
diagnosing problems.
To automate your work, you can specify command-line options to process a single
statement or a script file. (Other avenues for Impala automation via python
are provided by Impyla or ODBC.)
## Installing
```
$ pip install impala-shell
```
## Online documentation
* [Impala Shell Documentation](http://impala.apache.org/docs/build/html/topics/impala_impala_shell.html)
* [Apache Impala Documentation](http://impala.apache.org/impala-docs.html)
## Quickstart
### Non-interactive mode
Processing a single query, e.g., ```show tables```:
```
$ impala-shell -i impalad-host.domain.com -d some_database -q 'show tables'
```
Processing a text file with a series of queries:
```
$ impala-shell -i impalad-host.domain.com -d some_database -f /path/to/queries.sql
```
### Launching the interactive shell
To connect to an impalad host at the default service port (21000):
```
$ impala-shell -i impalad-host.domain.com
Starting Impala Shell without Kerberos authentication
Connected to impalad-host.domain.com:21000
Server version: impalad version 2.11.0-SNAPSHOT RELEASE (build d4596f9ca3ea32a8008cdc809a7ac9a3dea47962)
***********************************************************************************
Welcome to the Impala shell.
(Impala Shell v3.0.0-SNAPSHOT (73e90d2) built on Thu Mar 8 00:59:00 PST 2018)
The '-B' command line flag turns off pretty-printing for query results. Use this
flag to remove formatting from results you want to save for later, or to benchmark
Impala.
***********************************************************************************
[impalad-host.domain.com:21000] >
```
### Launching the interactive shell (secure mode)
To connect to a secure host using kerberos and SSL:
```
$ impala-shell -k --ssl -i impalad-secure-host.domain.com
```
### Disconnecting
To exit the shell when running interactively, press ```Ctrl-D``` at the shell prompt.
Raw data
{
"_id": null,
"home_page": "https://impala.apache.org/",
"name": "impala-shell",
"maintainer": "",
"docs_url": null,
"requires_python": ">2.6",
"maintainer_email": "",
"keywords": "",
"author": "Impala Dev",
"author_email": "dev@impala.apache.org",
"download_url": "https://files.pythonhosted.org/packages/ce/e8/9e22b04314248b3c4177c23fd42e7a7e746b97075e81a32d385cf71d7dec/impala_shell-4.3.0.tar.gz",
"platform": null,
"description": "# Impala Interactive Shell\n\nYou can use the Impala shell tool (impala-shell) to connect to an Impala\nservice. The shell allows you to set up databases and tables, insert data,\nand issue queries. For ad hoc queries and exploration, you can submit SQL\nstatements in an interactive session. The impala-shell interpreter accepts\nall the same SQL statements listed in\n[Impala SQL Statements](http://impala.apache.org/docs/build/html/topics/impala_langref_sql.html),\nplus some shell-only commands that you can use for tuning performance and\ndiagnosing problems.\n\nTo automate your work, you can specify command-line options to process a single\nstatement or a script file. (Other avenues for Impala automation via python\nare provided by Impyla or ODBC.)\n\n## Installing\n\n```\n$ pip install impala-shell\n```\n\n## Online documentation\n\n* [Impala Shell Documentation](http://impala.apache.org/docs/build/html/topics/impala_impala_shell.html)\n* [Apache Impala Documentation](http://impala.apache.org/impala-docs.html)\n\n## Quickstart\n\n### Non-interactive mode\n\nProcessing a single query, e.g., ```show tables```:\n\n```\n$ impala-shell -i impalad-host.domain.com -d some_database -q 'show tables'\n```\n\nProcessing a text file with a series of queries:\n\n```\n$ impala-shell -i impalad-host.domain.com -d some_database -f /path/to/queries.sql\n```\n\n### Launching the interactive shell\n\nTo connect to an impalad host at the default service port (21000):\n\n```\n$ impala-shell -i impalad-host.domain.com\nStarting Impala Shell without Kerberos authentication\nConnected to impalad-host.domain.com:21000\nServer version: impalad version 2.11.0-SNAPSHOT RELEASE (build d4596f9ca3ea32a8008cdc809a7ac9a3dea47962)\n***********************************************************************************\nWelcome to the Impala shell.\n(Impala Shell v3.0.0-SNAPSHOT (73e90d2) built on Thu Mar 8 00:59:00 PST 2018)\n\nThe '-B' command line flag turns off pretty-printing for query results. Use this\nflag to remove formatting from results you want to save for later, or to benchmark\nImpala.\n***********************************************************************************\n[impalad-host.domain.com:21000] >\n```\n\n### Launching the interactive shell (secure mode)\n\nTo connect to a secure host using kerberos and SSL:\n\n```\n$ impala-shell -k --ssl -i impalad-secure-host.domain.com\n```\n\n### Disconnecting\n\nTo exit the shell when running interactively, press ```Ctrl-D``` at the shell prompt.",
"bugtrack_url": null,
"license": "Apache Software License",
"summary": "Impala Shell",
"version": "4.3.0",
"project_urls": {
"Homepage": "https://impala.apache.org/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cee89e22b04314248b3c4177c23fd42e7a7e746b97075e81a32d385cf71d7dec",
"md5": "0ef0fce092feff0cfe5b52c18981f402",
"sha256": "40da38e1c7b9ac71e473a013733475422a7975b0372f0b290f4f562428ab8b77"
},
"downloads": -1,
"filename": "impala_shell-4.3.0.tar.gz",
"has_sig": false,
"md5_digest": "0ef0fce092feff0cfe5b52c18981f402",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">2.6",
"size": 483792,
"upload_time": "2023-10-13T03:52:31",
"upload_time_iso_8601": "2023-10-13T03:52:31.930839Z",
"url": "https://files.pythonhosted.org/packages/ce/e8/9e22b04314248b3c4177c23fd42e7a7e746b97075e81a32d385cf71d7dec/impala_shell-4.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-13 03:52:31",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "impala-shell"
}
JSON