mariadb-corporation / dev-example-orms

Object-Relational Mapping and MariaDB samples

Object-Relational Mapping Samples

⚠️ [UNMAINTAINED] This repository has been moved and is currently maintained here. ⚠️

This repository contains samples of Object-Relational Mapping (ORM) libraries used with MariaDB.

This README will walk you through the steps for getting the samples applications up and running using MariaDB. To ensure success, please follow the instructions in order.

Note: The code provided within this repository is completely open source. Please feel free to use it as you see fit.

Table of Contents

1. Requirements
2. Introduction to MariaDB
   1. MariaDB Platform
   2. MariaDB SkySQL
3. Getting started
   1. Get the code
   2. Create the schema
   3. Anatomy of the app
4. Support and contribution
5. License

Requirements

For these sample applications, no matter which project you target, will require the following to be installed/enabled on your machine:

• MariaDB Client, used to connect to MariaDB instances.

Introduction to MariaDB

MariaDB Platform

MariaDB Platform integrates transactional and analytical products so developers can build modern applications by enriching transactions with real-time analytics and historical data, creating insightful experiences and compelling opportunities for customers – and for businesses, endless ways to monetize data.

To get started using MariaDB locally you can choose one of the following options:

• Download and install MariaDB (Community or Enterprise) directly from mariadb.com

• Download and install MariaDB using the official MariaDB Community Server 10.5 Docker Image available at hub.docker.com

MariaDB SkySQL

SkySQL is the first and only database-as-a-service (DBaaS) to bring the full power of MariaDB Platform to the cloud, including its support for transactional, analytical and hybrid workloads. Built on Kubernetes, and optimized for cloud infrastructure and services, SkySQL combines ease of use and self-service with enterprise reliability and world-class support – everything needed to safely run mission-critical databases in the cloud, and with enterprise governance.

Get started with SkySQL!

Get started

In order to run the applications in this repo you will need to have a MariaDB instance to connect to. For more information please check out "Get Started with MariaDB".

Get the code

Download this code directly or use git (through CLI or a client) to retrieve the code using git clone:

$ git clone https://github.com/mariadb-corporation/dev-example-orms.git

Create the schema

Use the following command within (a terminal window) to connect to MariaDB and execute a SQL script to create and load the data to be used by all samples.

$ mariadb --host [your_host_address] --port [port_no] --user [db_user] -p[user_password] < data/schema.sql

Example:

$ mariadb --host 127.0.0.1 --port 3306 --user app_user -pPassword123! < data/schema.sql

Anatomy of the apps

The sample applications contained within this repository vary by language and ORM library. Check out the src directory for the options and more details!

Support and Contribution

Please feel free to submit PR's, issues or requests to this project project directly.

If you have any other questions, comments, or looking for more information on MariaDB please check out:

• MariaDB Developer Hub
• MariaDB Community Slack

Or reach out to us diretly via:

• [e-mail]
• MariaDB Twitter

License