Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

HDDS-11931. [Website v2] [Docs] [User Guide] Impala Integration. #113

Open
wants to merge 2 commits into
base: HDDS-9225-website-v2
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 39 additions & 1 deletion docs/04-user-guide/03-integrations/04-impala.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,41 @@
# Impala

**TODO:** File a subtask under [HDDS-9858](https://issues.apache.org/jira/browse/HDDS-9858) and complete this page or section.
Starting with version **4.2.0**, Apache Impala provides full support for
querying data stored in **Apache Ozone**. To utilize this functionality,
ensure that your Ozone version is **1.4.0** or later.

## Supported Access Protocols

Impala supports the following protocols for accessing Ozone data:

* ofs
* s3a

Note: The o3fs protocol is **NOT** supported by Impala.

## Supported Bucket Types

Impala is compatible with Ozone buckets configured with either:

* RATIS (Replication)
* Erasure Coding

## Querying Ozone Data with Impala

**If Ozone is configured as the default file system**, you can run Impala
queries seamlessly without modifications, just as if the file system were
HDFS. For example:

```sql
CREATE TABLE t1 (x INT, s STRING);
```

**If Ozone is not the default file system**, you must specify the Ozone path
explicitly using the LOCATION clause. For example:

```sql
CREATE DATABASE d1 LOCATION 'ofs://ozone1/vol1/bucket1/d1.db';
```

For additional information, consult the Apache Impala User Documentation
[Using Impala with Apache Ozone Storage](https://impala.apache.org/docs/build/html/topics/impala_ozone.html).
Loading