前言
何為PostgreSQL？
PostgreSQL簡(jiǎn)史
格式約定
更多信息
臭蟲(chóng)匯報(bào)指導(dǎo)
I. 教程
章1. 從頭開(kāi)始
1.1. 安裝
1.2. 體系基本概念
1.3. 創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)
1.4. 訪問(wèn)數(shù)據(jù)庫(kù)
章2. SQL語(yǔ)言
2.1. 介紹
2.2. 概念
2.3. 創(chuàng)建新表
2.4. 向表中添加行
2.5. 查詢(xún)一個(gè)表
2.6. 表間鏈接
2.7. 聚集函數(shù)
2.8. 更新
2.9. 刪除
章3. 高級(jí)特性
3.1. 介紹
3.2. 視圖
3.3. 外鍵
3.4. 事務(wù)
3.5. 窗口函數(shù)
3.6. 繼承
3.7. 結(jié)論
II. SQL語(yǔ)言
章4. SQL語(yǔ)法
4.1. 詞法結(jié)構(gòu)
4.2. 值表達(dá)式
4.3. 調(diào)用函數(shù)
章5. 數(shù)據(jù)定義
5.1. 表的基本概念
5.2. 缺省值
5.3. 約束
5.4. 系統(tǒng)字段
5.5. 修改表
5.6. 權(quán)限
5.7. 模式
5.8. 繼承
5.9. 分區(qū)
5.10. 其它數(shù)據(jù)庫(kù)對(duì)象
5.11. 依賴(lài)性跟蹤
章 6. 數(shù)據(jù)操作
6.1. 插入數(shù)據(jù)
6.2. 更新數(shù)據(jù)
6.3. 刪除數(shù)據(jù)
章7. 查詢(xún)
7.1. 概述
7.2. 表表達(dá)式
7.3. 選擇列表
7.4. 組合查詢(xún)
7.5. 行排序
7.6. LIMIT和OFFSET
7.7. VALUES列表
7.8. WITH的查詢(xún)（公用表表達(dá)式）
章8. 數(shù)據(jù)類(lèi)型
8.1. 數(shù)值類(lèi)型
8.2. 貨幣類(lèi)型
8.3. 字符類(lèi)型
8.4. 二進(jìn)制數(shù)據(jù)類(lèi)型
8.5. 日期/時(shí)間類(lèi)型
8.6. 布爾類(lèi)型
8.7. 枚舉類(lèi)型
8.8. 幾何類(lèi)型
8.9. 網(wǎng)絡(luò)地址類(lèi)型
8.10. 位串類(lèi)型
8.11. 文本搜索類(lèi)型
8.12. UUID類(lèi)型
8.13. XML類(lèi)型
8.14. 數(shù)組
8.15. 復(fù)合類(lèi)型
8.16. 對(duì)象標(biāo)識(shí)符類(lèi)型
8.17. 偽類(lèi)型
章 9. 函數(shù)和操作符
9.1. 邏輯操作符
9.2. 比較操作符
9.3. 數(shù)學(xué)函數(shù)和操作符
9.4. 字符串函數(shù)和操作符
9.5. 二進(jìn)制字符串函數(shù)和操作符
9.6. 位串函數(shù)和操作符
9.7. 模式匹配
9.8. 數(shù)據(jù)類(lèi)型格式化函數(shù)
9.9. 時(shí)間/日期函數(shù)和操作符
9.10. 支持枚舉函數(shù)
9.11. 幾何函數(shù)和操作符
9.12. 網(wǎng)絡(luò)地址函數(shù)和操作符
9.13. 文本檢索函數(shù)和操作符
9.14. XML函數(shù)
9.15. 序列操作函數(shù)
9.16. 條件表達(dá)式
9.17. 數(shù)組函數(shù)和操作符
9.18. 聚合函數(shù)
9.19. 窗口函數(shù)
9.20. 子查詢(xún)表達(dá)式
9.21. 行和數(shù)組比較
9.22. 返回集合的函數(shù)
9.23. 系統(tǒng)信息函數(shù)
9.24. 系統(tǒng)管理函數(shù)
9.25. 觸發(fā)器函數(shù)
章10. 類(lèi)型轉(zhuǎn)換
10.3. 函數(shù)
10.2. 操作符
10.1. 概述
10.4. 值存儲(chǔ)
10.5. UNION
章11. 索引
11.1. 介紹
11.2. 索引類(lèi)型
11.3. 多字段索引
11.4. 索引和ORDER BY
11.5. 組合多個(gè)索引
11.6. 唯一索引
11.7. 表達(dá)式上的索引
11.8. 部分索引
11.9. 操作類(lèi)和操作簇
11.10. 檢查索引的使用
章12. Full Text Search
12.1. Introduction
12.2. Tables and Indexes
12.3. Controlling Text Search
12.4. Additional Features
12.5. Parsers
12.6. Dictionaries
12.7. Configuration Example
12.8. Testing and Debugging Text Search
12.9. GiST and GIN Index Types
12.10. psql Support
12.11. Limitations
12.12. Migration from Pre-8.3 Text Search
章13. 并發(fā)控制
13.1. 介紹
13.2. 事務(wù)隔離
13.3. 明確鎖定
13.4. 應(yīng)用層數(shù)據(jù)完整性檢查
13.5. 鎖和索引
章14. 性能提升技巧
14.1. 使用EXPLAIN
14.2. 規(guī)劃器使用的統(tǒng)計(jì)信息
14.3. 用明確的JOIN語(yǔ)句控制規(guī)劃器
14.4. 向數(shù)據(jù)庫(kù)中添加記錄
14.5. 非持久性設(shè)置
III. 服務(wù)器管理
章15. 安裝指導(dǎo)
15.1. 簡(jiǎn)版
15.2. 要求
15.3. 獲取源碼
15.4. 升級(jí)
15.5. 安裝過(guò)程
15.6. 安裝后的設(shè)置
15.7. 支持的平臺(tái)
15.8. 特殊平臺(tái)的要求
章16. Installation from Source Code on Windows
16.1. Building with Visual C++ or the Platform SDK
16.2. Building libpq with Visual C++ or Borland C++
章17. 服務(wù)器安裝和操作
17.1. PostgreSQL用戶(hù)帳戶(hù)
17.2. 創(chuàng)建數(shù)據(jù)庫(kù)集群
17.3. 啟動(dòng)數(shù)據(jù)庫(kù)服務(wù)器
17.4. 管理內(nèi)核資源
17.5. 關(guān)閉服務(wù)
17.6. 防止服務(wù)器欺騙
17.7. 加密選項(xiàng)
17.8. 用SSL進(jìn)行安全的TCP/IP連接
17.9. Secure TCP/IP Connections with SSH Tunnels
章18. 服務(wù)器配置
18.1. 設(shè)置參數(shù)
18.2. 文件位置
18.3. 連接和認(rèn)證
18.4. 資源消耗
18.5. 預(yù)寫(xiě)式日志
18.6. 查詢(xún)規(guī)劃
18.7. 錯(cuò)誤報(bào)告和日志
18.8. 運(yùn)行時(shí)統(tǒng)計(jì)
18.9. 自動(dòng)清理
18.10. 客戶(hù)端連接缺省
18.12. 版本和平臺(tái)兼容性
18.11. 鎖管理
18.13. 預(yù)置選項(xiàng)
18.14. 自定義的選項(xiàng)
18.15. 開(kāi)發(fā)人員選項(xiàng)
18.16. 短選項(xiàng)
章19. 用戶(hù)認(rèn)證
19.1. pg_hba.conf 文件
19.2. 用戶(hù)名映射
19.3. 認(rèn)證方法
19.4. 用戶(hù)認(rèn)證
章20. 數(shù)據(jù)庫(kù)角色和權(quán)限
20.1. 數(shù)據(jù)庫(kù)角色
20.2. 角色屬性
20.3. 權(quán)限
20.4. 角色成員
20.5. 函數(shù)和觸發(fā)器
章21. 管理數(shù)據(jù)庫(kù)
21.1. 概述
21.2. 創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)
21.3. 臨時(shí)庫(kù)
21.4. 數(shù)據(jù)庫(kù)配置
21.5. 刪除數(shù)據(jù)庫(kù)
21.6. 表空間
章22. 本土化
22.1. 區(qū)域支持
22.2. 字符集支持
章23. 日常數(shù)據(jù)庫(kù)維護(hù)工作
23.1. Routine Vacuuming日常清理
23.2. 經(jīng)常重建索引
23.3. 日志文件維護(hù)
章24. 備份和恢復(fù)
24.1. SQL轉(zhuǎn)儲(chǔ)
24.2. 文件系統(tǒng)級(jí)別的備份
24.3. 在線備份以及即時(shí)恢復(fù)(PITR)
24.4. 版本間遷移
章25. 高可用性與負(fù)載均衡，復(fù)制
25.1. 不同解決方案的比較
25.2. 日志傳送備份服務(wù)器
25.3. 失效切換
25.4. 日志傳送的替代方法
25.5. 熱備
章26. 恢復(fù)配置
26.1. 歸檔恢復(fù)設(shè)置
26.2. 恢復(fù)目標(biāo)設(shè)置
26.3. 備服務(wù)器設(shè)置
章27. 監(jiān)控?cái)?shù)據(jù)庫(kù)的活動(dòng)
27.1. 標(biāo)準(zhǔn)Unix工具
27.2. 統(tǒng)計(jì)收集器
27.3. 查看鎖
27.4. 動(dòng)態(tài)跟蹤
章28. 監(jiān)控磁盤(pán)使用情況
28.1. 判斷磁盤(pán)的使用量
28.2. 磁盤(pán)滿(mǎn)導(dǎo)致的失效
章29. 可靠性和預(yù)寫(xiě)式日志
29.1. 可靠性
29.2. 預(yù)寫(xiě)式日志(WAL)
29.3. 異步提交
29.4. WAL配置
29.5. WAL內(nèi)部
章30. Regression Tests
30.1. Running the Tests
30.2. Test Evaluation
30.3. Variant Comparison Files
30.4. Test Coverage Examination
IV. 客戶(hù)端接口
章31. libpq-C庫(kù)
31.1. 數(shù)據(jù)庫(kù)聯(lián)接函數(shù)
31.2. 連接狀態(tài)函數(shù)
31.3. 命令執(zhí)行函數(shù)
31.4. 異步命令處理
31.5. 取消正在處理的查詢(xún)
31.6. 捷徑接口
31.7. 異步通知
31.8. 與COPY命令相關(guān)的函數(shù)
31.9. Control Functions 控制函數(shù)
31.10. 其他函數(shù)
31.11. 注意信息處理
31.12. 事件系統(tǒng)
31.13. 環(huán)境變量
31.14. 口令文件
31.15. 連接服務(wù)的文件
31.16. LDAP查找連接參數(shù)
31.17. SSL支持
31.18. 在多線程程序里的行為
31.19. 制作libpq程序
31.20. 例子程序
章32. 大對(duì)象
32.1. 介紹
32.2. 實(shí)現(xiàn)特點(diǎn)
32.3. 客戶(hù)端接口
32.4. 服務(wù)器端函數(shù)
32.5. 例子程序
章33. ECPG - Embedded SQL in C
33.1. The Concept
33.2. Connecting to the Database Server
33.3. Closing a Connection
33.4. Running SQL Commands
33.5. Choosing a Connection
33.6. Using Host Variables
33.7. Dynamic SQL
33.8. pgtypes library
33.9. Using Descriptor Areas
33.10. Informix compatibility mode
33.11. Error Handling
33.12. Preprocessor directives
33.13. Processing Embedded SQL Programs
33.14. Library Functions
33.15. Internals
章34. 信息模式
34.1. 關(guān)于這個(gè)模式
34.2. 數(shù)據(jù)類(lèi)型
34.3. information_schema_catalog_name
34.4. administrable_role_authorizations
34.5. applicable_roles
34.6. attributes
34.7. check_constraint_routine_usage
34.8. check_constraints
34.9. column_domain_usage
34.10. column_privileges
34.11. column_udt_usage
34.12. 字段
34.13. constraint_column_usage
34.14. constraint_table_usage
34.15. data_type_privileges
34.16. domain_constraints
34.18. domains
34.17. domain_udt_usage
34.19. element_types
34.20. enabled_roles
34.21. foreign_data_wrapper_options
34.22. foreign_data_wrappers
34.23. foreign_server_options
34.24. foreign_servers
34.25. key_column_usage
34.26. parameters
34.27. referential_constraints
34.28. role_column_grants
34.29. role_routine_grants
34.30. role_table_grants
34.31. role_usage_grants
34.32. routine_privileges
34.33. routines
34.34. schemata
34.35. sequences
34.36. sql_features
34.37. sql_implementation_info
34.38. sql_languages
34.39. sql_packages
34.40. sql_parts
34.41. sql_sizing
34.42. sql_sizing_profiles
34.43. table_constraints
34.44. table_privileges
34.45. tables
34.46. triggered_update_columns
34.47. 觸發(fā)器
34.48. usage_privileges
34.49. user_mapping_options
34.50. user_mappings
34.51. view_column_usage
34.52. view_routine_usage
34.53. view_table_usage
34.54. 視圖
V. 服務(wù)器端編程
章35. 擴(kuò)展SQL
35.1. 擴(kuò)展性是如何實(shí)現(xiàn)的
35.2. PostgreSQL類(lèi)型系統(tǒng)
35.3. User-Defined Functions
35.4. Query Language (SQL) Functions
35.5. Function Overloading
35.6. Function Volatility Categories
35.7. Procedural Language Functions
35.8. Internal Functions
35.9. C-Language Functions
35.10. User-Defined Aggregates
35.11. User-Defined Types
35.12. User-Defined Operators
35.13. Operator Optimization Information
35.14. Interfacing Extensions To Indexes
35.15. 用C++擴(kuò)展
章36. 觸發(fā)器
36.1. 觸發(fā)器行為概述
36.3. 用 C 寫(xiě)觸發(fā)器
36.2. 數(shù)據(jù)改變的可視性
36.4. 一個(gè)完整的例子
章37. 規(guī)則系統(tǒng)
37.1. The Query Tree
37.2. 視圖和規(guī)則系統(tǒng)
37.3. 在INSERT，UPDATE和DELETE上的規(guī)則
37.4. 規(guī)則和權(quán)限
37.5. 規(guī)則和命令狀態(tài)
37.6. 規(guī)則與觸發(fā)器得比較
章38. Procedural Languages
38.1. Installing Procedural Languages
章39. PL/pgSQL - SQL過(guò)程語(yǔ)言
39.1. 概述
39.2. PL/pgSQL的結(jié)構(gòu)
39.3. 聲明
39.4. 表達(dá)式
39.5. 基本語(yǔ)句
39.6. 控制結(jié)構(gòu)
39.7. 游標(biāo)
39.8. 錯(cuò)誤和消息
39.9. 觸發(fā)器過(guò)程
39.10. PL/pgSQL Under the Hood
39.11. 開(kāi)發(fā)PL/pgSQL的一些提示
39.12. 從OraclePL/SQL 進(jìn)行移植
章40. PL/Tcl - Tcl Procedural Language
40.1. Overview
40.2. PL/Tcl Functions and Arguments
40.3. Data Values in PL/Tcl
40.4. Global Data in PL/Tcl
40.5. Database Access from PL/Tcl
40.6. Trigger Procedures in PL/Tcl
40.7. Modules and the unknown command
40.8. Tcl Procedure Names
章41. PL/Perl - Perl Procedural Language
41.1. PL/Perl Functions and Arguments
41.2. Data Values in PL/Perl
41.3. Built-in Functions
41.4. Global Values in PL/Perl
41.6. PL/Perl Triggers
41.5. Trusted and Untrusted PL/Perl
41.7. PL/Perl Under the Hood
章42. PL/Python - Python Procedural Language
42.1. Python 2 vs. Python 3
42.2. PL/Python Functions
42.3. Data Values
42.4. Sharing Data
42.5. Anonymous Code Blocks
42.6. Trigger Functions
42.7. Database Access
42.8. Utility Functions
42.9. Environment Variables
章43. Server Programming Interface
43.1. Interface Functions
Spi-spi-connect
Spi-spi-finish
Spi-spi-push
Spi-spi-pop
Spi-spi-execute
Spi-spi-exec
Spi-spi-execute-with-args
Spi-spi-prepare
Spi-spi-prepare-cursor
Spi-spi-prepare-params
Spi-spi-getargcount
Spi-spi-getargtypeid
Spi-spi-is-cursor-plan
Spi-spi-execute-plan
Spi-spi-execute-plan-with-paramlist
Spi-spi-execp
Spi-spi-cursor-open
Spi-spi-cursor-open-with-args
Spi-spi-cursor-open-with-paramlist
Spi-spi-cursor-find
Spi-spi-cursor-fetch
Spi-spi-cursor-move
Spi-spi-scroll-cursor-fetch
Spi-spi-scroll-cursor-move
Spi-spi-cursor-close
Spi-spi-saveplan
43.2. Interface Support Functions
Spi-spi-fname
Spi-spi-fnumber
Spi-spi-getvalue
Spi-spi-getbinval
Spi-spi-gettype
Spi-spi-gettypeid
Spi-spi-getrelname
Spi-spi-getnspname
43.3. Memory Management
Spi-spi-palloc
Spi-realloc
Spi-spi-pfree
Spi-spi-copytuple
Spi-spi-returntuple
Spi-spi-modifytuple
Spi-spi-freetuple
Spi-spi-freetupletable
Spi-spi-freeplan
43.4. Visibility of Data Changes
43.5. Examples
VI. 參考手冊(cè)
I. SQL命令
Sql-abort
Sql-alteraggregate
Sql-alterconversion
Sql-alterdatabase
Sql-alterdefaultprivileges
Sql-alterdomain
Sql-alterforeigndatawrapper
Sql-alterfunction
Sql-altergroup
Sql-alterindex
Sql-alterlanguage
Sql-alterlargeobject
Sql-alteroperator
Sql-alteropclass
Sql-alteropfamily
Sql-alterrole
Sql-alterschema
Sql-altersequence
Sql-alterserver
Sql-altertable
Sql-altertablespace
Sql-altertsconfig
Sql-altertsdictionary
Sql-altertsparser
Sql-altertstemplate
Sql-altertrigger
Sql-altertype
Sql-alteruser
Sql-alterusermapping
Sql-alterview
Sql-analyze
Sql-begin
Sql-checkpoint
Sql-close
Sql-cluster
Sql-comment
Sql-commit
Sql-commit-prepared
Sql-copy
Sql-createaggregate
Sql-createcast
Sql-createconstraint
Sql-createconversion
Sql-createdatabase
Sql-createdomain
Sql-createforeigndatawrapper
Sql-createfunction
Sql-creategroup
Sql-createindex
Sql-createlanguage
Sql-createoperator
Sql-createopclass
Sql-createopfamily
Sql-createrole
Sql-createrule
Sql-createschema
Sql-createsequence
Sql-createserver
Sql-createtable
Sql-createtableas
Sql-createtablespace
Sql-createtsconfig
Sql-createtsdictionary
Sql-createtsparser
Sql-createtstemplate
Sql-createtrigger
Sql-createtype
Sql-createuser
Sql-createusermapping
Sql-createview
Sql-deallocate
Sql-declare
Sql-delete
Sql-discard
Sql-do
Sql-dropaggregate
Sql-dropcast
Sql-dropconversion
Sql-dropdatabase
Sql-dropdomain
Sql-dropforeigndatawrapper
Sql-dropfunction
Sql-dropgroup
Sql-dropindex
Sql-droplanguage
Sql-dropoperator
Sql-dropopclass
Sql-dropopfamily
Sql-drop-owned
Sql-droprole
Sql-droprule
Sql-dropschema
Sql-dropsequence
Sql-dropserver
Sql-droptable
Sql-droptablespace
Sql-droptsconfig
Sql-droptsdictionary
Sql-droptsparser
Sql-droptstemplate
Sql-droptrigger
Sql-droptype
Sql-dropuser
Sql-dropusermapping
Sql-dropview
Sql-end
Sql-execute
Sql-explain
Sql-fetch
Sql-grant
Sql-insert
Sql-listen
Sql-load
Sql-lock
Sql-move
Sql-notify
Sql-prepare
Sql-prepare-transaction
Sql-reassign-owned
Sql-reindex
Sql-release-savepoint
Sql-reset
Sql-revoke
Sql-rollback
Sql-rollback-prepared
Sql-rollback-to
Sql-savepoint
Sql-select
Sql-selectinto
Sql-set
Sql-set-constraints
Sql-set-role
Sql-set-session-authorization
Sql-set-transaction
Sql-show
Sql-start-transaction
Sql-truncate
Sql-unlisten
Sql-update
Sql-vacuum
Sql-values
II. 客戶(hù)端應(yīng)用程序
App-clusterdb
App-createdb
App-createlang
App-createuser
App-dropdb
App-droplang
App-dropuser
App-ecpg
App-pgconfig
App-pgdump
App-pg-dumpall
App-pgrestore
App-psql
App-reindexdb
App-vacuumdb
III. PostgreSQL服務(wù)器應(yīng)用程序
App-initdb
App-pgcontroldata
App-pg-ctl
App-pgresetxlog
App-postgres
App-postmaster
VII. 內(nèi)部
章44. PostgreSQL內(nèi)部概覽
44.1. 查詢(xún)路徑
44.2. 連接是如何建立起來(lái)的
44.3. 分析器階段
44.4. ThePostgreSQL規(guī)則系統(tǒng)
44.5. 規(guī)劃器/優(yōu)化器
44.6. 執(zhí)行器
章45. 系統(tǒng)表
45.1. 概述
45.2. pg_aggregate
45.3. pg_am
45.4. pg_amop
45.5. pg_amproc
45.6. pg_attrdef
45.7. pg_attribute
45.8. pg_authid
45.9. pg_auth_members
45.10. pg_cast
45.11. pg_class
45.12. pg_constraint
45.13. pg_conversion
45.14. pg_database
45.15. pg_db_role_setting
45.16. pg_default_acl
45.17. pg_depend
45.18. pg_description
45.19. pg_enum
45.20. pg_foreign_data_wrapper
45.21. pg_foreign_server
45.22. pg_index
45.23. pg_inherits
45.24. pg_language
45.25. pg_largeobject
45.26. pg_largeobject_metadata
45.27. pg_namespace
45.28. pg_opclass
45.29. pg_operator
45.30. pg_opfamily
45.31. pg_pltemplate
45.32. pg_proc
45.33. pg_rewrite
45.34. pg_shdepend
45.35. pg_shdescription
45.36. pg_statistic
45.37. pg_tablespace
45.38. pg_trigger
45.39. pg_ts_config
45.40. pg_ts_config_map
45.41. pg_ts_dict
45.42. pg_ts_parser
45.43. pg_ts_template
45.44. pg_type
45.45. pg_user_mapping
45.46. System Views
45.47. pg_cursors
45.48. pg_group
45.49. pg_indexes
45.50. pg_locks
45.51. pg_prepared_statements
45.52. pg_prepared_xacts
45.53. pg_roles
45.54. pg_rules
45.55. pg_settings
45.56. pg_shadow
45.57. pg_stats
45.58. pg_tables
45.59. pg_timezone_abbrevs
45.60. pg_timezone_names
45.61. pg_user
45.62. pg_user_mappings
45.63. pg_views
章46. Frontend/Backend Protocol
46.1. Overview
46.2. Message Flow
46.3. Streaming Replication Protocol
46.4. Message Data Types
46.5. Message Formats
46.6. Error and Notice Message Fields
46.7. Summary of Changes since Protocol 2.0
47. PostgreSQL Coding Conventions
47.1. Formatting
47.2. Reporting Errors Within the Server
47.3. Error Message Style Guide
章48. Native Language Support
48.1. For the Translator
48.2. For the Programmer
章49. Writing A Procedural Language Handler
章50. Genetic Query Optimizer
50.1. Query Handling as a Complex Optimization Problem
50.2. Genetic Algorithms
50.3. Genetic Query Optimization (GEQO) in PostgreSQL
50.4. Further Reading
章51. 索引訪問(wèn)方法接口定義
51.1. 索引的系統(tǒng)表記錄
51.2. 索引訪問(wèn)方法函數(shù)
51.3. 索引掃描
51.4. 索引鎖的考量
51.5. 索引唯一性檢查
51.6. 索引開(kāi)銷(xiāo)估計(jì)函數(shù)
章52. GiST Indexes
52.1. Introduction
52.2. Extensibility
52.3. Implementation
52.4. Examples
52.5. Crash Recovery
章53. GIN Indexes
53.1. Introduction
53.2. Extensibility
53.3. Implementation
53.4. GIN tips and tricks
53.5. Limitations
53.6. Examples
章54. 數(shù)據(jù)庫(kù)物理存儲(chǔ)
54.1. 數(shù)據(jù)庫(kù)文件布局
54.2. TOAST
54.3. 自由空間映射
54.4. 可見(jiàn)映射
54.5. 數(shù)據(jù)庫(kù)分頁(yè)文件
章55. BKI后端接口
55.1. BKI 文件格式
55.2. BKI命令
55.3. 系統(tǒng)初始化的BKI文件的結(jié)構(gòu)
55.4. 例子
章56. 規(guī)劃器如何使用統(tǒng)計(jì)信息
56.1. 行預(yù)期的例子
VIII. 附錄
A. PostgreSQL錯(cuò)誤代碼
B. 日期/時(shí)間支持
B.1. 日期/時(shí)間輸入解析
B.2. 日期/時(shí)間關(guān)鍵字
B.3. 日期/時(shí)間配置文件
B.4. 日期單位的歷史
C. SQL關(guān)鍵字
D. SQL Conformance
D.1. Supported Features
D.2. Unsupported Features
E. Release Notes
Release-0-01
Release-0-02
Release-0-03
Release-1-0
Release-1-01
Release-1-02
Release-1-09
Release-6-0
Release-6-1
Release-6-1-1
Release-6-2
Release-6-2-1
Release-6-3
Release-6-3-1
Release-6-3-2
Release-6-4
Release-6-4-1
Release-6-4-2
Release-6-5
Release-6-5-1
Release-6-5-2
Release-6-5-3
Release-7-0
Release-7-0-1
Release-7-0-2
Release-7-0-3
Release-7-1
Release-7-1-1
Release-7-1-2
Release-7-1-3
Release-7-2
Release-7-2-1
Release-7-2-2
Release-7-2-3
Release-7-2-4
Release-7-2-5
Release-7-2-6
Release-7-2-7
Release-7-2-8
Release-7-3
Release-7-3-1
Release-7-3-10
Release-7-3-11
Release-7-3-12
Release-7-3-13
Release-7-3-14
Release-7-3-15
Release-7-3-16
Release-7-3-17
Release-7-3-18
Release-7-3-19
Release-7-3-2
Release-7-3-20
Release-7-3-21
Release-7-3-3
Release-7-3-4
Release-7-3-5
Release-7-3-6
Release-7-3-7
Release-7-3-8
Release-7-3-9
Release-7-4
Release-7-4-1
Release-7-4-10
Release-7-4-11
Release-7-4-12
Release-7-4-13
Release-7-4-14
Release-7-4-15
Release-7-4-16
Release-7-4-17
Release-7-4-18
Release-7-4-19
Release-7-4-2
Release-7-4-20
Release-7-4-21
Release-7-4-22
Release-7-4-23
Release-7-4-24
Release-7-4-25
Release-7-4-26
Release-7-4-27
Release-7-4-28
Release-7-4-29
Release-7-4-3
Release-7-4-30
Release-7-4-4
Release-7-4-5
Release-7-4-6
Release-7-4-7
Release-7-4-8
Release-7-4-9
Release-8-0
Release-8-0-1
Release-8-0-10
Release-8-0-11
Release-8-0-12
Release-8-0-13
Release-8-0-14
Release-8-0-15
Release-8-0-16
Release-8-0-17
Release-8-0-18
Release-8-0-19
Release-8-0-2
Release-8-0-20
Release-8-0-21
Release-8-0-22
Release-8-0-23
Release-8-0-24
Release-8-0-25
Release-8-0-26
Release-8-0-3
Release-8-0-4
Release-8-0-5
Release-8-0-6
Release-8-0-7
Release-8-0-8
Release-8-0-9
Release-8-1
Release-8-1-1
Release-8-1-10
Release-8-1-11
Release-8-1-12
Release-8-1-13
Release-8-1-14
Release-8-1-15
Release-8-1-16
Release-8-1-17
Release-8-1-18
Release-8-1-19
Release-8-1-2
Release-8-1-20
Release-8-1-21
Release-8-1-22
Release-8-1-23
Release-8-1-3
Release-8-1-4
Release-8-1-5
Release-8-1-6
Release-8-1-7
Release-8-1-8
Release-8-1-9
Release-8-2
Release-8-2-1
Release-8-2-10
Release-8-2-11
Release-8-2-12
Release-8-2-13
Release-8-2-14
Release-8-2-15
Release-8-2-16
Release-8-2-17
Release-8-2-18
Release-8-2-19
Release-8-2-2
Release-8-2-20
Release-8-2-21
Release-8-2-3
Release-8-2-4
Release-8-2-5
Release-8-2-6
Release-8-2-7
Release-8-2-8
Release-8-2-9
Release-8-3
Release-8-3-1
Release-8-3-10
Release-8-3-11
Release-8-3-12
Release-8-3-13
Release-8-3-14
Release-8-3-15
Release-8-3-2
Release-8-3-3
Release-8-3-4
Release-8-3-5
Release-8-3-6
Release-8-3-7
Release-8-3-8
Release-8-3-9
Release-8-4
Release-8-4-1
Release-8-4-2
Release-8-4-3
Release-8-4-4
Release-8-4-5
Release-8-4-6
Release-8-4-7
Release-8-4-8
Release-9-0
Release-9-0-1
Release-9-0-2
Release-9-0-3
Release-9-0-4
F. 額外提供的模塊
F.1. adminpack
F.2. auto_explain
F.3. btree_gin
F.4. btree_gist
F.5. chkpass
F.6. citext
F.7. cube
F.8. dblink
Contrib-dblink-connect
Contrib-dblink-connect-u
Contrib-dblink-disconnect
Contrib-dblink
Contrib-dblink-exec
Contrib-dblink-open
Contrib-dblink-fetch
Contrib-dblink-close
Contrib-dblink-get-connections
Contrib-dblink-error-message
Contrib-dblink-send-query
Contrib-dblink-is-busy
Contrib-dblink-get-notify
Contrib-dblink-get-result
Contrib-dblink-cancel-query
Contrib-dblink-get-pkey
Contrib-dblink-build-sql-insert
Contrib-dblink-build-sql-delete
Contrib-dblink-build-sql-update
F.9. dict_int
F.10. dict_xsyn
F.11. earthdistance
F.12. fuzzystrmatch
F.13. hstore
F.14. intagg
F.15. intarray
F.16. isn
F.17. lo
F.18. ltree
F.19. oid2name
F.20. pageinspect
F.21. passwordcheck
F.22. pg_archivecleanup
F.23. pgbench
F.24. pg_buffercache
F.25. pgcrypto
F.26. pg_freespacemap
F.27. pgrowlocks
F.28. pg_standby
F.29. pg_stat_statements
F.30. pgstattuple
F.31. pg_trgm
F.32. pg_upgrade
F.33. seg
F.34. spi
F.35. sslinfo
F.36. tablefunc
F.37. test_parser
F.38. tsearch2
F.39. unaccent
F.40. uuid-ossp
F.41. vacuumlo
F.42. xml2
G. 外部項(xiàng)目
G.1. 客戶(hù)端接口
G.2. 過(guò)程語(yǔ)言
G.3. 擴(kuò)展
H. The Source Code Repository
H.1. Getting The Source Via Git
I. 文檔
I.1. DocBook
I.2. 工具集
I.3. 制作文檔
I.4. 文檔寫(xiě)作
I.5. 風(fēng)格指導(dǎo)
J. 首字母縮略詞
參考書(shū)目
Bookindex
Index
?
Dieses Dokument verwendet PHP-Handbuch für chinesische Websites Freigeben
Figuren
27.4. 動(dòng)態(tài)跟蹤
PostgreSQL允許對(duì)數(shù)據(jù)庫(kù)服務(wù)器進(jìn)行動(dòng)態(tài)跟蹤。這樣就允許在代碼內(nèi)特 定的點(diǎn)上調(diào)用外部工具來(lái)跟蹤執(zhí)行過(guò)程。目前此功能主要目的是為了提供給數(shù)據(jù)庫(kù)開(kāi)發(fā)者使用，它要求使用者對(duì)代碼非常熟悉。
許多跟蹤點(diǎn)(也被稱(chēng)為"探頭")已經(jīng)插入在源代碼中了，這些探針的目的是被用于 數(shù)據(jù)庫(kù)開(kāi)發(fā)者管理員，默認(rèn)情況下，探頭不編譯成 PostgreSQL; 用戶(hù)必須在編譯前運(yùn)行configure腳本時(shí)明確啟用它們。
目前，只有 DTrace 支持實(shí)用工具，它可 在OpenSolaris，Solaris10操作系統(tǒng)，和MacOSXLeopard的。據(jù)預(yù)計(jì)， DTrace將可以在FreeBSD上的未來(lái)和其他可能的 操作系統(tǒng)?！?SystemTap項(xiàng)目 Linux還提供了一個(gè)DTrace的等效。支持其他動(dòng)態(tài), 通過(guò)改變src/include/utils/probes.h中的定義為跟蹤實(shí)用程序在理論上是可能的 。
27.4.1. 編譯動(dòng)態(tài)跟蹤支持
跟蹤點(diǎn)是默認(rèn)禁止的，你必須在運(yùn)行configure腳本在PostgreSQL時(shí)明確使 用--enable-dtrace選項(xiàng)來(lái)啟用DTrace支持。參見(jiàn)Section 15.5獲取更多信息。
27.4.2. 內(nèi)置跟蹤點(diǎn)
Table 27-3顯示的是在源代碼中提 供的標(biāo)準(zhǔn)跟蹤點(diǎn)，此外，也可以根據(jù)特定的具體問(wèn)題添加其它跟蹤點(diǎn)。 更多可以肯定會(huì)增加，以提高PostgreSQL的 觀測(cè)性。
Table 27-3. 內(nèi)置跟蹤點(diǎn)
| 名字 | 參數(shù) | 概述 |
|---|---|---|
| transaction-start | (LocalTransactionId) | 開(kāi)始新事務(wù)，arg0是事務(wù)ID。 |
| transaction-commit | (LocalTransactionId) | 事務(wù)成功完成，arg0是事務(wù)ID。 |
| transaction-abort | (LocalTransactionId) | 當(dāng)交易完成失敗將觸發(fā)的探測(cè)器。 arg0是事務(wù)ID。 |
| query-start | (constchar*) | 開(kāi)始處理查詢(xún)時(shí)將觸發(fā)的探測(cè)器。 arg0是查詢(xún)字符串。 |
| query-done | (constchar*) | 查詢(xún)處理完成時(shí)將觸發(fā)的探測(cè)器。 arg0是查詢(xún)字符串。 |
| query-parse-start | (constchar*) | 解析查詢(xún)開(kāi)始時(shí)將觸發(fā)的探測(cè)器。 arg0是查詢(xún)字符串。 |
| query-parse-done | (constchar*) | 完整解析查詢(xún)時(shí)觸發(fā)的探測(cè)器。 arg0是查詢(xún)字符串。 |
| query-rewrite-start | (constchar*) | 啟動(dòng)觸發(fā)的探測(cè)器時(shí)，查詢(xún)重寫(xiě)。 arg0是查詢(xún)字符串。 |
| query-rewrite-done | (constchar*) | 探頭觸發(fā)時(shí)，查詢(xún)重寫(xiě)是完整的。 arg0是查詢(xún)字符串。 |
| query-plan-start | () | 查詢(xún)規(guī)劃開(kāi)始時(shí)將觸發(fā)的探測(cè)器 |
| query-plan-done | () | 查詢(xún)規(guī)劃完成時(shí)將觸發(fā)的探測(cè)器 |
| query-execute-start | () | 執(zhí)行規(guī)劃開(kāi)始時(shí)將觸發(fā)的探測(cè)器 |
| query-execute-done | () | 執(zhí)行規(guī)劃完成時(shí)將觸發(fā)的探測(cè)器 |
| statement-status | (constchar*) | 服務(wù)進(jìn)程隨時(shí)更新pg_stat_activity.current_query 狀態(tài)時(shí)觸發(fā)的探測(cè)器。arg0是一個(gè)新的狀態(tài)字符串。 |
| checkpoint-start | (int) | 檢查點(diǎn)開(kāi)始時(shí)觸發(fā)的探測(cè)器。arg0可以逐位標(biāo)記以區(qū)分不同的檢查點(diǎn)類(lèi)型， 如；shutdown，immediate，或force。 |
| checkpoint-done | (int,int,int,int,int) | 檢查點(diǎn)完成時(shí)觸發(fā)的探測(cè)器。 （觸發(fā)列表列出檢查點(diǎn)處理過(guò)程中個(gè)，序列中的下一個(gè)探測(cè)器） arg0表示要寫(xiě)入的緩沖區(qū)的數(shù)目。arg1表示總的緩沖區(qū)的數(shù)目。 arg2，arg3和arg4包含了增加，刪除和循環(huán)回收的xlog文件的數(shù)目。 |
| clog-checkpoint-start | (bool) | 一個(gè)檢查點(diǎn)的CLOG部分開(kāi)始時(shí)觸發(fā)的探測(cè)器。 arg0對(duì)正常檢查點(diǎn)表示真，對(duì)關(guān)閉檢查點(diǎn)表示假。 |
| clog-checkpoint-done | (bool) | 當(dāng)一個(gè)檢查點(diǎn)的CLOG部分完成時(shí)觸發(fā)的探測(cè)器。arg0的含義與CLOG-checkpoint-start一樣。 |
| subtrans-checkpoint-start | (bool) | 當(dāng)一個(gè)檢查點(diǎn)的SUBTRANS部分開(kāi)始時(shí)觸發(fā)的探測(cè)器。arg0對(duì)正常檢查點(diǎn)表示真，對(duì) 關(guān)閉檢查點(diǎn)表示假。 |
| subtrans-checkpoint-done | (bool) | 當(dāng)一個(gè)檢查點(diǎn)的SUBTRANS部分完成時(shí)觸發(fā)的探測(cè)器。arg0的含義與SUBTRANS-checkpoint-start一樣。 |
| multixact-checkpoint-start | (bool) | 當(dāng)一個(gè)檢查點(diǎn)的MultiXact部分開(kāi)始時(shí)觸發(fā)的探測(cè)器。arg0對(duì)正常檢查點(diǎn)表示真，對(duì) 關(guān)閉檢查點(diǎn)表示假。 |
| multixact-checkpoint-done | (bool) | 當(dāng)一個(gè)檢查點(diǎn)的MultiXact部分完成時(shí)觸發(fā)的探測(cè)器。arg0的含義與multixact-checkpoint-start一樣。 |
| buffer-checkpoint-start | (int) | 開(kāi)始一個(gè)檢查點(diǎn)的緩沖區(qū)寫(xiě)部分時(shí)觸發(fā)的探測(cè)器。 arg0持有逐位標(biāo)識(shí)以區(qū)分不同的檢查點(diǎn)類(lèi)型，如shutdown，immediate或force。 |
| buffer-sync-start | (int,int) | 檢查點(diǎn)期間，開(kāi)始寫(xiě)臟緩沖區(qū)時(shí)觸發(fā)的探測(cè)器（在識(shí)別出那個(gè)緩沖區(qū)必須寫(xiě)之后）。 arg0表示總緩沖區(qū)數(shù)，arg1表示當(dāng)前臟的，需要寫(xiě)的緩沖區(qū)數(shù)。 |
| buffer-sync-written | (int) | 在檢查點(diǎn)期間，每個(gè)緩沖區(qū)都被寫(xiě)了之后觸發(fā)的探測(cè)器， arg0表示緩沖區(qū)的ID號(hào)。 |
| buffer-sync-done | (int,int,int) | 當(dāng)所有臟緩沖被寫(xiě)之后觸發(fā)的探測(cè)器。 arg0表示總緩沖區(qū)的數(shù)目。 arg1表示檢查點(diǎn)進(jìn)程實(shí)際寫(xiě)的緩沖區(qū)數(shù)。 arg2表示期望寫(xiě)的數(shù)目(arg1 of buffer-sync-start)； 任何的不同會(huì)導(dǎo)致另一個(gè)進(jìn)程在檢查點(diǎn)發(fā)生時(shí)刷寫(xiě)緩沖區(qū)。 |
| buffer-checkpoint-sync-start | () | 當(dāng)完成將臟緩沖區(qū)寫(xiě)入到內(nèi)核，并且還沒(méi)有發(fā)出fsync請(qǐng)求之前觸發(fā)的探測(cè)器。 |
| buffer-checkpoint-done | () | 當(dāng)同步緩沖區(qū)到磁盤(pán)完成時(shí)觸發(fā)的探測(cè)器。 |
| twophase-checkpoint-start | () | 當(dāng)一個(gè)檢查點(diǎn)的兩相階段狀態(tài)部分開(kāi)始時(shí)觸發(fā)的探測(cè)器。 |
| twophase-checkpoint-done | () | 當(dāng)一個(gè)檢查點(diǎn)的兩相階段狀態(tài)部分完成時(shí)觸發(fā)的探測(cè)器。 |
| buffer-read-start | (ForkNumber,BlockNumber,O id,O id,O id,bool,bool) | 當(dāng)開(kāi)始一次緩沖區(qū)讀時(shí)觸發(fā)的探測(cè)器。 arg0和arg1包含page塊中鎖和派生的子進(jìn)程數(shù)（如果是一個(gè)關(guān)系擴(kuò)展請(qǐng)求，arg1會(huì)是-1）。 arg2，arg3和arg4包含表空間，數(shù)據(jù)庫(kù)和關(guān)系OID，以識(shí)別關(guān)系。 arg5對(duì)本地緩沖區(qū)表示真，對(duì)共享緩沖區(qū)表示假。 arg6對(duì)關(guān)系擴(kuò)展請(qǐng)求表示真，對(duì)正常讀表示假。 |
| buffer-read-done | (ForkNumber,BlockNumber,O id,O id,O id,bool,bool,bool) | 當(dāng)完成一次緩沖區(qū)讀時(shí)觸發(fā)的探測(cè)器。 arg0和arg1包含page塊中鎖和派生的子進(jìn)程數(shù)（如果是一個(gè)關(guān)系擴(kuò)展請(qǐng)求，arg1會(huì)表示新增鎖的數(shù)目）。 arg2，arg3和arg4包含表空間，數(shù)據(jù)庫(kù)和關(guān)系OID，以識(shí)別關(guān)系。 arg5對(duì)本地緩沖區(qū)表示真，對(duì)共享緩沖區(qū)表示假。 arg6對(duì)關(guān)系擴(kuò)展請(qǐng)求表示真，對(duì)正常讀表示假。 如果池中有緩沖區(qū)，則arg7表示真，反之表示假。 |
| buffer-flush-start | (ForkNumber,BlockNumber,O id,O id,O id) | 在發(fā)出共享緩沖區(qū)的任意寫(xiě)入請(qǐng)求時(shí)觸發(fā)的探測(cè)器。 arg0和arg1包含page塊中鎖和派生的子進(jìn)程數(shù)。 arg2，arg3和arg4包含表空間，數(shù)據(jù)庫(kù)和關(guān)系OID，以識(shí)別關(guān)系。 |
| buffer-flush-done | (ForkNumber,BlockNumber,O id,O id,O id) | 當(dāng)完成一條寫(xiě)要求時(shí)觸發(fā)的探測(cè)器。 需要注意的是，它只影響將數(shù)據(jù)傳遞到內(nèi)核參數(shù)的時(shí)間； 實(shí)際上，它不會(huì)寫(xiě)到磁盤(pán)上。這個(gè)參數(shù)與buffer-flush-start一致。 |
| buffer-write-dirty-start | (ForkNumber,BlockNumber,O id,O id,O id) | 當(dāng)服務(wù)器進(jìn)程開(kāi)始寫(xiě)臟緩沖區(qū)時(shí)觸發(fā)的探測(cè)電器。如果經(jīng)常發(fā)生，表示shared_buffers太小 ，或需要調(diào)整bgwriter控制參數(shù)。 arg0和arg1包含page塊中鎖和派生的子進(jìn)程數(shù)。 arg2，arg3和arg4包含表空間，數(shù)據(jù)庫(kù)和關(guān)系OID，以識(shí)別關(guān)系。 |
| buffer-write-dirty-done | (ForkNumber,BlockNumber,O id,O id,O id) | 當(dāng)完成臟緩沖區(qū)寫(xiě)時(shí)觸發(fā)的探測(cè)器。 參數(shù)與buffer-write-dirty-start一樣。 |
| wal-buffer-write-dirty-start | () | 當(dāng)服務(wù)器進(jìn)程開(kāi)始寫(xiě)臟讀時(shí)觸發(fā)的探測(cè)器（此時(shí)WAL緩沖區(qū)已滿(mǎn)）。 如果經(jīng)常發(fā)生，應(yīng)該是wal_buffers設(shè)置的太小了。 |
| wal-buffer-write-dirty-done | () | 當(dāng)完成一次WAL臟寫(xiě)時(shí)觸發(fā)的探測(cè)器。 |
| xlog-insert | (unsignedchar,unsignedchar) | 當(dāng)插入一條WAL記錄時(shí)觸發(fā)的探測(cè)器。 arg0表示記錄的rm id。 arg1包含信息標(biāo)志。 |
| xlog-switch | () | 當(dāng)要求進(jìn)行WAL切換時(shí)觸發(fā)的探測(cè)器。 |
| smgr-md-read-start | (ForkNumber,BlockNumber,O id,O id,O id) | 開(kāi)始從一個(gè)關(guān)系中寫(xiě)鎖時(shí)觸發(fā)的探測(cè)器。 arg0和arg1包含page塊中鎖和派生的子進(jìn)程數(shù)。 arg2，arg3和arg4包含表空間，數(shù)據(jù)庫(kù)和關(guān)系OID，以識(shí)別關(guān)系。 |
| smgr-md-read-done | (ForkNumber,BlockNumber,O id,O id,O id,int,int) | 當(dāng)一個(gè)鎖寫(xiě)完成時(shí)觸發(fā)的探測(cè)器。 arg0和arg1包含page塊中鎖和派生的子進(jìn)程數(shù)。 arg2，arg3和arg4包含表空間，數(shù)據(jù)庫(kù)和關(guān)系OID，以識(shí)別關(guān)系。 arg5表示實(shí)際讀的字節(jié)數(shù)，而arg6表示要求的字節(jié)數(shù)（如果不一樣會(huì)報(bào)錯(cuò)）。 |
| smgr-md-write-start | (ForkNumber,BlockNumber,O id,O id,O id) | 當(dāng)向一個(gè)關(guān)系中寫(xiě)入鎖時(shí)觸發(fā)的探測(cè)器。 arg0和arg1包含page塊中鎖和派生子進(jìn)程數(shù)。 arg2，arg3和arg4包含表空間，數(shù)據(jù)庫(kù)和關(guān)系OID，以識(shí)別關(guān)系。 |
| smgr-md-write-done | (ForkNumber,BlockNumber,O id,O id,O id,int,int) | 當(dāng)一個(gè)鎖寫(xiě)進(jìn)程完成時(shí)觸發(fā)的探測(cè)器。 arg0和arg1表示page塊的鎖和派生的子進(jìn)程數(shù)。 arg2，arg3和arg4包含表空間，數(shù)據(jù)庫(kù)和關(guān)系OID。 arg5表示實(shí)際寫(xiě)的字節(jié)數(shù)，而arg6表示要求的數(shù)目（如果不一樣會(huì)報(bào)錯(cuò)）。 |
| sort-start | (int,bool,int,int,bool) | 排序操作開(kāi)始時(shí)觸發(fā)的探測(cè)器。 arg1對(duì)強(qiáng)制唯一值表示真。 arg2表示鍵列的數(shù)目。 arg3表示允許使用的內(nèi)存數(shù)目（以千字節(jié)為單位）。 如果要求隨機(jī)訪問(wèn)排序結(jié)果，那么arg4表示真。 |
| sort-done | (bool,long) | 排序操作結(jié)束時(shí)觸發(fā)的探測(cè)器。 arg0對(duì)外部排序表示真，內(nèi)部排序表示假。 arg1表示用于一個(gè)外部排序的磁盤(pán)鎖的數(shù)目，或用于一個(gè)內(nèi)部排序的，以千字節(jié)為單位的內(nèi)存數(shù)目。 |
| lwlock-acquire | (LWLockId,LWLockMode) | 當(dāng)成功獲得一個(gè)LWLock時(shí)觸發(fā)的探測(cè)器。 arg0是LWLock的ID號(hào)，arg1表明請(qǐng)求的鎖的模式，要么獨(dú)占要么共享 |
| lwlock-release | (LWLockId) | LWLock釋放時(shí)觸發(fā)的探測(cè)器。arg0表示LWLock的ID號(hào)。 |
| lwlock-wait-start | (LWLockId,LWLockMode) | 當(dāng)不能立即獲得LWLock鎖，同時(shí)服務(wù)進(jìn)程進(jìn)入等待時(shí)觸發(fā)的探測(cè)器。 arg0是LWLock的ID號(hào)，arg1表明請(qǐng)求的鎖的模式，要么獨(dú)占要么共享。 |
| lwlock-wait-done | (LWLockId,LWLockMode) | 當(dāng)從一個(gè)LWLock鎖中釋放服務(wù)進(jìn)程時(shí)觸發(fā)的探測(cè)器（實(shí)際上沒(méi)有進(jìn)行鎖）。 arg0是LWLock的ID號(hào)，arg1表明請(qǐng)求的鎖的模式，要么獨(dú)占要么共享。 |
| lwlock-condacquire | (LWLockId,LWLockMode) | 當(dāng)成功獲得一個(gè)LWLock時(shí)觸發(fā)的探測(cè)器（已聲明調(diào)用無(wú)需等待）。 arg0是LWLock的ID號(hào)，arg1表明請(qǐng)求的鎖的模式，要么獨(dú)占要么共享。 |
| lwlock-condacquire-fail | (LWLockId,LWLockMode) | 當(dāng)沒(méi)有成功獲得一個(gè)LWLock時(shí)觸發(fā)的探測(cè)器（已聲明調(diào)用無(wú)需等待）。 arg0是LWLock的ID號(hào)，arg1表明請(qǐng)求的鎖的模式，要么獨(dú)占要么共享。 |
| lock-wait-start | (unsignedint,unsignedint,unsignedint,unsignedint,unsignedint,LOCKMODE) | 當(dāng)一個(gè)重量級(jí)鎖（lmgr鎖）的請(qǐng)求開(kāi)始等待（因?yàn)闊o(wú)法獲得鎖）時(shí)觸發(fā)的探測(cè)器。 arg0到arg3是辨別被鎖定對(duì)象的標(biāo)簽字段。arg4指出被鎖對(duì)象的類(lèi)型。 arg5表示請(qǐng)求的鎖類(lèi)型。 |
| lock-wait-done | (unsignedint,unsignedint,unsignedint,unsignedint,unsignedint,LOCKMODE) | 當(dāng)一個(gè)重量級(jí)鎖（lmgr鎖）的請(qǐng)求結(jié)束等待時(shí)觸發(fā)的探測(cè)器，參數(shù)與lock-wait-start一樣。 |
| deadlock-found | () | 當(dāng)死鎖探測(cè)器發(fā)現(xiàn)死鎖是觸發(fā)的探測(cè)器 |
Table 27-4. 定義用于探測(cè)器參數(shù)的類(lèi)型
| 類(lèi)型 | 定義 |
|---|---|
| LocalTransactionId | unsignedint |
| LWLockId | int |
| LWLockMode | int |
| LOCKMODE | int |
| BlockNumber | unsignedint |
| O id | unsignedint |
| ForkNumber | int |
| bool | char |
27.4.3. 使用跟蹤點(diǎn)
下面的例子示范了一個(gè)分析事務(wù)次數(shù)的DTrace腳本，可以用來(lái)代替在性能測(cè)試 之前和之后的pg_stat_database快照。
#!/usr/sbin/dtrace-qs
postgresql$1:::transaction-start
{
@start["Start"]=count();
self->ts=timestamp;
}
postgresql$1:::transaction-abort
{
@abort["Abort"]=count();
}
postgresql$1:::transaction-commit
/self->ts/
{
@commit["Commit"]=count();
@time["Totaltime(ns)"]=sum(timestamp-self->ts);
self->ts=0;
}
例如示范D腳本執(zhí)行時(shí)，如輸出：
#./txn_count.d`pgrep-npostgres`or./txn_count.d<PID> ^C Start71 Commit70 Totaltime(ns)2312105013
Note: SystemTap為跟蹤腳本使用一個(gè)不同的標(biāo)記而不是Dtrace，即使底層的跟蹤點(diǎn)是兼容的。 有一點(diǎn)需要注意，在這樣寫(xiě)的時(shí)候，SystemTap腳本必須使用雙下劃線代替連字符來(lái)指向探測(cè)器名。
必須在實(shí)際使用跟蹤程序前進(jìn)行仔細(xì)的編寫(xiě)和充分的調(diào)試，否則收集到的跟蹤信息可能毫 無(wú)意義。大多數(shù)問(wèn)題是由于外部跟蹤程序錯(cuò)誤導(dǎo)致的而不是底層系統(tǒng)。在討論使 用動(dòng)態(tài)跟蹤發(fā)現(xiàn)的信息時(shí)，應(yīng)確保在其中包含你使用的跟蹤腳本。
更多的示例腳本，可以發(fā)現(xiàn)在PgFoundrydtraceproject.
27.4.4. 定義跟蹤點(diǎn)
開(kāi)發(fā)者可以在代碼中任意位置定義新的跟蹤點(diǎn)，當(dāng)然這要重新編譯之后才能生效。下面是 用于新探測(cè)器插入步驟：
通過(guò)探頭決定探頭名字和數(shù)據(jù)可利用。
新增探頭定義為src/backend/utils/probes.d
包括pg_trace.h，如果已經(jīng)不在模塊中包含探測(cè)點(diǎn)，并且在 所需源代碼中期望的位置插入TRACE_POSTGRESQL探測(cè)宏。
重新編譯和驗(yàn)證，新探頭是可用的
Example: 下面是一個(gè)例子，你將如何添加一個(gè)探頭，追蹤所有新的 交易通過(guò)事務(wù)ID。
決定，探測(cè)器將被命名為transaction-start并且 需要LocalTransactionId類(lèi)型參數(shù)
-
新增探頭定義為src/backend/utils/probes.d
probetransaction__start(LocalTransactionId);
注意在探測(cè)器名字中的雙下劃線。在一個(gè)DTrace使用探測(cè)器，需要用一個(gè)連字符來(lái)替換雙下滑線，因此 ，對(duì)用戶(hù)而言，transaction-start是文檔名。
-
在編譯時(shí)，transaction__start被轉(zhuǎn)換成一個(gè)宏調(diào)用TRACE_POSTGRESQL_TRANSACTION_START （注意這里是單下劃線），可以從pg_trace.h中獲得。將宏調(diào)用放在源代碼中的合適位置。 在這種情況下，類(lèi)似下面：
TRACE_POSTGRESQL_TRANSACTION_START(vx id.localTransactionId);
-
在重新編譯和運(yùn)行新的二進(jìn)制文件之后，通過(guò)運(yùn)行下面的DTrace命令來(lái)檢查新增的探測(cè)器是否可用。 應(yīng)該得到類(lèi)似下面的結(jié)果：
#dtrace-lntransaction-start IDPROVIDERMODULEFUNCTIONNAME 18705postgresql49878postgresStartTransactionCommandtransaction-start 18755postgresql49877postgresStartTransactionCommandtransaction-start 18805postgresql49876postgresStartTransactionCommandtransaction-start 18855postgresql49875postgresStartTransactionCommandtransaction-start 18986postgresql49873postgresStartTransactionCommandtransaction-start
向C代碼中添加跟蹤宏時(shí)，有一些注意事項(xiàng)，見(jiàn)下文。
需要注意的是，為探測(cè)器參數(shù)聲明的數(shù)據(jù)類(lèi)型要匹配宏中可用的數(shù)據(jù)類(lèi)型，否則會(huì)發(fā)生編譯錯(cuò)誤。
-
在大多數(shù)平臺(tái)上，如果編譯PostgreSQL時(shí)帶有--enable-dtrace選項(xiàng)， 無(wú)論何時(shí)通過(guò)宏來(lái)控制時(shí)，都會(huì)估算該跟蹤宏的參數(shù)，即使沒(méi)有進(jìn)行跟蹤。通常不需要擔(dān)心是否你只是報(bào)告一些局部變量的值。 但要注意將重要的函數(shù)調(diào)用放置在參數(shù)中。如果需要這么做，考慮通過(guò)檢查跟蹤是否真的開(kāi)啟的檢查來(lái)保護(hù)宏：
if(TRACE_POSTGRESQL_TRANSACTION_START_ENABLED()) TRACE_POSTGRESQL_TRANSACTION_START(some_function(...));
每個(gè)跟蹤宏都有一個(gè)相應(yīng)的ENABLED宏。