Skip to content

Commit a08b2de

Browse files
mfvanekmfvanek
committed
Added table of content
1 parent 7ef7464 commit a08b2de

File tree

14 files changed

+92
-31
lines changed

14 files changed

+92
-31
lines changed

‎README.md

+2
Original file line numberDiff line numberDiff line change
@@ -2,5 +2,7 @@
22
A set of useful SQL scripts (mostly for PostgreSQL)
33

44
## Content
5+
* [Useful commands](useful_commands/usefulCommands.md)
6+
* [PostgreSQL Performance Optimization](performance_optimization/configuration.md)
57
* [How to run PostgreSQL in Docker](running_pg_in_docker/postgresInDocker.md)
68
* [How to run PostgreSQL cluster in Docker](running_pg_cluster_in_docker/postgresClusterInDocker.md)

‎performance_optimization/configuration.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Оптимизация производительности PostgreSQL
1+
# PostgreSQL Performance Optimization (Оптимизация производительности PostgreSQL)
22

33
Ниже перечислены основные параметры, на которые следует обратить внимание при оптимизации производительности PostgreSQL.
44

@@ -25,7 +25,7 @@ show max_wal_size;
2525
show work_mem;
2626
```
2727

28-
[См.](https://www.citusdata.com/blog/2018/06/12/configuring-work-mem-on-postgres/)
28+
[См.](https://www.citusdata.com/blog/2018/06/12/configuring-work-mem-on-postgres/)
2929
[См. также](https://www.depesz.com/2011/07/03/understanding-postgresql-conf-work_mem/)
3030

3131
### maintenance_work_mem

‎running_pg_cluster_in_docker/1. Hello Postgres cluster/README.md

+15-7
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,22 @@
22

33
## Docker Compose
44
### Start
5-
`docker-compose --project-name="habr-pg-ha-14" up -d`
5+
```shell
6+
docker-compose --project-name="habr-pg-ha-14" up -d
7+
```
68

79
### Stop
8-
`docker-compose --project-name="habr-pg-ha-14" down`
10+
```shell
11+
docker-compose --project-name="habr-pg-ha-14" down
12+
```
913

1014
### Run psql
11-
`psql -U postgres -d habrdb`
12-
`psql -U habrpguser -d habrdb`
15+
```shell
16+
psql -U postgres -d habrdb
17+
```
18+
```shell
19+
psql -U habrpguser -d habrdb
20+
```
1321

1422
See:
1523
```sql
@@ -23,14 +31,14 @@ select case when pg_is_in_recovery() then 'secondary' else 'primary' end as host
2331
```
2432

2533
Without log in to psql:
26-
```bash
34+
```shell
2735
psql -c "select case when pg_is_in_recovery() then 'secondary' else 'primary' end as host_status;" "dbname=habrdb user=habrpguser password=pgpwd4habr"
2836
```
2937

3038
## How to manually init failover
3139

3240
### Stop container with current primary
33-
```bash
41+
```shell
3442
docker stop postgres_1
3543
```
3644

@@ -43,7 +51,7 @@ LOG: database system is ready to accept connections
4351
```
4452

4553
### Return the first host to the cluster
46-
```bash
54+
```shell
4755
docker start postgres_1
4856
```
4957

‎running_pg_cluster_in_docker/postgresClusterInDocker.md

+3
Original file line numberDiff line numberDiff line change
@@ -1 +1,4 @@
11
# How to run PostgreSQL cluster in Docker
2+
3+
## Content
4+
1. [Hello Postgres cluster](./1.%20Hello%20Postgres%20cluster/README.md)

‎running_pg_in_docker/1. Hello Postgres/README.md

+10-4
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,22 @@
11
# The simplest way to run PostgreSQL in Docker
22

33
## Docker
4-
```
4+
```shell
55
docker run --name habr-pg-14 -p 5432:5432 -e POSTGRES_USER=habrpguser -e POSTGRES_PASSWORD=pgpwd4habr -e POSTGRES_DB=habrdb -d postgres:14.5
66
```
77

88
### Run psql
9-
`psql -U habrpguser -d habrdb`
9+
```shell
10+
psql -U habrpguser -d habrdb
11+
```
1012

1113
## Docker Compose
1214
### Start
13-
`docker-compose --project-name="habr-pg-14" up -d`
15+
```shell
16+
docker-compose --project-name="habr-pg-14" up -d
17+
```
1418

1519
### Stop
16-
`docker-compose --project-name="habr-pg-14" down`
20+
```shell
21+
docker-compose --project-name="habr-pg-14" down
22+
```

‎running_pg_in_docker/2. Init Database/README.md

+11-5
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,27 @@
11
# Initializing Postgres database at startup
22

33
## Docker
4-
```
4+
```shell
55
docker run --name habr-pg-14 -p 5432:5432 -e POSTGRES_USER=habrpguser -e POSTGRES_PASSWORD=pgpwd4habr -e POSTGRES_DB=habrdb -d -v "/absolute/path/to/directory-with-init-scripts":/docker-entrypoint-initdb.d postgres:14.5
66
```
77

88
### Auto detect current directory (for macOS and Linux)
9-
```
9+
```shell
1010
docker run --name habr-pg-14 -p 5432:5432 -e POSTGRES_USER=habrpguser -e POSTGRES_PASSWORD=pgpwd4habr -e POSTGRES_DB=habrdb -d -v "$(pwd)":/docker-entrypoint-initdb.d postgres:14.5
1111
```
1212

1313
### Run psql
14-
`psql -U habrpguser -d habrdb`
14+
```shell
15+
psql -U habrpguser -d habrdb
16+
```
1517

