Browse Source

fix syntax issues/details in HowtoPostgreSQL

master
Romain Dessort 3 years ago
parent
commit
80cecd8a22
1 changed files with 44 additions and 48 deletions
  1. +44
    -48
      HowtoPostgreSQL.md

+ 44
- 48
HowtoPostgreSQL.md View File

@@ -134,7 +134,7 @@ $ createuser -P <login>
$ createdb -O <login> <base>
~~~

Comme pour les instances, par défaut la base sera créé avec l'encodage du système. Si le système est en UTF-8 par défaut, la base créée sera en UTF-8. On peut spécifier un encodage alternatif avec l'option `-E-`.
Comme pour les instances, par défaut la base sera créé avec l'encodage du système. Si le système est en UTF-8 par défaut, la base créée sera en UTF-8. On peut spécifier un encodage alternatif avec l'option `-E`.

* Suppression d'une base de données :

@@ -303,12 +303,12 @@ $ pg_restore -F c all.dump
Optimisations pour la restauration :

* paralléliser la restauration : `pg_restore -j <nb de cœurs CPU>` (ne pas compter les cœurs hyperthreadés) ;
* augmenter autant que possible le `_maintenance_work_mem_` (attention, il sera multiplié par le nombre de jobs utilisés pour la restauration). Dans tous les cas, ne pas dépasser les 2 Go. Peut être fait dans la conf ou dans une session ;
* Définir le `_synchronous_commit_` à `_off_`.
* augmenter autant que possible le `_maintenance_work_mem_` (attention, il sera multiplié par le nombre de processus utilisés pour la restauration). Dans tous les cas, ne pas dépasser les 2 Go. Peut être fait dans la conf ou dans une session ;
* Mettre la directive `synchronous_commit` à `off`.

#### Sauvegarde du datadir

Doc de référence : http://www.postgresql.org/docs/9.2/static/continuous-archiving.html
Doc de référence : http://www.postgresql.org/docs/9.4/static/continuous-archiving.html

Le principe est le suivant :

@@ -327,7 +327,7 @@ Ainsi, dès qu'un WAL est marqué comme complété (`pg_xlog/archive_status/*.re

~~~
postgres$ psql -c "SELECT pg_start_backup('evobackup')"
# rsync -a --delete --exclude /pg_xlog/* --exclude /postmaster.* ~postgres/9.2/main/ backup.example.com/backup/…/base/
# rsync -a --delete --exclude /pg_xlog/* --exclude /postmaster.* ~postgres/9.4/main/ backup.example.com/backup/…/base/
postgres$ psql -c "SELECT pg_stop_backup()"
~~~

@@ -336,7 +336,7 @@ postgres$ psql -c "SELECT pg_stop_backup()"
S'assurer que PostgreSQL est éteint, et restaurer le datadir :

~~~
# rsync -a --exclude /pg_xlog/* backup.example.com/backup/…/base/ ~postgres/9.2/main/
# rsync -a --exclude /pg_xlog/* backup.example.com/backup/…/base/ ~postgres/9.4/main/
~~~

Attention à ne surtout pas effacer le contenu de `pg_xlog/`, qui peut contenir le dernier WAL courant (donc pas encore copié sur le serveur de backup).
@@ -383,7 +383,7 @@ On peut maintenant "utiliser" notre base de données avec le client en ligne Pos

~~~
$ psql base login
ma_base=#
ma_base=>
~~~

Voici quelques commandes de base :
@@ -402,8 +402,8 @@ SELECT current_date; = date actuelle
Pour changer de base de données, deux possibilités :

~~~
=# \c base;
=# USE base;
=> \c base;
=> USE base;
~~~

### Création de table
@@ -427,14 +427,14 @@ Remarque : on peut aussi définir ses propres types de données
La syntaxe classique pour créer/supprimer une table :

~~~
CREATE TABLE ma_table (col1 type, […], coln type);
DROP TABLE ma_table;
=> CREATE TABLE ma_table (col1 type, […], coln type);
=> DROP TABLE ma_table;
~~~

Pour la forme un petit exemple tiré de la doc de PostgreSQL :

