Google Git
Sign in
apache / orc / a21ce7f7f3182067829d001eaaeb2c13fb4c9f02
commita21ce7f7f3182067829d001eaaeb2c13fb4c9f02[log] [tgz]
authorDongjoon Hyun <dongjoon@apache.org>Sat Jan 08 17:46:28 2022 -0800
committerGitHub <noreply@github.com>Sat Jan 08 17:46:28 2022 -0800
tree28d9405c0408601921ecbe4937ce7f6302af0fd1
parented41b39290afd95c9b1f4391eb03744e0cc7d21d [diff]
ORC-1079: Add `Linux Clang 11` GitHub Action test coverage (#995) (#1002)

### What changes were proposed in this pull request?

Apache ORC uses `Docker`-based tests to provide `GNU C++` test coverage on `CentOS 7/8`, `Debian 9/10/11`, `Ubuntu 18/20`.

- https://github.com/apache/orc/tree/main/docker

This PR aims to add a new GitHub Action job for `Linux Clang 11.0.0`(Ubuntu) test coverage. Previously, `Clang 7.0.0` test coverage was provided by Travis CI.

**BEFORE (GitHub Action)**
| OS | CXX |
|----|------|
| Ubuntu 20.04 | GNU 9.3.0 |
| MacOS 10.15 | AppleClang 12.0.0 |
| MacOS 11.6 | AppleClang 13.0.0 |
| Windows Server 2019 | MSVC 19.0.24245.0 |

**AFTER (GitHub Action)**
| OS | CXX |
|----|------|
| Ubuntu 20.04 | GNU 9.3.0 |
| **Ubuntu 20.04** | **Clang 11.0.0** |
| MacOS 10.15 | AppleClang 12.0.0 |
| MacOS 11.6 | AppleClang 13.0.0 |
| Windows Server 2019 | MSVC 19.0.24245.0 |

### Why are the changes needed?

After adding this, we can remove the slow `Travis CI` which sometime takes several hours to finish due to the lack of resources.

<img src="https://user-images.githubusercontent.com/9700541/148463375-beef2e9b-61c0-4fb1-bc8f-10b53b854b30.png" width="600">

### How was this patch tested?

Pass the CIs with new `clang++ on Ubuntu` combination.

![Screen Shot 2022-01-06 at 4 25 26 PM](https://user-images.githubusercontent.com/9700541/148471275-2a58ed8e-f322-4808-b6a1-d5d169ed07c0.png)
1 file changed
tree: 28d9405c0408601921ecbe4937ce7f6302af0fd1
  1. .github/
  2. c++/
  3. cmake_modules/
  4. docker/
  5. examples/
  6. java/
  7. proto/
  8. site/
  9. snap/
  10. tools/
  11. .asf.yaml
  12. .gitignore
  13. appveyor.yml
  14. CMakeLists.txt
  15. LICENSE
  16. NOTICE
  17. README.md
README.md

Apache ORC

ORC is a self-describing type-aware columnar file format designed for Hadoop workloads. It is optimized for large streaming reads, but with integrated support for finding required rows quickly. Storing data in a columnar format lets the reader read, decompress, and process only the values that are required for the current query. Because ORC files are type-aware, the writer chooses the most appropriate encoding for the type and builds an internal index as the file is written. Predicate pushdown uses those indexes to determine which stripes in a file need to be read for a particular query and the row indexes can narrow the search to a particular set of 10,000 rows. ORC supports the complete set of types in Hive, including the complex types: structs, lists, maps, and unions.

ORC File Library

This project includes both a Java library and a C++ library for reading and writing the Optimized Row Columnar (ORC) file format. The C++ and Java libraries are completely independent of each other and will each read all versions of ORC files. But the C++ library only writes the original (Hive 0.11) version of ORC files, and will be extended in the future.

Releases:

  • Latest: Apache ORC releases
  • Maven Central: Maven Central
  • Downloads: Apache ORC downloads

The current build status:

  • Master branch master build status
  • Pull Requests

Bug tracking: Apache Jira

The subdirectories are:

  • c++ - the c++ reader and writer
  • cmake_modules - the cmake modules
  • docker - docker scripts to build and test on various linuxes
  • examples - various ORC example files that are used to test compatibility
  • java - the java reader and writer
  • proto - the protocol buffer definition for the ORC metadata
  • site - the website and documentation
  • snap - the script to build snaps of the ORC tools
  • tools - the c++ tools for reading and inspecting ORC files

Building

  • Install java 1.8 or higher
  • Install maven 3 or higher
  • Install cmake

To build a release version with debug information:

% mkdir build
% cd build
% cmake ..
% make package
% make test-out

To build a debug version:

% mkdir build
% cd build
% cmake .. -DCMAKE_BUILD_TYPE=DEBUG
% make package
% make test-out

To build a release version without debug information:

% mkdir build
% cd build
% cmake .. -DCMAKE_BUILD_TYPE=RELEASE
% make package
% make test-out

To build only the Java library:

% cd java
% ./mvnw package

To build only the C++ library:

% mkdir build
% cd build
% cmake .. -DBUILD_JAVA=OFF
% make package
% make test-out