Asterixdb

<!-- ! 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. !-->

<a href="http://asterixdb.apache.org"><img src="http://asterixdb.apache.org/img/asterixdb_tm.png" height=100></img></a>

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<br/> A semistructured NoSQL style data model (ADM) resulting from extending JSON with object database ideas

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

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

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

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

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

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

• Transactions<br/> 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.

• master | 0.9.9 | 0.9.8 | 0.9.7 |

Community support

• Users</br> maling list: users@asterixdb.apache.org</br> Join the list by sending an email to users-subscribe@asterixdb.apache.org</br>
• Developers and contributors</br> mailing list:dev@asterixdb.apache.org</br> Join the list by sending an email to dev-subscribe@asterixdb.apache.org