~~~
CREATE TABLE weather (
=> CREATE TABLE weather (
city varchar(80),
temp_lo int, -- low temperature
temp_hi int, -- high temperature
@@ -443,14 +443,14 @@ CREATE TABLE weather (
);
~~~

Note : deux tirets _--_ introduisent des commentaires
Note : deux tirets `--` introduisent des commentaires.

Pour mettre à jour des tables :

~~~
alter table evosondage_admin add cycle varchar(25);
alter table evosondage_admin alter column cycle set not null;
alter table evosondage_admin drop column annee;
=> ALTER TABLE evosondage_admin ADD cycle varchar(25);
=> ALTER TABLE evosondage_admin ALTER column cycle SET not null;
=> ALTER TABLE evosondage_admin DROP column annee;
~~~

### Insertion de données
@@ -458,37 +458,37 @@ alter table evosondage_admin drop column annee;
Insertion de tous les champs d'une table :

~~~
INSERT INTO weather VALUES ('San Francisco', 46, 50, 0.25, '1994-11-27');
=> INSERT INTO weather VALUES ('San Francisco', 46, 50, 0.25, '1994-11-27');
~~~

Insertion en précisant les champs :

~~~
INSERT INTO weather (city, temp_lo, temp_hi, prcp, date)
=> INSERT INTO weather (city, temp_lo, temp_hi, prcp, date)
VALUES ('San Francisco', 43, 57, 0.0, '1994-11-29');
~~~

Insertion à partir d'un fichier externe :

~~~
COPY weather FROM '/home/user/weather.txt';
=> COPY weather FROM '/home/user/weather.txt';
~~~

Note : voir [http://www.postgresql.org/docs/current/interactive/sql-copy.html]
Note : voir http://www.postgresql.org/docs/current/interactive/sql-copy.html

### Gestion des indexes

~~~
CREATE INDEX mytable_idx1 ON mytable(col1);
REINDEX TABLE mytable;
DROP INDEX mytable_idx1;
=> CREATE INDEX mytable_idx1 ON mytable(col1);
=> REINDEX TABLE mytable;
=> DROP INDEX mytable_idx1;
~~~

Pour réindexer une base de données complète :

~~~
$ psql mydb
=# REINDEX DATABASE mydb
=> REINDEX DATABASE mydb;
~~~

### Extraction de données
@@ -496,50 +496,47 @@ $ psql mydb
Rien ne vaut des exemples :

~~~
SELECT * FROM weather;
SELECT city, (temp_hi+temp_lo)/2 AS temp_avg, date FROM weather;
SELECT * FROM weatherWHERE city = 'San Francisco' AND prcp > 0.0;
SELECT DISTINCT city FROM weather ORDER BY city;
=> SELECT * FROM weather;
=> SELECT city, (temp_hi+temp_lo)/2 AS temp_avg, date FROM weather;
=> SELECT * FROM weatherWHERE city = 'San Francisco' AND prcp > 0.0;
=> SELECT DISTINCT city FROM weather ORDER BY city;
~~~

Avec des jointures :

~~~
SELECT * FROM weather, cities WHERE city = name;
SELECT weather.city, weather.temp_lo, cities.location
FROM weather, cities WHERE cities.name = weather.city;
SELECT * FROM weather INNER JOIN cities ON (weather.city = cities.name);
SELECT * FROM weather LEFT OUTER JOIN cities ON
(weather.city = cities.name);
SELECT * FROM weather w, cities c WHERE w.city = c.name;
=> SELECT * FROM weather, cities WHERE city = name;
=> SELECT weather.city, weather.temp_lo, cities.location FROM weather, cities WHERE cities.name = weather.city;
=> SELECT * FROM weather INNER JOIN cities ON (weather.city = cities.name);
=> SELECT * FROM weather LEFT OUTER JOIN cities ON (weather.city = cities.name);
=> SELECT * FROM weather w, cities c WHERE w.city = c.name;
~~~

Avec des fonctions (Aggregate Functions) :

~~~
SELECT max(temp_lo) FROM weather;
=> SELECT max(temp_lo) FROM weather;
~~~

Attention, les "Aggregate Functions" ne peuvent être utilisées dans la clause WHERE
Attention, les "Aggregate Functions" ne peuvent être utilisées dans la clause WHERE.
Ainsi la requête suivante est fausse :

~~~
SELECT city FROM weather WHERE temp_lo = max(temp_lo);
=> SELECT city FROM weather WHERE temp_lo = max(temp_lo);
~~~

On devra donc faire :

~~~
SELECT city FROM weather WHERE
temp_lo = (SELECT max(temp_lo) FROM weather);
=> SELECT city FROM weather WHERE temp_lo = (SELECT max(temp_lo) FROM weather);
~~~

On pourra bien sûr utilise _GROUP BY…_, _HAVING…_, etc.

Pour envoyer l'output dans un fichier :
Pour envoyer le résultat dans un fichier :

~~~
SELECT * FROM weather WHERE temp_lo=10 \g '/tmp/output'
=> SELECT * FROM weather WHERE temp_lo=10 \g '/tmp/output'
~~~

### Mise à jour des données
@@ -547,8 +544,7 @@ SELECT * FROM weather WHERE temp_lo=10 \g '/tmp/output'
Toujours avec un exemple :

~~~
UPDATE weather SET temp_hi = temp_hi - 2,
temp_lo = temp_lo - 2 WHERE date > '1994-11-28';
=> UPDATE weather SET temp_hi = temp_hi - 2, temp_lo = temp_lo - 2 WHERE date > '1994-11-28';
~~~

### Suppression des données
@@ -556,13 +552,14 @@ temp_lo = temp_lo - 2 WHERE date > '1994-11-28';
Encore avec un exemple :

~~~
DELETE FROM weather WHERE city = 'Hayward';
=> DELETE FROM weather WHERE city = 'Hayward';
~~~

Pour effacer toutes les données d'une table :

~~~
DELETE FROM weather;
=> DELETE FROM weather;
~~~

### Schémas

@@ -571,7 +568,7 @@ Par défaut, PostgreSQL utilise le schéma *public* mais il est possible d'utili
* Créer un nouveau schéma :

~~~
=> CREATE SCHEMA foo
=> CREATE SCHEMA foo;
~~~

* Lister les schémas d'une base :
@@ -586,7 +583,6 @@ Par défaut, PostgreSQL utilise le schéma *public* mais il est possible d'utili
=> \dt foo.
=> \di foo.
~~~
~~~

## Monitoring



Loading…
Cancel
Save