The libms-db project is a demonstrative and training-oriented initiative designed to offer hands-on experience with SQL. Focusing on the realm of library management, this project encompasses SQL scripts that detail the creation of tables pertinent to the system, as well as their subsequent population with mock data.

Table of Contents

• Getting started
  • Database initialization
  • Using Docker Compose
• Database structure

Prerequisites

• PostgreSQL server is available
• PostgreSQl client is available

This repository comes with all required queries. It is assumed you're using libms both as the postgres role and the database.

Your first task is to create PostgreSQL role and database. You may find the initialization queries to do this in docker/db/init.sql. In case of using docker compose this query is already applied for the PostgreSQL server, and no additional actions required. In case you're trying to set up libms for some another PostgreSQL server, just run the queries from the init.sql file on the RDBMS server. You'll need permissions to create roles and databases to do this.

Prerequisites:

• docker compose installed

This project comes with a docker compose file to deploy services recommended for the Django training. If you are not familiar with docker compose, it is a tool for containers management (Would you like to know more?).

The installation process is described here.

The compose file defines a minimalistic set of database server and GUI client running in individual containers. You need to map ports from your machine to docker containers to get things working well. Default mapped ports are:

• 5432 for the postgres service
• 5050 for the pgadmin service

You can change these values by modifying environment variables.

The containers management is simple as:

docker compose up -d # start all containers docker compose down # stop all containers

Some settings declared in the compose file may be overriden by setting up environment variables. If you aren't familiar with them here is a Wiki article.

Just type to the terminal:

SET VARIABLE=value # for Windows users EXPORT VARIABLE=value # for Unix users (Linux and MacOS)

The db service will run the PostgreSQL server container. It exposes 5432-port to the host machine, so you can use it just as if you got postgres running on your own system. The default ports mapping is "5432:5432". In case you have already 5432-port occupied by other software, you may set up any available port by using POSTGRES_PORT environment variable.

The pre-defined credentials are:

You can run this service separately from other services defined in the compose file by:

docker compose up -d db

pgAdmin is one of the most famous PostgreSQL clients. From the version 4.x it uses a web-based UI running in your web browser. The pgAdmin container exposes its 80-port to the host machine. By default, this port is mapped to 5050. In case you have already 5050-port occupied by other software, you may set up any available port by using PGADMIN_PORT environment variable. After running the pgAdmin visit http://localhost:5050 in your web browser (adjust the port number if needed).

The pre-defined credentials to connect pgAdmin are:

While connecting to the PostgreSQL server via pgAdmin the alias for the db container is "postgresql-server". This connection is already defined in the "servers.json" file under the "docker" directory and there is no need to it connect manually.

Note this may take some time to set up container and run internal server.

All schemas are defined using Mockaroo project and are public available via links below:

• author schema
• book schema
• book-to-author relationship
• book borrow requests
• library members
• members' contacts
• publisher companies
• library revenue

Also, there are Mockaroo schemas backups within this repo located inside of assets/mockaroo directory.

Generated datasets are also available at assets/csv.

UML diagram is available in assets directory.