PostgreSQL、PostGIS 中文速查手册

这是一个你可能需要的一个备忘手册，此手册方便你快速查询到你需要的常见功能。有时也有一些曾经被使用过的高级功能。如无特殊说明，此手册仅适用于 Linux 下（基本都可以愉快运行，一般也都可以在 Windows 下的 psql 命令窗运行，只是稍微麻烦一点），部分功能可能需要你的软件版本不能太低。

欢迎添加你认为有价值的备忘！

安装PostgreSQL 和 PostGIS

在Ubuntu上，使用Ubuntu-GIS的专门 ppa 来安装最新 GIS 软件，并保持更新。

sudo add-apt-reposiTOry ppa:ubuntugis/ppa
sudo apt-get update
sudo apt-get install postgresql postgis

配置与启用

方法1：切换到 postgres 账户

在Linux版本中(无特殊说明，以下默认为此版本)，安装完之后会自动为你创建新账户 postgres，在进行数据库操作前，你需要先切换到该账户。

sudo -i -u postgres # *你原来的账户*需要在 sudoers list里面

方法2：其他账户给psql提供用户名和数据库名

psql -u postgres DBNAME

使用`initdb`初始化数据存储位置

（使用 locate initdb来寻找其位置）

$ /usr/lib/postgresql/12/bin/initdb -D /var/lib/postgresql/data
blah blah
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
initdb: warning: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.

Success. You can now start the database server using:

    /usr/lib/postgresql/12/bin/pg_ctl -D /var/lib/postgresql/data -l logfile start

开启PostgreSQL服务

`pg_ctl`开启服务（推荐）

按照上面输出的提示命令开启服务，可以查看当前目录的logfile检查启动的问题。

/usr/lib/postgresql/12/bin/pg_ctl -D /var/lib/postgresql/data -l logfile start

`service` 快速开启服务（不推荐）

service postgresql start

进入 psql 命令行（默认 postgres 数据库）

psql DBNAME 进入数据库DBNAME，默认为 postgres。
请注意, 数据库名称大小写是敏感的（Case-sensitive）

$ psql 
psql (12.8 (Ubuntu 12.8-0ubuntu0.20.04.1))
Type "help" for help.

postgres=#

此时你的命令前面的提示符变成 postgres=#，说明你已经成功进入 postgres 这个数据库，这个数据库存储着一些程序的默认设置，所以请不要随意更改甚至删库。同时，程序也提示你可以使用 help 获取命令帮助，但是相信你和我一样不想看这冗长的输出，这也是这个手册的价值所在。

出现如下提示，进入失败，说明你的服务可能未成功启动，参考开启服务：

$ psql
psql: error: could not connect TO server: No such file or direcTOry
        Is the server running locally and accepting
        connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

注意，从此处开始，你可以注意我们的表示习惯:

$ 开头的命令或者没有标识的命令代表普通命令，即使用 postgres 用户在普通shell中执行的命令
psql=# 开头的命令代表在进入 psql 后执行的命令，至于具体的数据库名称在此不标识出来，请注意。
大写的DBNAME，TABLENAME 等对应你自己的数据库名、表名等，请自行替换。

Windows下使用 psql

Windows下打开 psql 命令窗两种常用方法：

打开你的 pgadmin 软件图形界面，鼠标在左侧对象浏览器选中你要进入的数据库，在菜单栏找到 插件 > PSQL Console
不想开 pgadmin 的话，找到 psql.exe 所在目录（64位：C:\Program Files\PostgreSQL\9.x\bin），在此目录打开cmd（一些其他的程序如pg_dump等也都在这个目录），运行：

psql -U postgres DBNAME

Windows用户注意：很多时候你运行 psql 出错是因为没有输入正确的用户名参数，例如用户名-U postgres等。

psql使用

离开数据库

请注意，Postgresql 的特殊命令都是以 \ 开头的，而且结尾不需要分号;

psql=# \q

查看（列出）所有数据库

如果你刚接手一个数据库，不知道现存哪些数据库，那么你就$ psql进入默认数据库进行以下查询（此查询在其他数据库也可以）

psql=# \list or \l

显示每个数据库的额外信息，后面的 + 对下面的 \d, \dt 也都适用，都是提供数据库占用之类的额外信息。

psql=# \l+

查看当前数据库所有 table

psql=# \dt

查看当前数据库所有 relation

relation 包括有 table, view, sequence等

psql=# \d

查看某个表的所有字段

psql=# \d TABLENAME

列出某个所有字段（仅字段）

与上面不同，这个仅列出字段，便于在字段很多，但是你有不需要所有的字段的时候直接拷贝。（来源

psql=# SELECT * FROM TABLENAME WHERE false;

检查表（视图）存在且当前用户可以访问

How to check whether a table (or view) exists, and the current user has access to it?

SELECT EXISTS (
   SELECT FROM information_schema.tables 
   WHERE  table_schema = 'schema_name'
   AND    table_name   = 'table_name'
   );

查看某数据库占用存储大小

psql=# SELECT pg_size_pretty(pg_database_size('DBNAME'));

显示配置文件

psql=# SHOW config_file;

显示软件版本

psql=# SELECT version();

在psql中执行 shell 命令

注意中间的空格，不可忽略

psql=# \! dir

