Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pthom/northwind_psql
Northwind sample database for postgres
https://github.com/pthom/northwind_psql
Last synced: about 1 month ago
JSON representation
Northwind sample database for postgres
- Host: GitHub
- URL: https://github.com/pthom/northwind_psql
- Owner: pthom
- License: other
- Created: 2015-04-12T09:46:52.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-06-14T04:01:49.000Z (6 months ago)
- Last Synced: 2024-08-09T02:19:55.974Z (4 months ago)
- Size: 461 KB
- Stars: 708
- Watchers: 26
- Forks: 887
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - pthom/northwind_psql - Northwind sample database for postgres (Others)
README
# Northwind database for Postgres
A simple sql script that will populate a database with the famous northwind example, adapted for postgres.
## Getting started:
### Manually
Use the provided sql file `nortwhind.sql` in order to populate your database.
### With Docker and docker compose
#### Pre-requirement: install docker and docker-compose
https://www.docker.com/get-started
https://docs.docker.com/compose/install/
#### 1. Run docker-compose
````bash
> docker-compose up
...
... Lots of messages...
...
Creating network "northwind_psql_db" with driver "bridge"
Creating volume "northwind_psql_db" with default driver
Creating volume "northwind_psql_pgadmin" with default driver
Creating pgadmin ... done
Creating db ... done
````
#### 2. Run psql client:
##### Method 1: Via the docker-compose container
Open another terminal window, and type:
````bash
> docker-compose exec db psql -U postgres -d northwind
psql (13.2 (Debian 13.2-1.pgdg100+1))
Type "help" for help.
northwind=# select * from us_states;
state_id | state_name | state_abbr | state_region
----------+----------------------+------------+--------------
1 | Alabama | AL | south
2 | Alaska | AK | north
...
````
Alternatively, you can launch bash, then psql:
````bash
docker-compose exec db /bin/bash
# You are now inside the "db" docker container
psql -U postgres northwind
````
##### Method 2: Direct access via the port 55432
The "db" docker exposes postgres on the port 55432. If you have psql on your path, you may connect to it via:
````bash
# Run this directly from your computer (this will connect to the docker db)
psql -U postgres northwind -p 55432
````
#### 3. Connect PgAdmin
Access to PgAdmin at the url: http://localhost:5050
Add a new server in PgAdmin:
- General Tab:
- Name = db
- Connection Tab:
- Host name: db
- Username: postgres
- Password: postgres
Then, select database "northwind".
#### 4. Stop docker-compose
Stop the server that was launched by `docker compose up` via `Ctrl-C`, then remove the containers via:
```bash
docker-compose down
```
#### 5. Files & persistence
Your modifications to the postgres database(s)will be persisted in the `postgresql_data` docker volume, and can be retrieved once you restart `docker compose up`.
If you need to delete the database data, run `docker-compose down -v` (the database will then be repopulated from scratch when running `docker-compose up`).
If you need to upload any files into your db container, just copy and paste them to the `files` local folder. They will be available at the `/files` path inside the db container.