Skip to content

Commit

Permalink
HDDS-11947. [Docs] [User Guide] Impala Integration.
Browse files Browse the repository at this point in the history
Change-Id: Ic09028a519199274093186b611963ebb8bfb7879
  • Loading branch information
jojochuang committed Dec 17, 2024
1 parent 008f9a6 commit 382380d
Show file tree
Hide file tree
Showing 2 changed files with 89 additions and 0 deletions.
63 changes: 63 additions & 0 deletions hadoop-hdds/docs/content/integration/Impala.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
title: Impala
weight: 4
menu:
main:
parent: "Application integrations"
---
<!---
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

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).
26 changes: 26 additions & 0 deletions hadoop-hdds/docs/content/integration/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
title: "Application integrations"
menu:
main:
weight: 5
---
<!---
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

{{<jumbotron title="Application integration">}}
Many applications can be integrated with Ozone through the the Hadoop compatible ofs interface or the S3 interface.
{{</jumbotron>}}

0 comments on commit 382380d

Please sign in to comment.