[NO ISSUE][STO] Add consistency to flush lifecycle

- user model changes: no
- storage format changes: yes
  - renamed AbstractLSMIOOperationCallbackFactory
    to LSMIOOperationCallbackFactory
  - useless classes have been removed.
    - LSMBTreeIOOperationCallbackFactory
    - LSMBTreeWithBuddyIOOperationCallbackFactory
    - LSMInvertedIndexIOOperationCallbackFactory
    - LSMRTreeIOOperationCallbackFactory
- interface changes: yes

Details:
- Previously, flushes have different lifecycle depending
  on the memory component state
  - not allocated
  - allocated
  - modified
- In certain cases, flush operations are skipped alltogether
- IO Operation callbacks became complicated and difficult
  to maintain since calls are done differently in different
  cases.
- In certain cases, afterFinalize is called on the IO
  Operation callbacks even if beforeOperation was never
  called.
- In this change, flushes go through the same lifecycle
  events regardless of the state of the memory component.
- In addition, primary and secondary memory components
  would reside in different virtual buffer caches due
  to skipped flushes, or due to having the secondary
  index created when the primary index's memory component
  is residing on the virtual buffer cache with index !=0.
- Moreover, when flushes are lagging and all memory
  components are being flushed, search operations assumes
  the oldest of the memory component is the newest and
  produces incorrect results.
- In addition, in case of a failed flush of a component,
  the IO scheduler would skip it and flush the next
  component. This would produce a bad state on disk.
- In this change, a failed flush can be retried. otherwise,
  all future flushes of the component fail due to the failure
  of the previously failed flush.
- Previously, when a component fails to modify an index due
  to flush failures, it assumes disk is full.
- With this change, the modification failure reports the
  original cause of the failed flush.

Change-Id: I29f7992ec6c0f71c5b63d45800b2fb590d651e4b
Reviewed-on: https://asterix-gerrit.ics.uci.edu/2584
Reviewed-by: Murtadha Hubail <mhubail@apache.org>
Tested-by: Murtadha Hubail <mhubail@apache.org>
158 files changed
tree: de6921287f910213085a15044ae48062e3957ff4
  1. .gitattributes
  2. .gitignore
  3. README.md
  4. asterixdb/
  5. build.xml
  6. hyracks-fullstack/
  7. pom.xml
README.md

What is AsterixDB?

AsterixDB is a BDMS (Big Data Management System) with a rich feature set that sets it apart from other Big Data 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
    Two expressive and declarative query languages (SQL++ and AQL) that support 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 LSM-based data storage and 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.
  • Oracle JDK 8 or newer.

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/
      $./opt/local/bin/start-sample-cluster.sh
    
  • Good to go and run queries in your browser at:

      http://localhost:19001
    
  • Read more documentations to learn the data model, query language, and how to create a cluster instance.

Documentation

Community support