tech

PostgreSQL

Base de données relationnelle open-source puissante - fonctionnalités avancées, extensibilité et conformité SQL complète

TL;DR

Quoi : Base de données relationnelle open-source puissante avec des fonctionnalités avancées.

Pourquoi : Conformité ACID, support JSON, extensibilité et excellentes performances.

Quick Start

Installer :

# macOS
brew install postgresql@17
brew services start postgresql@17

# Ubuntu/Debian
sudo apt install postgresql postgresql-contrib
sudo systemctl start postgresql

# Docker
docker run -d --name postgres -e POSTGRES_PASSWORD=secret -p 5432:5432 postgres:17

Se connecter :

# Local connection
psql -U postgres

# With password
psql -h localhost -U postgres -d mydb

# Docker
docker exec -it postgres psql -U postgres

Créer une base de données et une table :

-- Create database
CREATE DATABASE myapp;

-- Connect to database
\c myapp

-- Create table
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    email VARCHAR(255) UNIQUE,
    created_at TIMESTAMP DEFAULT NOW()
);

-- Insert data
INSERT INTO users (name, email) VALUES ('John', '[email protected]');

-- Query
SELECT * FROM users;

Cheatsheet

Commande	Description
`\l`	Lister les bases de données
`\c dbname`	Se connecter à une base
`\dt`	Lister les tables
`\d tablename`	Décrire une table
`\du`	Lister les utilisateurs/rôles
`\q`	Quitter psql
`\i file.sql`	Exécuter un fichier SQL
`\timing`	Activer/désactiver le timing

SQL courant :

-- Create user
CREATE USER myuser WITH PASSWORD 'secret';
GRANT ALL PRIVILEGES ON DATABASE mydb TO myuser;

-- Backup
pg_dump mydb > backup.sql

-- Restore
psql mydb < backup.sql

Gotchas

FATAL: role “username” does not exist

# Create the user
sudo -u postgres createuser --interactive

# Or in psql
CREATE USER myuser WITH PASSWORD 'password';

Connection refused

# Check if PostgreSQL is running
sudo systemctl status postgresql

# Check pg_hba.conf for authentication
# Location: /etc/postgresql/17/main/pg_hba.conf

Permission denied for table

-- Grant permissions
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO myuser;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO myuser;

Problèmes d’encodage de base de données

-- Create database with encoding
CREATE DATABASE mydb
    WITH ENCODING 'UTF8'
    LC_COLLATE = 'en_US.UTF-8'
    LC_CTYPE = 'en_US.UTF-8';