79 lines
3.5 KiB
Markdown
79 lines
3.5 KiB
Markdown
<!--
|
|
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.
|
|
-->
|
|
|
|
# Apache Hudi (Incubating)
|
|
Apache Hudi (Incubating) (pronounced Hoodie) stands for `Hadoop Upserts Deletes and Incrementals`.
|
|
Hudi manages the storage of large analytical datasets on DFS (Cloud stores, HDFS or any Hadoop FileSystem compatible storage).
|
|
|
|
<https://hudi.apache.org/>
|
|
|
|
[](https://travis-ci.org/apache/incubator-hudi)
|
|
[](https://www.apache.org/licenses/LICENSE-2.0.html)
|
|
[](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.apache.hudi%22)
|
|
[](https://join.slack.com/t/apache-hudi/shared_invite/enQtODYyNDAxNzc5MTg2LTE5OTBlYmVhYjM0N2ZhOTJjOWM4YzBmMWU2MjZjMGE4NDc5ZDFiOGQ2N2VkYTVkNzU3ZDQ4OTI1NmFmYWQ0NzE)
|
|
|
|
## Features
|
|
* Upsert support with fast, pluggable indexing
|
|
* Atomically publish data with rollback support
|
|
* Snapshot isolation between writer & queries
|
|
* Savepoints for data recovery
|
|
* Manages file sizes, layout using statistics
|
|
* Async compaction of row & columnar data
|
|
* Timeline metadata to track lineage
|
|
|
|
Hudi supports three types of queries:
|
|
* **Snapshot Query** - Provides snapshot queries on real-time data, using a combination of columnar & row-based storage (e.g [Parquet](https://parquet.apache.org/) + [Avro](https://avro.apache.org/docs/current/mr.html)).
|
|
* **Incremental Query** - Provides a change stream with records inserted or updated after a point in time.
|
|
* **Read Optimized Query** - Provides excellent snapshot query performance via purely columnar storage (e.g. [Parquet](https://parquet.apache.org/)).
|
|
|
|
Learn more about Hudi at [https://hudi.apache.org](https://hudi.apache.org)
|
|
|
|
## Building Apache Hudi from source
|
|
|
|
Prerequisites for building Apache Hudi:
|
|
|
|
* Unix-like system (like Linux, Mac OS X)
|
|
* Java 8 (Java 9 or 10 may work)
|
|
* Git
|
|
* Maven
|
|
|
|
```
|
|
# Checkout code and build
|
|
git clone https://github.com/apache/incubator-hudi.git && cd incubator-hudi
|
|
mvn clean package -DskipTests -DskipITs
|
|
```
|
|
|
|
To build the Javadoc for all Java and Scala classes:
|
|
```
|
|
# Javadoc generated under target/site/apidocs
|
|
mvn clean javadoc:aggregate -Pjavadocs
|
|
```
|
|
|
|
### Build with Scala 2.12
|
|
|
|
The default Scala version supported is 2.11. To build for Scala 2.12 version, after code checkout run dev/change-scala-version.sh
|
|
and build using `scala-2.12` profile
|
|
|
|
```
|
|
dev/change-scala-version 2.12
|
|
mvn clean package -DskipTests -DskipITs -Pscala-2.12
|
|
```
|
|
|
|
## Quickstart
|
|
|
|
Please visit [https://hudi.apache.org/docs/quick-start-guide.html](https://hudi.apache.org/docs/quick-start-guide.html) to quickly explore Hudi's capabilities using spark-shell.
|