PostgreSQL教程(十八)：客户端命令（2）

八、pg_restore:

    pg_restore用于恢复pg_dump导出的任何非纯文本格式的文件，它将数据库重建成保存它时的状态。对于归档格式的文件，pg_restore可以进行有选择的恢复，甚至也可以在恢复前重新排列数据的顺序。

    pg_restore可以在两种模式下操作。如果指定数据库，归档将直接恢复到该数据库。否则，必须先手工创建数据库，之后再通过pg_restore恢复数据到该新建的数据库中。该命令的使用方式如下：
 复制代码 代码如下:
    pg_restore [option...] [filename]
 
    1. 命令行选项列表：

  选项 说明 filename 指定要恢复的备份文件，如果没有声明，则使用标准输入。 -a(--data-only) 只恢复数据，而不恢复表模式(数据对象定义)。 -c(--clean) 创建数据库对象前先清理(删除)它们。 -C(--create) 在恢复数据库之前先创建它。(在使用该选项时，数据库名需要由-d选项指定，该选项只是执行最基本的CREATE DATABASE命令。需要说明的是，归档文件中所有的数据都将恢复到归档文件里指定的数据库中)。 -ddbname 与数据库dbname建立连接并且直接恢复数据到该数据库中。 -e(--exit-on-error)

如果在向数据库发送SQL命令的时候遇到错误，则退出。缺省是继续执行并且在恢复结束时显示一个错误计数。

只恢复指定的命名函数。该名称应该和转储的内容列表中的完全一致。

 2. 应用示例： 
 复制代码 代码如下:
    #先通过createdb命令，以myuser用户的身份登录，创建带恢复的数据newdb
    /> createdb -U myuser newdb
    #用pg_restore命令的-l选项导出my_dump.dat备份文件中导出数据库对象的明细列表。
    /> pg_restore -l my_dump.dat > db.list
    /> cat db.list
    2; 145344 TABLE species postgres
    4; 145359 TABLE nt_header postgres
    6; 145402 TABLE species_records postgres
    8; 145416 TABLE ss_old postgres
    10; 145433 TABLE map_resolutions postgres
    #将以上列表文件中的内容修改为以下形式。
    #主要的修改是注释掉编号为2、4和8的三个数据库对象，同时编号10的对象放到该文件的头部，这样在基于该列表
    #文件导入时，2、4和8等三个对象将不会被导入，在恢复的过程中将先导入编号为10的对象的数据，再导入对象6的数据。
    /> cat new_db.list
    10; 145433 TABLE map_resolutions postgres
    ;2; 145344 TABLE species postgres
    ;4; 145359 TABLE nt_header postgres
    6; 145402 TABLE species_records postgres
    ;8; 145416 TABLE ss_old postgres   
    #恢复时指定的数据库是newdb，导入哪些数据库对象和导入顺序将会按照new_db.list文件中提示的规则导入。
    /> pg_restore -d newdb -L new_db.list my_dump.dat

九、psql:

    PostgreSQL的交互终端，等同于Oracle中的sqlplus。
    1. 常用命令行选项列表：

  选项 说明 -c command 指定psql执行一条SQL命令command(用双引号括起)，执行后退出。 -d dbname 待连接的数据库名称。 -E　　 回显由\d和其他反斜杠命令生成的实际查询。 -f filename 使用filename文件中的数据作为命令输入源，而不是交互式读入查询。在处理完文件后，psql结束并退出。 -h hostname 声明正在运行服务器的主机名 -l 列出所有可用的数据库，然后退出。 -L filename 除了正常的输出源之外，把所有查询记录输出到文件filename。 -o filename 将所有查询重定向输出到文件filename。 -p port 指定PostgreSQL服务器的监听端口。 -q --quiet 让psql安静地执行所处理的任务。缺省时psql将输出打印欢迎和许多其他信息。 -t --tuples-only 关闭打印列名称和结果行计数脚注等信息。 -U username 以用户username代替缺省用户与数据库建立连接。

 2. 应用示例：  
 复制代码 代码如下:
    #先通过createdb命令，以myuser用户的身份登录，创建带恢复的数据newdb
    /> createdb -U myuser newdb
    #用pg_restore命令的-l选项导出my_dump.dat备份文件中导出数据库对象的明细列表。
    /> pg_restore -l my_dump.dat > db.list
    /> cat db.list
    2; 145344 TABLE species postgres
    4; 145359 TABLE nt_header postgres
    6; 145402 TABLE species_records postgres
    8; 145416 TABLE ss_old postgres
    10; 145433 TABLE map_resolutions postgres
    #将以上列表文件中的内容修改为以下形式。
    #主要的修改是注释掉编号为2、4和8的三个数据库对象，同时编号10的对象放到该文件的头部，这样在基于该列表
    #文件导入时，2、4和8等三个对象将不会被导入，在恢复的过程中将先导入编号为10的对象的数据，再导入对象6的数据。
    /> cat new_db.list
    10; 145433 TABLE map_resolutions postgres
    ;2; 145344 TABLE species postgres
    ;4; 145359 TABLE nt_header postgres
    6; 145402 TABLE species_records postgres
    ;8; 145416 TABLE ss_old postgres   
    #恢复时指定的数据库是newdb，导入哪些数据库对象和导入顺序将会按照new_db.list文件中提示的规则导入。
    /> pg_restore -d newdb -L new_db.list my_dump.dat

    3. 内置命令列表：
    psql内置命令的格式为反斜杠后面紧跟一个命令动词，之后是任意参数。参数与命令动词以及其他参数之间可以用空白符隔开，如果参数里面包含空白符，该参数必须用单引号括起，如果参数内包含单引号，则需要用反斜杠进行转义，此外单引号内的参数还支持类似C语言printf函数所支持的转义关键字，如\t、\n等。