有了这个的帮助，你在 Windows 下，需要运行 psql.exe 或者其他程序，就不需要费周章去找到其具体目录了，你可以从 pgadmin 的 PSQL console 来运行一些命令了。例如：

psql=# \! psql -c "SHOW version()" -U postgres  -- 显示软件版本

值得一提的是，这种使用方案并不算好用，因为 Windows 命令行奇怪的编码，以及如果软件在你电脑上自动安装成了中文，一旦输入了错误指令，报错会用中文报错，报错的内容可能就会乱码。

建库、删库、执行SQL语句、建表

创建数据库

createdb DBNAME

删除数据库

dropdb DBNAME

执行 SQL 语句

首先作为关系型数据库，基本的 SQL 语言是必须要支持的。假设你对基本的语句有所了解，如建表、查询、计数等。有一些 SQL 的基本规则你需要在这里格外注意，稍有不慎就可能会导致错误，可能很简单的错误就会打击你的积极性。

SQL 语句中双引号和单引号的使用

双引号"用来表示的表名，但是一般我们在使用中将__双引号省略__
单引号'用来表示普通字符串

以下两个命令是等价的：

psql=# SELECT FIELDNAME FROM TABLENAME WHERE FIELDNAME='normalstring';
psql=# SELECT "FIELDNAME"  FROM "TABLENAME" WHERE "FIELDNAME"='normalstring';

SQL 语句必须以 `;` 结尾

执行文件中的SQL语句

psql=# \i query.sql

表重命名

psql=# ALTER TABLE TABLENAME RENAME TO NTABLENAME;

快速查询表的（估计）行数

通常当表变得非常大时（千万条数据级以上），数据库没有优化的话，查询速度变得相当缓慢。使用以下命令可以瞬间查找到记录的大致数值。(Ref: SO)

psql=# SELECT reltuples::bigint AS estimate FROM pg_class WHERE relname='TABLENAME';

扩展功能

PostGIS / 空间扩展

具体详见这里

创建NoSQL扩展

psql=# CREATE extension hsTOre;

在 shell 里面执行 SQL 语句

一般都是涉及到输入输出的时候使用，基本是如下格式：

psql -c "YOUR SQL QUERY" DATABASENAME

导入导出

导出数据库

命名随意选择，选这个后缀是为了便于标识。另外由于权限问题，推荐保存在 /tmp 下。
如果你每次只写文件名的话，会默认保存在 postgres 用户的默认目录下，而这个目录比较深，你可能不太容易找，而且即使可以找到，作为普通用户，还可能涉及到读写权限问题。 Windows 下也会出现写文件权限问题，有不同的解决办法，比如修改用户权限等问题，但是这个涉及到用户权限设置等，个人不建议修改。建议自己尝试一下，如果失败，是不是有中文（或其他非ASCII）路径，其次是否是在你的用户路径或者是否在系统路径下。

pg_dump DBNAME > /tmp/DBNAME.postgresql

Windows下从文本恢复数据库

通常需要先创建一个空数据库，然后将数据库恢复到该数据库

psql -U postgres DBNAME < PATH\TO\YOUR\DBFILE

将指定表导出至压缩文件

将以上命令也可以在 shell 里面执行，这样的话，我们就可以以文件流的形式将我们的输出传到其他的程序。比如此处，我们使用 zip 将输出的文件直接压缩，方便我们下载并节省流量加快速度。（请注意，这个时候，你从这个文件解压出来的文件名仅仅是一个连字符-，这是文件流的默认名称）
（这个要求你的系统安装有 zip 。当然极少有 Linux 没有这个软件。Windows 如果自己有安装，命令行可以调用的话也可以用，否则你就当我什么都没说。）

public 是你的默认 schema 。
$ psql -c "COPY public.TABLENAME TO stdout WITH delimiter E'\t' csv header"  DATABASE | zip > TABLENAME.zip

导出table 或者导出 SQL 查询的结果

这种 COPY 命令也是 SQL 语句的形式，但这不是 SQL 标准要求的东西
FILEPATH 不支持相对路径

psql=# COPY TABLENAME TO 'FILEPATH' WITH delimiter '|'; -- 指定table
psql=# COPY TABLENAME(FIELD1, FILED2) TO 'FILEPATH' WITH delimiter '|'; -- 指定table及其字段
psql=# COPY (query) TO 'FILEPATH' WITH delimiter '|'; -- 使用 query

导出为json格式的文件

psql=# COPY (SELECT ROW_TO_JSON(t) FROM (SELECT * FROM TABLENAME) t) TO 'FILEPATH';

其他

在命令中表示TAB字符

导出文件格式为 csv/tsv 的时候你可能需要用到E'\t'

给某条语句的运行计时

只输入\timing 就是在 on 和 off之间切换，也可以显式输入 on 和 off

psql=# \timing [on|off]

解释语句内部处理过程

psql=# EXPLAIN [SQL query]

查看数据库运行状态

pg_lsclusters 可以用来显示当前数据库服务运行状态，可以查看服务是否开启，以及 log文件的位置 ，这个在你的数据库无法开启时可能是你需要的（运行less LOG_PATH查看log)。然后针对你碰到的错误使用搜索引擎，你碰到过的问题，其他人基本都碰到过。

pg_lsclusters

查看postgres用户的目录

echo ~postgres

Choumingzhao/pg_quick_notes.md