Google Git
Sign in
apache/asterixdb/master
commit
30164fe4b2b72ba0caac6eeed80b4a370a1bdb48
[log] [tgz]
author
Ian Maxon <imaxon@apache.org>
Wed Mar 11 16:20:50 2026 -0700
committer
Ian Maxon <imaxon@apache.org>
Thu Mar 12 15:46:25 2026 +0000
tree
d48c2fad998b07aac0f9642cd3093150c38889f4
parent
8812b543a4cd73f974284470d5b34e50ea834611 [diff]
[ASTERIXDB-3711]Fix README JDK recommendation

- user model changes: yes
- storage format changes: no
- interface changes: no

Details: Building master actually requries JDK 21, not 17.

Change-Id: I434142a9b9cd2d1fc941b1e1f250ef7403a813ec
Reviewed-on: https://asterix-gerrit.ics.uci.edu/c/asterixdb/+/20999
Tested-by: Jenkins <jenkins@fulliautomatix.ics.uci.edu>
Reviewed-by: Ian Maxon <imaxon@apache.org>
Reviewed-by: Suryaa Charan Shivakumar <sshiv012@ucr.edu>
Integration-Tests: Jenkins <jenkins@fulliautomatix.ics.uci.edu>
1 file changed
tree: d48c2fad998b07aac0f9642cd3093150c38889f4
  1. asterixdb/
  2. hyracks-fullstack/
  3. .gitattributes
  4. .gitignore
  5. build.xml
  6. pom.xml
  7. README.md
README.md

What is AsterixDB?

AsterixDB is a BDMS (Big Data Management System) with a rich feature set that sets it apart from other platforms. Its feature set makes it well-suited to modern needs such as web data warehousing and social data storage and analysis. AsterixDB has:

  • Data model
    A semistructured NoSQL style data model (ADM) resulting from extending JSON with object database ideas

  • Query languages
    An expressive and declarative query language (SQL++ that supports a broad range of queries and analysis over semistructured data

  • Scalability
    A parallel runtime query execution engine, Apache Hyracks, that has been scale-tested on up to 1000+ cores and 500+ disks

  • Native storage
    Partitioned, flexible LSM-based row and column storage, with indexing to support efficient ingestion and management of semistructured data

  • External storage
    Support for query access to externally stored data (e.g., data in HDFS) as well as to data stored natively by AsterixDB

  • Data types
    A rich set of primitive data types, including spatial and temporal data in addition to integer, floating point, and textual data

  • Indexing
    Secondary indexing options that include B+ trees, R trees, and inverted keyword (exact and fuzzy) index types

  • Transactions
    Basic transactional (concurrency and recovery) capabilities akin to those of a NoSQL store

Learn more about AsterixDB at its website.

Build from source

To build AsterixDB from source, you should have a platform with the following:

  • A Unix-ish environment (Linux, OS X, will all do).
  • git
  • Maven 3.3.9 or newer.
  • JDK 21 or newer.
  • Python 3.11+ with pip and venv

Instructions for building the master:

  • Checkout AsterixDB master:

      $git clone https://github.com/apache/asterixdb.git

  • Build AsterixDB master:

      $cd asterixdb
  $mvn clean package -DskipTests

Run the build on your machine

Here are steps to get AsterixDB running on your local machine:

  • Start a single-machine AsterixDB instance:

      $cd asterixdb/asterix-server/target/asterix-server-*-binary-assembly/apache-asterixdb-*-SNAPSHOT
  $./opt/local/bin/start-sample-cluster.sh

  • Good to go and run queries in your browser at:

      http://localhost:19006

  • Read more documentation to learn the data model, query language, and how to create a cluster instance.

Documentation

To generate the documentation, run asterix-doc with the generate.rr profile in maven, e.g mvn -Pgenerate.rr ... Be sure to run mvn package beforehand or run mvn site in asterix-lang-sqlpp to generate some resources that are used in the documentation that are generated directly from the grammar.

Community support