PostgreSQL：psql 介紹

本文分享自天翼云開發(fā)者社區(qū)《PostgreSQL：psql 介紹》，作者: 周****平

鏈接：

https://www.ctyun.cn/developer/article/358337908486290?track=|cp:cz_bk|tgdy:wenzhang|ttjh:bokeshequ|key:bw302|pf:PC

psql 作psql 命令是與 PostgreSQL 服務(wù)器交互的客戶端程序，要登錄到數(shù)據(jù)庫服務(wù)器，需要使用psql 客戶端工具或者第三方客戶端工具如PostgreSQL for Navicat，pgAdmin，Visualizer 等等。為 DBA 通常使用的與 PostgreSQL 交互的客戶端終端程序，因此，熟悉這個命令的用法可以幫助 DBA 快速的操作和維護數(shù)據(jù)庫。

psql 的默認(rèn)語法

psql [OPTION]...[數(shù)據(jù)庫名稱 [用戶名]]

說明

在 shell 命令行輸入 psql，會直接進入數(shù)據(jù)庫，此時的數(shù)據(jù)庫默認(rèn)用戶名是 postgres，默認(rèn)的數(shù)據(jù)庫是 postgres。

連接選項：

-c， --command=COMMAND：執(zhí)行單行命令。

-d， --dbname=DBNAME：數(shù)據(jù)庫名稱（默認(rèn)：“postgres”）

-f， --file=FILENAME：從外部調(diào)用腳本文件

-l， --list：列出可用的數(shù)據(jù)庫后退出。

-v， --set=， --variable=NAME=VALUE：set psql 變量 NAME to VALUE（例如，-v >

-V， --版本輸出版本信息，然后退出

-X， --no-psqlrc 不讀取啟動文件 （~/.psqlrc）

-1 （“one”）， --single-transaction：作為單個事務(wù)執(zhí)行（如果是非交互式的）

輸入輸出選項：

-a， --echo-all：將腳本中的所有輸入都輸出，包含 SQL 命令，存儲過程和默認(rèn)的 psqlrc 文件中的命令。

-b， --回聲錯誤回顯失敗命令

-e， --echo-queries echo 命令發(fā)送到服務(wù)器

-E， --echo-hidden：可以獲取元命令的SQL代碼

-L， --log-file=FILENAME：發(fā)送會話日志到指定的文件。

-n， --無讀線禁用增強的命令行編輯（讀線）

-o， --output=FILENAME：和-L不同的是，該參數(shù)僅僅將當(dāng)前登錄用戶的執(zhí)行操作結(jié)果保存到指定的文件，并且不會顯示輸出到屏幕。

-q， --quiet：以靜默方式運行，沒有額外信息顯示，只輸出查詢結(jié)果，一般結(jié)合 Aqt 一起使用。

-s， --單步單步模式（確認(rèn)每個查詢）

-S， --single-line：： 單行模式，SQL 語句只能寫在一行，而不能換行，不加該參數(shù)，SQL 語句可換行。

輸出格式選項

-A， --no-align：不對齊輸出。

--csv：以逗號分隔的表輸出模式。

-F， --field-separator=STRING：域分隔符（默認(rèn)：|）。

-H， --html：以HTML表格輸出查詢結(jié)果。

-P， --pset=VAR[=ARG] 將打印選項 VAR 設(shè)置為 ARG（請參見 \pset 命令）

-R， --record-separator=STRING record separator for unigned output（默認(rèn)值：換行符）

-t， --tuples-only：僅輸出結(jié)果行。

-T， --table-attr=TEXT 設(shè)置 HTML 表標(biāo)簽屬性（例如，寬度、邊框）

-x， --擴展打開擴展表輸出

-z， --字段分隔符-零設(shè)置字段分隔符，用于將未對齊的輸出設(shè)置為零字節(jié)

-0， --記錄分隔符 --零設(shè)置記錄分隔符，用于將未對齊的輸出轉(zhuǎn)換為零字節(jié)

鏈接選項

-h， --host=HOSTNAME：遠程數(shù)據(jù)庫服務(wù)器主機 ip 或 Unix 套接字目錄（默認(rèn)：“l(fā)ocal socket”）

-p， --port=PORT：數(shù)據(jù)庫運行監(jiān)聽端口（默認(rèn)： “5432”）