1618
## Docker Compose
1719
### Start
18-
`docker-compose --project-name="habr-pg-14" up -d`
20+
```shell
21+
docker-compose --project-name="habr-pg-14" up -d
22+
```
1923

2024
### Stop
21-
`docker-compose --project-name="habr-pg-14" down`
25+
```shell
26+
docker-compose --project-name="habr-pg-14" down
27+
```

‎running_pg_in_docker/3. Where is my data/README.md

+8-4
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,22 @@
11
# Specifying catalog for database files
22

33
## Docker
4-
```
4+
```shell
55
docker run --name habr-pg-14 -p 5432:5432 -e POSTGRES_USER=habrpguser -e POSTGRES_PASSWORD=pgpwd4habr -e POSTGRES_DB=habrdb -e PGDATA=/var/lib/postgresql/data/pgdata -d -v "/absolute/path/to/directory-with-data":/var/lib/postgresql/data -v "/absolute/path/to/directory-with-init-scripts":/docker-entrypoint-initdb.d postgres:14.5
66
```
77

88
### Auto-detect current directory (for macOS and Linux)
9-
```
9+
```shell
1010
docker run --name habr-pg-14 -p 5432:5432 -e POSTGRES_USER=habrpguser -e POSTGRES_PASSWORD=pgpwd4habr -e POSTGRES_DB=habrdb -e PGDATA=/var/lib/postgresql/data/pgdata -d -v "$(pwd)":/var/lib/postgresql/data -v "$(pwd)/../2. Init Database":/docker-entrypoint-initdb.d postgres:14.5
1111
```
1212

1313
## Docker Compose
1414
### Start
15-
`docker-compose --project-name="habr-pg-14" up -d`
15+
```shell
16+
docker-compose --project-name="habr-pg-14" up -d
17+
```
1618

1719
### Stop
18-
`docker-compose --project-name="habr-pg-14" down`
20+
```shell
21+
docker-compose --project-name="habr-pg-14" down
22+
```

‎running_pg_in_docker/4. Healthcheck and limits/README.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,11 @@
22

33
## Docker Compose
44
### Start
5-
`docker-compose --project-name="habr-pg-14" up -d`
5+
```shell
6+
docker-compose --project-name="habr-pg-14" up -d
7+
```
68

79
### Stop
8-
`docker-compose --project-name="habr-pg-14" down`
10+
```shell
11+
docker-compose --project-name="habr-pg-14" down
12+
```

‎running_pg_in_docker/5. Tuning parameters/README.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,11 @@
22

33
## Docker Compose
44
### Start
5-
`docker-compose --project-name="habr-pg-14" up -d`
5+
```shell
6+
docker-compose --project-name="habr-pg-14" up -d
7+
```
68

79
### Stop
8-
`docker-compose --project-name="habr-pg-14" down`
10+
```shell
11+
docker-compose --project-name="habr-pg-14" down
12+
```

‎running_pg_in_docker/6. UI via pgAdmin/README.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,14 @@
22

33
## Docker Compose
44
### Start
5-
`docker-compose --project-name="habr-pg-14" up -d`
5+
```shell
6+
docker-compose --project-name="habr-pg-14" up -d
7+
```
68

79
### Stop
8-
`docker-compose --project-name="habr-pg-14" down`
10+
```shell
11+
docker-compose --project-name="habr-pg-14" down
12+
```
913

1014
## Access to PgAdmin
1115
Open in browser [http://localhost:5050](http://localhost:5050)

‎running_pg_in_docker/7. Monitoring with postgres_exporter/README.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,14 @@
22

33
## Docker Compose
44
### Start
5-
`docker-compose --project-name="habr-pg-14" up -d`
5+
```shell
6+
docker-compose --project-name="habr-pg-14" up -d
7+
```
68

79
### Stop
8-
`docker-compose --project-name="habr-pg-14" down`
10+
```shell
11+
docker-compose --project-name="habr-pg-14" down
12+
```
913

1014
## Access to PgAdmin
1115
Open in browser [http://localhost:5050](http://localhost:5050)

‎running_pg_in_docker/postgresInDocker.md

+10
Original file line numberDiff line numberDiff line change
@@ -1 +1,11 @@
11
# How to run PostgreSQL in Docker
2+
Read my article on Habr [Running PostgreSQL in Docker: from simple to complex](https://habr.com/ru/articles/578744/)
3+
4+
## Content
5+
1. [Hello Postgres](./1.%20Hello%20Postgres/README.md)
6+
2. [Init Database](./2.%20Init%20Database/README.md)
7+
3. [Where is my data](./3.%20Where%20is%20my%20data/README.md)
8+
4. [Healthcheck and limits](./4.%20Healthcheck%20and%20limits/README.md)
9+
5. [Tuning parameters](./5.%20Tuning%20parameters/README.md)
10+
6. [UI via pgAdmin](./6.%20UI%20via%20pgAdmin/README.md)
11+
7. [Monitoring with postgres_exporter](./7.%20Monitoring%20with%20postgres_exporter/README.md)

‎useful_commands/db_info.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
## Getting information about the PostgreSQL database
1+
## Getting information about PostgreSQL database
22

33
### Replication status, list of replicas (synchronous\asynchronous)
44
```sql

‎useful_commands/usefulCommands.md

+6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# Useful commands for PostgreSQL users
2+
3+
## Content
4+
* [Getting information about PostgreSQL database](./db_info.md)
5+
* [Index Maintenance](./index_maintenance.md)
6+
* [System Administration Functions](./kill_process.md)

0 commit comments

Comments
 (0)