Mariadb-Developer-Examples/modern-sql
Rob Hedgpeth 2ba297d563 readme update 2020-02-27 08:40:39 -08:00
..
media
README.md readme update 2020-02-27 08:40:39 -08:00
create_schema_data.sql
demo_1.json
demo_2.json
demo_3.json

README.md

Modern SQL, MariaDB, and Apache Zeppelin!

MariaDB implements more of the standard SQL specification than any other open source database, adding support for common table expressions (CTEs), window functions, temporal data tables and many other features over the last few years.

The following will walk you through the steps for setting up Apache Zeppelin to integrate with MariaDB and work with several samples of modern SQL functionality.

Table of Contents

  1. Environment and Compatibility
  2. Getting started with MariaDB
    1. The Basics
    2. Downloading and installing MariaDB
  3. Requirements
  4. Getting started with Apache Zeppelin
  5. Support and Contribution
  6. License

Environment and Compatibility

This sample was created using the following techologies:

This application was tested on macOS Mojave v.10.14.6.

Overview

Introduction to MariaDB

MariaDB platform unifies MariaDB TX (transactions) and MariaDB AX (analytics) so transactional applications can retain unlimited historical data and leverage powerful, real-time analytics in order to provide data-driven customers with more information, actionable insight and greater value – and businesses with endless ways to monetize data. It is the enterprise open source database for hybrid transactional/analytical processing at scale.

Getting start with MariaDB

To download and deploy MariaDB check out the instructions here. You can also make use of the MariaDB Image available on Docker Hub.

Create the schema

Next you can create the schema necessary for this application by running

$ /<path_to>/create_schema_data.sh

or copying the SQL within create_schema_data.sql directly.

Requirements

This project assumes you have familiarity with building web applications using ReactJS and NodeJS technologies.

  • Download and install MariaDB.
  • Download and install Apache Zeppelin.
  • git (Optional) - this is required if you would prefer to pull the source code from GitHub repo.
    • Create a free github account if you dont already have one
    • git can be downloaded from git-scm.org

Getting started with Apache Zeppelin

Adding a MariaDB interpreter

Once you've downloaded and installed Apache Zeppelin you will need to add a new interpreter for MariaDB using the following steps:

  1. Navigate to "Interpreter".

  1. Click the "Create" button.

  2. Enter a name for the interpreter and select an "Interpreter group" of jdbc.

  1. Assign value of org.mariadb.jdbc.Driver to default.driver.

  2. Assign value of jdbc:mariadb://<database_address>/ (where <database_address> is the location of your MariaDB database instance) to default.url.

  3. Assign value to default.user.

  4. Assign value to default.password.

  5. Add the location of the JDBC driver as an artifact.

Importing the notebooks

Import the notes:

  • demo_1.json: Set operators, table value constructors, aggregation functions, and rollups.
  • demo_2.json: Window functions and common table expressions (recursive).
  • demo_3.json: Temporal tables.

by selecting "Import note".

Support and Contribution

If you have any questions, comments, or would like to contribute to this or future projects like this please reach out to us directly at developers@mariadb.com or on Twitter.

License

License