-U， --username=USERNAME：數(shù)據(jù)庫用戶名（默認(rèn)： “postgres”）

-w， --no-password：禁用密碼提示

-W， --密碼強制密碼提示（應(yīng)該自動發(fā)生）

登錄數(shù)據(jù)庫

在psql 中輸入的以反斜杠開頭的內(nèi)容都是psql元命令，也叫做反斜杠命令。元命令由psql自身進行處理。

元命令格式為反斜杠后跟參數(shù)，如\copy 命令即為元命令，語法格式為

元命令和選項之間可以有一個或者多個空格隔開，如果可選參數(shù)中包含了空格，可以用單引號將其引起來，如果是轉(zhuǎn)義字符如： \ n（換行），\ t（制表符），\ b（退格鍵），\ r（回車），\ f（換頁），\ digits（八進制）和\ xdigits（十六進制）都可以使用單引號引起來。

部分元命令以SQL標(biāo)識符(如表名，函數(shù)，序列等)作為參數(shù)，這些參數(shù)需遵循SQL語法規(guī)則：不帶引號的字母將被強制小寫，雙引號之間的字母不進行大小寫轉(zhuǎn)換，并允許在標(biāo)識符中包含空格。在雙引號中，成對的雙引號會當(dāng)成單引號使用。

psql 提供了豐富的元命令，如查看數(shù)據(jù)庫對象定義，數(shù)據(jù)庫對象空間大小，導(dǎo)入導(dǎo)出等元命令，以便于DBA或者開發(fā)人員能夠方便的管理和維護數(shù)據(jù)庫。

通用

\版權(quán)顯示 PostgreSQL 使用和分發(fā)條款

\交叉表視圖 [列] 執(zhí)行查詢并在交叉表中顯示結(jié)果

\errverbose 以最大詳細(xì)程度顯示最新的錯誤消息

\g [文件] 或 ;執(zhí)行查詢（并將結(jié)果發(fā)送到文件或|管道）

\gdesc 描述查詢的結(jié)果，而不執(zhí)行它

\gexec 執(zhí)行查詢，然后執(zhí)行其結(jié)果中的每個值

\gset [PREFIX] 執(zhí)行查詢并將結(jié)果存儲在 psql 變量中

\gx [FILE] 作為 \g，但強制擴展輸出模式

\q                     quit psql

\watch [SEC] 每隔 SEC 秒執(zhí)行一次查詢

查詢緩沖區(qū)

\ef [FUNCNAME [LINE]] 使用外部編輯器編輯函數(shù)定義

\ev [視圖名稱 [行]] 使用外部編輯器編輯視圖定義

\p 顯示查詢緩沖區(qū)的內(nèi)容

\r 重置（清除）查詢緩沖區(qū)

\s [文件] 顯示歷史記錄或?qū)⑵浔４娴轿募?/span>

\w 文件將查詢緩沖區(qū)寫入文件

輸入/輸出

\復(fù)制...使用數(shù)據(jù)流執(zhí)行 SQL COPY 到客戶端主機

\echo [字符串] 將字符串寫入標(biāo)準(zhǔn)輸出

\i 文件從文件執(zhí)行命令

\ir FILE 作為 \i，但相對于當(dāng)前腳本的位置

\o [文件] 將所有查詢結(jié)果發(fā)送到文件或|管道

\qecho [STRING] 將字符串寫入查詢輸出流（請參見 \o）

有條件的

\如果 EXPR 開始條件塊

\elif EXPR 替代當(dāng)前條件塊中

\else 當(dāng)前條件塊中的最終替代項

\endif                 end conditional block

信息查看

\d[S+]：列出表、視圖、序列、或索引

\d[S+] NAME 描述表、視圖、序列或索引

\da[S] [模式] 列表聚合

\dA[+] [模式] 列表訪問方法

\db[+]  [PATTERN]：列出表空間信息

\dc[S+] [模式] 列表轉(zhuǎn)換

\dC[+] [模式] 列表轉(zhuǎn)換

\dd[S] [模式] 顯示未在其他地方顯示的對象描述

\dD[S+] [模式] 列表域

\ddp [模式] 列出默認(rèn)權(quán)限

\dE[S+] [模式] 列出外來表

\det[+] [PATTERN] 列出外來表