命令 说明 \a 如果目前的表输出格式是不对齐的，切换成对齐的。如果是对齐的，则切换成不对齐。 \cd [directory] 把当前工作目录切换到directory。没有参数则切换到当前用户的主目录。 \C [title]　　 为查询结果添加表头(title)，如果没有参数则取消当前的表头。 \c[dbname[username] ] 连接新的数据库，同时断开当前连接。如果dbname参数为-，表示仍然连接当前数据库。如果忽略username，则表示继续使用当前的用户名。 \copy 其参数类似于SQL copy，功能则几乎等同于SQL copy，一个重要的差别是该内置命令可以将表的内容导出到本地，或者是从本地导入到数据库指定的表，而SQL copy则是将表中的数据导出到服务器的某个文件，或者是从服务器的文件导入到数据表。由此可见，SQL copy的效率要优于该内置命令。 \d [pattern] 显示和pattern匹配的数据库对象，如表、视图、索引或者序列。显示所有列，它们的类型，表空间(如果不是缺省的)和任何特殊属性。 \db [pattern]　　 列出所有可用的表空间。如果声明了pattern， 那么只显示那些匹配模式的表空间。 \db+ [pattern]　　 和上一个命令相比，还会新增显示每个表空间的权限信息。 \df [pattern]　　 列出所有可用函数，以及它们的参数和返回的数据类型。如果声明了pattern，那么只显示匹配(正则表达式)的函数。 \df+ [pattern]　　 和上一个命令相比，还会新增显示每个函数的附加信息，包括语言和描述。　　 \distvS [pattern] 这不是一个单独命令名称：字母 i、s、t、v、S 分别代表索引(index)、序列(sequence)、表(table)、视图(view)和系统表(system table)。你可以以任意顺序声明部分或者所有这些字母获得这些对象的一个列表。 \dn [pattern]　　 列出所有可用模式。如果声明了pattern，那么只列出匹配模式的模式名。 \dn+ [pattern] 和上一个命令相比，还会新增显示每个对象的权限和注释。 \dp [pattern] 生成一列可用的表和它们相关的权限。如果声明了pattern， 那么只列出名字可以匹配模式的表。 \dT [pattern] 列出所有数据类型或只显示那些匹配pattern的。 \du [pattern] 列出所有已配置用户或者只列出那些匹配pattern的用户。 \echotext [ ... ] 向标准输出打印参数，用一个空格分隔并且最后跟着一个新行。如：\echo `date` \g[{filename ||command}] 把当前的查询结果缓冲区的内容发送给服务器并且把查询的输出存储到可选的filename或者把输出定向到一个独立的在执行 command的Unix shell。 \ifilename 从文件filename中读取并把其内容当作从键盘输入的那样执行查询。 \l 列出服务器上所有数据库的名字和它们的所有者以及字符集编码。 \o[{filename ||command}] 把后面的查询结果保存到文件filename里或者把后面的查询结果定向到一个独立的shell command。 \p 打印当前查询缓冲区到标准输出。 \q 退出psql程序。 \r 重置(清空)查询缓冲区。 \s [filename] 将命令行历史打印出或是存放到filename。如果省略filename，历史将输出到标准输出。 \t　　 切换是否输出列/字段名的信息头和行记数脚注。 \w{filename ||command} 将当前查询缓冲区输出到文件filename或者定向到Unix命令command。 \z [pattern] 生成一个带有访问权限列表的数据库中所有表，视图和序列的列表。如果给出任何pattern，则被当成一个规则表达式，只显示匹配的表，视图和序列。 \! [command] 返回到一个独立的Unix shell或者执行Unix命令command。参数不会被进一步解释，shell将看到全部参数。

 4. 内置命令应用示例：

    在psql中，大部分的内置命令都比较易于理解，因此这里只是给出几个我个人认为相对容易混淆的命令。
 复制代码 代码如下:
    # \c: 其中横线(-)表示仍然连接当前数据库，myuser是新的用户名。
    postgres=# \c - myuser
    Password for user myuser:
    postgres=> SELECT user;
     current_user
    --------------
     myuser
    (1 row)
    # 执行任意SQL语句。
    postgres=# SELECT * FROM testtable WHERE i = 2;
     i
    ---
     2
    (1 row)
    # \g 命令会将上一个SQL命令的结果输出到指定文件。
    postgres=# \g my_file_for_command_g
    postgres=# \! cat my_file_for_command_g
     i
    ---
     2
    (1 row)
    # \g 命令会将上一个SQL命令的结果从管道输出到指定的Shell命令，如cat。
    postgres=# \g | cat
     i
    ---
     2
    (1 row)
    # \p 打印上一个SQL命令。
    postgres=# \p
    SELECT * FROM testtable WHERE i = 2;
    # \w 将上一个SQL命令输出到指定的文件。
    postgres=# \w my_file_for_option_w
    postgres=# \! cat my_file_for_option_w
    SELECT * FROM testtable WHERE i = 2;
    # \o 和\g相反，该命令会将后面psql命令的输出结果输出到指定的文件，直到遇到下一个独立的\o，
    # 此后的命令结果将不再输出到该文件。
    postgres=# \o my_file_for_option_o
    postgres=# SELECT * FROM testtable WHERE i = 1;
    # 终止后面的命令结果也输出到my_file_for_option_o文件中。
    postgres=# \o
    postgres=# \! cat my_file_for_option_o
     i
    ---
     1
    (1 row)