\des[+] [PATTERN] 列出外部服務(wù)器

\deu[+] [PATTERN] 列表用戶映射

\dew[+] [PATTERN] 列出外來數(shù)據(jù)包裝器

\df[anptw][S+] [PATRN] 列表 [僅 agg/normal/procedures/trigger/window] 函數(shù)

\dF[+] [模式] 列出文本搜索配置

\dFd[+] [模式] 列表文本搜索詞典

\dFp[+] [PATTERN] 列表文本搜索解析器

\dFt[+] [模式] 列表文本搜索模板

\dg[S+] [模式] 列表角色

\di[S+] [PATTERN]：查看索引占用空間大小

\dl 列出與 \lo_list 相同的大型對象

\dL[S+] [模式] 列出過程語言

\dm[S+] [模式] 列出實例化視圖

\dn[S+] [模式] 列表架構(gòu)

\do[S] [模式] 列表運算符

\dO[S+] [模式] 列表排序規(guī)則

\dp [PATTERN] 列出表、視圖和序列訪問權(quán)限

\dP[itn+] [PATTERN] 列表 [僅索引/表] 分區(qū)關(guān)系 [n=嵌套]

\drds [PATRN1 [PATRN2]] 列出每個數(shù)據(jù)庫的角色設(shè)置

\dRp[+] [PATTERN] 列出復(fù)制發(fā)布

\dRs[+] [模式] 列出復(fù)制訂閱

\ds[S+] [模式] 列表序列

\dt[S+] [PATTERN]：查看表占用空間大小

\dT[S+] [模式] 列出數(shù)據(jù)類型

\du[S+] [模式] 列表角色

\dv[S+] [模式] 列表視圖

\dx[+] [模式] 列表擴展

\dy [模式] 列表事件觸發(fā)器

\l[+] [模式] 列表數(shù)據(jù)庫

\sf[+]  FUNCNAME：查看函數(shù)定義信息

\sv[+]  VIEWNAME：列出視圖的定義信息

\z [模式] 與 \dp 相同

格式

\在未對齊和對齊輸出模式之間切換

\C [字符串] 設(shè)置表標(biāo)題，如果沒有，則取消設(shè)置

\f [字符串] 顯示或設(shè)置未對齊查詢輸出的字段分隔符

\H 切換 HTML 輸出模式（當(dāng)前關(guān)閉）

\pset [NAME [VALUE]] 設(shè)置表輸出選項

（邊框|列|csv_fieldsep|展開|字段|

fieldsep_zero|頁腳|格式|線樣式|空|

數(shù)字定位|頁|pager_min_lines|記錄|

recordsep_zero|tableattr|title|tuples_only|

unicode_border_linestyle|unicode_column_linestyle|

unicode_header_linestyle）

\t [開|關(guān)] 僅顯示行（當(dāng)前關(guān)閉）

\T [字符串] 設(shè)置 HTML <table> 標(biāo)記屬性，如果沒有，則取消設(shè)置

\x [on|off|auto]：可設(shè)置查詢結(jié)果輸出模式 （默認(rèn)：off）

鏈接

\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}：連接到本地或遠程數(shù)據(jù)庫服務(wù)器

\conninfo 顯示有關(guān)當(dāng)前連接的信息

\編碼 [編碼] 顯示或設(shè)置客戶端編碼

\password [用戶名] 安全地更改用戶的密碼

系統(tǒng)操作

\cd [目錄] 更改當(dāng)前工作目錄

\setenv NAME [VALUE] 設(shè)置或取消設(shè)置環(huán)境變量

\timing [on|off] 切換命令的計時（當(dāng)前關(guān)閉）

\![命令] 在 shell 中執(zhí)行命令或啟動交互式 shell

參數(shù)

\prompt [TEXT] NAME 提示用戶設(shè)置內(nèi)部變量

\未設(shè)置名稱 未設(shè)置（刪除）內(nèi)部變量

大對象

\lo_export 小葉文件

\lo_import 文件 [注釋]

\lo_list

\lo_unlink LOBOID 大型對象操作

來自 “ ITPUB博客 ” ，鏈接：http://blog.itpub.net/31490526/viewspace-2711967/，如需轉(zhuǎn)載，請注明出處，否則將追究法律責(zé)任。