前言
何为PostgreSQL？
PostgreSQL简史
格式约定
更多信息
臭虫汇报指导
I. 教程
章1. 从头开始
1.1. 安装
1.2. 体系基本概念
1.3. 创建一个数据库
1.4. 访问数据库
章2. SQL语言
2.1. 介绍
2.2. 概念
2.3. 创建新表
2.4. 向表中添加行
2.5. 查询一个表
2.6. 表间链接
2.7. 聚集函数
2.8. 更新
2.9. 删除
章3. 高级特性
3.1. 介绍
3.2. 视图
3.3. 外键
3.4. 事务
3.5. 窗口函数
3.6. 继承
3.7. 结论
II. SQL语言
章4. SQL语法
4.1. 词法结构
4.2. 值表达式
4.3. 调用函数
章5. 数据定义
5.1. 表的基本概念
5.2. 缺省值
5.3. 约束
5.4. 系统字段
5.5. 修改表
5.6. 权限
5.7. 模式
5.8. 继承
5.9. 分区
5.10. 其它数据库对象
5.11. 依赖性跟踪
章 6. 数据操作
6.1. 插入数据
6.2. 更新数据
6.3. 删除数据
章7. 查询
7.1. 概述
7.2. 表表达式
7.3. 选择列表
7.4. 组合查询
7.5. 行排序
7.6. LIMIT和OFFSET
7.7. VALUES列表
7.8. WITH的查询（公用表表达式）
章8. 数据类型
8.1. 数值类型
8.2. 货币类型
8.3. 字符类型
8.4. 二进制数据类型
8.5. 日期/时间类型
8.6. 布尔类型
8.7. 枚举类型
8.8. 几何类型
8.9. 网络地址类型
8.10. 位串类型
8.11. 文本搜索类型
8.12. UUID类型
8.13. XML类型
8.14. 数组
8.15. 复合类型
8.16. 对象标识符类型
8.17. 伪类型
章 9. 函数和操作符
9.1. 逻辑操作符
9.2. 比较操作符
9.3. 数学函数和操作符
9.4. 字符串函数和操作符
9.5. 二进制字符串函数和操作符
9.6. 位串函数和操作符
9.7. 模式匹配
9.8. 数据类型格式化函数
9.9. 时间/日期函数和操作符
9.10. 支持枚举函数
9.11. 几何函数和操作符
9.12. 网络地址函数和操作符
9.13. 文本检索函数和操作符
9.14. XML函数
9.15. 序列操作函数
9.16. 条件表达式
9.17. 数组函数和操作符
9.18. 聚合函数
9.19. 窗口函数
9.20. 子查询表达式
9.21. 行和数组比较
9.22. 返回集合的函数
9.23. 系统信息函数
9.24. 系统管理函数
9.25. 触发器函数
章10. 类型转换
10.3. 函数
10.2. 操作符
10.1. 概述
10.4. 值存储
10.5. UNION
章11. 索引
11.1. 介绍
11.2. 索引类型
11.3. 多字段索引
11.4. 索引和ORDER BY
11.5. 组合多个索引
11.6. 唯一索引
11.7. 表达式上的索引
11.8. 部分索引
11.9. 操作类和操作簇
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. 并发控制
13.1. 介绍
13.2. 事务隔离
13.3. 明确锁定
13.4. 应用层数据完整性检查
13.5. 锁和索引
章14. 性能提升技巧
14.1. 使用EXPLAIN
14.2. 规划器使用的统计信息
14.3. 用明确的JOIN语句控制规划器
14.4. 向数据库中添加记录
14.5. 非持久性设置
III. 服务器管理
章15. 安装指导
15.1. 简版
15.2. 要求
15.3. 获取源码
15.4. 升级
15.5. 安装过程
15.6. 安装后的设置
15.7. 支持的平台
15.8. 特殊平台的要求
章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. 服务器安装和操作
17.1. PostgreSQL用户帐户
17.2. 创建数据库集群
17.3. 启动数据库服务器
17.4. 管理内核资源
17.5. 关闭服务
17.6. 防止服务器欺骗
17.7. 加密选项
17.8. 用SSL进行安全的TCP/IP连接
17.9. Secure TCP/IP Connections with SSH Tunnels
章18. 服务器配置
18.1. 设置参数
18.2. 文件位置
18.3. 连接和认证
18.4. 资源消耗
18.5. 预写式日志
18.6. 查询规划
18.7. 错误报告和日志
18.8. 运行时统计
18.9. 自动清理
18.10. 客户端连接缺省
18.12. 版本和平台兼容性
18.11. 锁管理
18.13. 预置选项
18.14. 自定义的选项
18.15. 开发人员选项
18.16. 短选项
章19. 用户认证
19.1. pg_hba.conf 文件
19.2. 用户名映射
19.3. 认证方法
19.4. 用户认证
章20. 数据库角色和权限
20.1. 数据库角色
20.2. 角色属性
20.3. 权限
20.4. 角色成员
20.5. 函数和触发器
章21. 管理数据库
21.1. 概述
21.2. 创建一个数据库
21.3. 临时库
21.4. 数据库配置
21.5. 删除数据库
21.6. 表空间
章22. 本土化
22.1. 区域支持
22.2. 字符集支持
章23. 日常数据库维护工作
23.1. Routine Vacuuming日常清理
23.2. 经常重建索引
23.3. 日志文件维护
章24. 备份和恢复
24.1. SQL转储
24.2. 文件系统级别的备份
24.3. 在线备份以及即时恢复(PITR)
24.4. 版本间迁移
章25. 高可用性与负载均衡，复制
25.1. 不同解决方案的比较
25.2. 日志传送备份服务器
25.3. 失效切换
25.4. 日志传送的替代方法
25.5. 热备
章26. 恢复配置
26.1. 归档恢复设置
26.2. 恢复目标设置
26.3. 备服务器设置
章27. 监控数据库的活动
27.1. 标准Unix工具
27.2. 统计收集器
27.3. 查看锁
27.4. 动态跟踪
章28. 监控磁盘使用情况
28.1. 判断磁盘的使用量
28.2. 磁盘满导致的失效
章29. 可靠性和预写式日志
29.1. 可靠性
29.2. 预写式日志(WAL)
29.3. 异步提交
29.4. WAL配置
29.5. WAL内部
章30. Regression Tests
30.1. Running the Tests
30.2. Test Evaluation
30.3. Variant Comparison Files
30.4. Test Coverage Examination
IV. 客户端接口
章31. libpq-C库
31.1. 数据库联接函数
31.2. 连接状态函数
31.3. 命令执行函数
31.4. 异步命令处理
31.5. 取消正在处理的查询
31.6. 捷径接口
31.7. 异步通知
31.8. 与COPY命令相关的函数
31.9. Control Functions 控制函数
31.10. 其他函数
31.11. 注意信息处理
31.12. 事件系统
31.13. 环境变量
31.14. 口令文件
31.15. 连接服务的文件
31.16. LDAP查找连接参数
31.17. SSL支持
31.18. 在多线程程序里的行为
31.19. 制作libpq程序
31.20. 例子程序
章32. 大对象
32.1. 介绍
32.2. 实现特点
32.3. 客户端接口
32.4. 服务器端函数
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. 关于这个模式
34.2. 数据类型
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. 触发器
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. 服务器端编程
章35. 扩展SQL
35.1. 扩展性是如何实现的
35.2. PostgreSQL类型系统
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++扩展
章36. 触发器
36.1. 触发器行为概述
36.3. 用 C 写触发器
36.2. 数据改变的可视性
36.4. 一个完整的例子
章37. 规则系统
37.1. The Query Tree
37.2. 视图和规则系统
37.3. 在INSERT，UPDATE和DELETE上的规则
37.4. 规则和权限
37.5. 规则和命令状态
37.6. 规则与触发器得比较
章38. Procedural Languages
38.1. Installing Procedural Languages
章39. PL/pgSQL - SQL过程语言
39.1. 概述
39.2. PL/pgSQL的结构
39.3. 声明
39.4. 表达式
39.5. 基本语句
39.6. 控制结构
39.7. 游标
39.8. 错误和消息
39.9. 触发器过程
39.10. PL/pgSQL Under the Hood
39.11. 开发PL/pgSQL的一些提示
39.12. 从OraclePL/SQL 进行移植
章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. 参考手册
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. 客户端应用程序
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服务器应用程序
App-initdb
App-pgcontroldata
App-pg-ctl
App-pgresetxlog
App-postgres
App-postmaster
VII. 内部
章44. PostgreSQL内部概览
44.1. 查询路径
44.2. 连接是如何建立起来的
44.3. 分析器阶段
44.4. ThePostgreSQL规则系统
44.5. 规划器/优化器
44.6. 执行器
章45. 系统表
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. 索引访问方法接口定义
51.1. 索引的系统表记录
51.2. 索引访问方法函数
51.3. 索引扫描
51.4. 索引锁的考量
51.5. 索引唯一性检查
51.6. 索引开销估计函数
章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. 数据库物理存储
54.1. 数据库文件布局
54.2. TOAST
54.3. 自由空间映射
54.4. 可见映射
54.5. 数据库分页文件
章55. BKI后端接口
55.1. BKI 文件格式
55.2. BKI命令
55.3. 系统初始化的BKI文件的结构
55.4. 例子
章56. 规划器如何使用统计信息
56.1. 行预期的例子
VIII. 附录
A. PostgreSQL错误代码
B. 日期/时间支持
B.1. 日期/时间输入解析
B.2. 日期/时间关键字
B.3. 日期/时间配置文件
B.4. 日期单位的历史
C. SQL关键字
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. 外部项目
G.1. 客户端接口
G.2. 过程语言
G.3. 扩展
H. The Source Code Repository
H.1. Getting The Source Via Git
I. 文档
I.1. DocBook
I.2. 工具集
I.3. 制作文档
I.4. 文档写作
I.5. 风格指导
J. 首字母缩略词
参考书目
Bookindex
Index
©
Ce document utilise Manuel du site Web PHP chinois Libérer
personnages
9.9. 时间/日期函数和操作符
Table 9-27显示了 PostgreSQL 里可以用于处理日期/时间数值的函数， 随后一节里描述了细节。表Table 9-26演示了基本算术操作符的行为。(+， *， 等)。而与格式化相关的函数，可以参考Section 9.8。 你应该很熟悉Section 8.5的日期/时间数据类型的背景知识。
所有下述函数和操作符接收的time或timestamp输入实际上都来自两种可能： 一种是接收time with time zoneortimestamp with time zone， 另外一种是接收time without time zone或timestamp without time zone。 出于简化考虑，这些变种没有独立显示出来。还有，+和*操作符都是以可交换的操作符对(比如， date + integer 和 integer + date)；我们只显示了这样的交换操作符对中的一个。
Table 9-26. 日期/时间操作符
| 操作符 | 示例 | 结果 |
|---|---|---|
| + | date '2001-09-28' + integer '7' | date '2001-10-05' |
| + | date '2001-09-28' + interval '1 hour' | timestamp '2001-09-28 01:00:00' |
| + | date '2001-09-28' + time '03:00' | timestamp '2001-09-28 03:00:00' |
| + | interval '1 day' + interval '1 hour' | interval '1 day 01:00:00' |
| + | timestamp '2001-09-28 01:00' + interval '23 hours' | timestamp '2001-09-29 00:00:00' |
| + | time '01:00' + interval '3 hours' | time '04:00:00' |
| - | - interval '23 hours' | interval '-23:00:00' |
| - | date '2001-10-01' - date '2001-09-28' | integer '3'(days) |
| - | date '2001-10-01' - integer '7' | date '2001-09-24' |
| - | date '2001-09-28' - interval '1 hour' | timestamp '2001-09-27 23:00:00' |
| - | time '05:00' - time '03:00' | interval '02:00:00' |
| - | time '05:00' - interval '2 hours' | time '03:00:00' |
| - | timestamp '2001-09-28 23:00' - interval '23 hours' | timestamp '2001-09-28 00:00:00' |
| - | interval '1 day' - interval '1 hour' | interval '1 day -01:00:00' |
| - | timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00' | interval '1 day 15:00:00' |
| * | 900 * interval '1 second' | interval '00:15:00' |
| * | 21 * interval '1 day' | interval '21 days' |
| * | double precision '3.5' * interval '1 hour' | interval '03:30:00' |
| / | interval '1 hour' / double precision '1.5' | interval '00:40:00' |
Table 9-27. 日期/时间函数
| 函数 | 返回类型 | 描述 | 示例 | 结果 |
|---|---|---|---|---|
age(timestamp，timestamp) |
interval | 参数相减， 返回一个使用年数和月份数的"符号"表示的结果 | age(timestamp '2001-04-10'， timestamp '1957-06-13') | 43 years 9 mons 27 days |
age(timestamp) |
interval | 从current_date（午夜）减去参数后的结果 |
age(timestamp '1957-06-13') | 43 years 8 mons 3 days |
clock_timestamp() |
timestamp with time zone | 实时时钟的当前时间戳（在语句执行中值会改变）；见Section 9.9.4。 | ||
current_date |
date | 当前日期；见Section 9.9.4 | ||
current_time |
time with time zone | 当前时间；见Section 9.9.4 | ||
current_timestamp |
timestamp with time zone | 当前事务开始时的时间戳；见Section 9.9.4 | ||
date_part(text，timestamp) |
double precision | 获取子域(等效于extract)；见Section 9.9.1
|
date_part('hour'， timestamp '2001-02-16 20:38:40') | 20 |
date_part(text，interval) |
double precision | 获取子域(等效于extract)；见Section 9.9.1
|
date_part('month'， interval '2 years 3 months') | 3 |
date_trunc(text，timestamp) |
timestamp | 截断成指定的精度；见Section 9.9.2 | date_trunc('hour'， timestamp '2001-02-16 20:38:40') | 2001-02-16 20:00:00 |
extract(fieldfrom
timestamp) |
double precision | 获取子域；见Section 9.9.1 | extract(hour from timestamp '2001-02-16 20:38:40') | 20 |
extract(fieldfrom
interval) |
double precision | 获取子域；又见 seeSection 9.9.1 | extract(month from interval '2 years 3 months') | 3 |
isfinite(date) |
boolean | 测试是否为有穷日期 | isfinite(date '2001-02-16') | true |
isfinite(timestamp) |
boolean | 测试是否为有穷时间戳 | isfinite(timestamp '2001-02-16 21:28:30') | true |
isfinite(interval) |
boolean | 测试是否为有穷时间间隔 | isfinite(interval '4 hours') | true |
justify_days(interval) |
interval | 按照每月 30 天计算时间间隔 | justify_days(interval '35 days') | 1 mon 5 days |
justify_hours(interval) |
interval | 按照每天 24 小时计算时间间隔 | justify_hours(interval '27 hours') | 1 day 03:00:00 |
justify_interval(interval) |
interval | 用justify_days和justify_hours计算时间间隔的，加上相应的正负号。
|
justify_interval(interval '1 mon -1 hour') | 29 days 23:00:00 |
localtime |
time | 当前时间；见Section 9.9.4 | ||
localtimestamp |
timestamp | 当前事务开始时的时间戳；见Section 9.9.4 | ||
now() |
timestamp with time zone | 当前事务开始时的时间戳；见Section 9.9.4 | ||
statement_timestamp() |
timestamp with time zone | 当前语句开始的时间戳；见Section 9.9.4 | ||
timeofday() |
text | 当前日期时间，与clock_timestamp相同，但结果是一个text字符串；见Section 9.9.4。
|
||
transaction_timestamp() |
timestamp with time zone | 当前事务开始时的时间戳；见Section 9.9.4 |
除了这些函数以外，还支持 SQL 的 OVERLAPS 操作符:
(start1，end1) OVERLAPS (start2，end2) (start1，length1) OVERLAPS (start2，length2)
这个表达式在两个时间域(用它们的终点定义)重叠的时候生成真值，否则为假。 终点可以用一对日期、时间、时间戳来声明；或者是一个后面跟着时间间隔的日期、时间、时间戳。 当提供一对值，不管先写开始还是结束；OVERLAPS自动将这对值较早的作为开始。 每段时间取值为半开区间开始<=时间<结束， 除非开始和结束相等，表示单一的时刻。这意味着两个时间段只有一个共同的端点没有重叠。
SELECT (DATE '2001-02-16'， DATE '2001-12-21') OVERLAPS
(DATE '2001-10-30'， DATE '2002-10-30');
Result:true
SELECT (DATE '2001-02-16'， INTERVAL '100 days') OVERLAPS
(DATE '2001-10-30'， DATE '2002-10-30');
Result:false
SELECT (DATE '2001-10-29'， DATE '2001-10-30') OVERLAPS
(DATE '2001-10-30'， DATE '2001-10-31');
Result:false
SELECT (DATE '2001-10-30'， DATE '2001-10-30') OVERLAPS
(DATE '2001-10-30'， DATE '2001-10-31');
Result:true
当把interval值添加到timestamp with time zone上(或从中减去)的时候， days 部分会按照指定的天数增加(或减少)timestamp with time zone的日期。 对于横跨夏令时的变化(会话的时区设置被识别为夏时制)，interval '1 day'并 不一定等于interval '24 hours'。例如，当会话的时区设置为CST7CDT的时候， timestamp with time zone '2005-04-02 12:00-07' + interval '1 day' 的结果 是 timestamp with time zone '2005-04-03 12:00-06' ，而 将interval '24 hours'增加到相同的timestamp with time zone之上的结果 则是timestamp with time zone '2005-04-03 12:00-06'， 因为CST7CDT时区在2005-04-03 02:00的时候有一个夏令时变更。
注意age返回的月数可能有歧义，因为不同的月份有不同的天数。
PostgreSQL的方法是当计算部分月数时，采用两个日期较早的月。例如：age('2004-06-01'， '2004-04-30')
使用4月份产生1 mon 1 day，当用5月分时产生1 mon 2 days，因为5月有31天，而4月只有30天。
9.9.1. EXTRACT，date_part
EXTRACT(fieldFROMsource)
extract函数从日期/时间数值里抽取子域，比如年、小时等。
source必须是一个 typetimestamp，time，interval类型的值
表达式(类型为date的表达式将转换为timestamp，因此也可以用)。
field是一个标识符或者字符串，它指定从源数据中抽取的域。
extract函数返回类型为 double precision 的数值。下列数值是有效数据域的名字：
- century
-
世纪
SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13'); Result:20 SELECT EXTRACT(CENTURY FROM TIMESTAMP '2001-02-16 20:38:40'); Result:21
第一个世纪从 0001-01-01 00:00:00 AD 开始，尽管那时候人们还不知道 这是第一个世纪。这个定义适用于所有使用阳历的国家。没有 0 世纪， 我们直接从公元前 1 世纪到公元 1 世纪。 如果你认为这个不合理，那么请把抱怨发给：梵蒂冈，罗马圣彼得教堂，教皇收
PostgreSQL8.0 以前版本里并不遵循世纪的习惯编号，只是把年份除以 100 。
- day
-
(月份)里的天(1-31)
SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40'); Result:16
- decade
-
年份除以 10
SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40'); Result:200
- dow
-
周中天的索引(0-6 ；星期天是 0)
SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40'); Result:5
请注意，
extract的周中天编号和to_char(...， 'D')函数不同。 - doy
-
一年的第几天(1-365/366)
SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40'); Result:47
- epoch
-
对于date和timestamp值而言，是自 1970-01-01 00:00:00-00 以来的秒数 (结果可能是负数)；对于interval值而言，它是时间间隔的总秒数。
SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08'); 结果:982384720.12 SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours'); 结果:442800
下面是把 epoch 值转换回时间戳的方法：
SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * INTERVAL '1 second';
(The
to_timestampfunction encapsulates the above conversion.) - hour
-
The hour field (0 - 23)小时域(0-23)
SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:20
- isodow
-
周中的第几天 [1-7] 星期一：1) 星期天：(7)。
SELECT EXTRACT(ISODOW FROM TIMESTAMP '2001-02-18 20:38:40'); 结果:7
dow除了星期天外，都相同。这与ISO8601标准周中的第几天编码相匹配。 matches theISO8601 day of the week numbering.
- isoyear
-
日期中的ISO8601标准年（不适用于间隔）。
SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01'); 结果:2005 SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02'); 结果:2006
每个带有星期一开始的周中包含1月4日的ISO年， 所以在年初的1月或12月下旬的ISO年可能会不同与阳历的年。 见week获取更多信息。
这个域不能用于 PostgreSQL 8.3之前的版本。
- microseconds
-
秒域(包括小数部分)乘以 1，000，000 。请注意它包括全部的秒。
SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5'); 结果:28500000
- millennium
-
千年
SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:3
20 世纪(19xx 年)里面的年份在第二个千年里。第三个千年从 2001 年 1 月 1 日零时开始。
PostgreSQL8.0 之前的版本并不遵循千年编号的习惯，只是返回年份除以 1000 。
- milliseconds
-
秒域(包括小数部分)乘以 1000 。请注意它包括完整的秒。
SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5'); Result:28500
- minute
-
分钟域(0-59)
SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40'); Result:38
- month
-
Fortimestampvalues， the number of the month within the year (1 - 12) ; forintervalvalues the number of months， modulo 12 (0 - 11) 对于timestamp值，它是一年里的月份数(1-12)； 对于interval值，它是月的编号，然后对 12 取模(0-11)
SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40'); Result:2 SELECT EXTRACT(MONTH FROM INTERVAL '2 years 3 months'); Result:3 SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months'); Result:1
- quarter
-
日期中年所在季度(1-4)(仅用于 timestamp 值)
SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40'); Result:1
- second
-
秒域，包括小数部分(0-59)[1]
SELECT EXTRACT(SECOND FROM TIMESTAMP '2001-02-16 20:38:40'); Result:40 SELECT EXTRACT(SECOND FROM TIME '17:12:28.5'); Result:28.5
- timezone
与UTC的时区偏移量，以秒记。正数对应 UTC 东边的时区，负数对应 UTC 西边的时区
- timezone_hour
时区偏移量的小时部分。
- timezone_minute
时区偏移量的分钟部分。
- week
-
该天在所在的年份里是第几周。 (ISO8601)定义一年的第一周包含该年的一月四日(ISO-8601 的周从星期一开始)。 换句话说，一年的第一个星期四在第一周。(只用于 timestamp 值)
因此，一月的头几天可能是前一年的第 52 或者第 53 周。 比如，2005-01-01是 2004 年的第 53 周，而2006-01-01是 2005 年的第 52 周
SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40'); Result:7
- year
-
年份域。要记住这里没有0 AD，所以从AD年里抽取BC年应该小心些
SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40'); Result:2001
extract函数主要的用途是运算。对于用于显示的日期/时间数值格式化，见Section 9.8。
date_part函数是仿照在传统的Ingres函数。等效于 SQL 标准函数extract：
date_part('field'，source)
Note that here thefieldparameter needs to
be a string value， not a name. The valid field names for
date_partare the same as for
extract.
请注意这里的field参数必须是一个字符串值，而不是一个名字。
date_part的有效域名参数和extract的一样。
SELECT date_part('day'， TIMESTAMP '2001-02-16 20:38:40');
Result:16
SELECT date_part('hour'， INTERVAL '4 hours 3 minutes');
Result:4
9.9.2. date_trunc
.
date_trunc函数在概念上和用于数字的trunc函数类似。
date_trunc('field'，source)
source是timestamp或interval类型的值表达式 (date和time类型的值都分别自动转换成timestamp或interval)。 用field选择对该时间戳值用什么样的精度进行截断。返回的数值 是timestamp或interval类型， 所有小于选定的精度的域都设置为零(日期和月份域则为 1)。
field的有效数值是：
| microseconds |
| milliseconds |
| second |
| minute |
| hour |
| day |
| week |
| month |
| quarter |
| year |
| decade |
| century |
| millennium |
例如：
SELECT date_trunc('hour'， TIMESTAMP '2001-02-16 20:38:40');
Result:2001-02-16 20:00:00
SELECT date_trunc('year'， TIMESTAMP '2001-02-16 20:38:40');
Result:2001-01-01 00:00:00
9.9.3. AT TIME ZONE
AT TIME ZONE构造允许把时间戳转换成不同的时区。表Table 9-28显示了其变体。
Table 9-28. AT TIME ZONE变体
| 表达式 | 返回类型 | 描述 |
|---|---|---|
| timestamp without time zoneAT TIME ZONEzone | timestamp with time zone | 将不带时区without time zone的时间戳转换成给定时区的时间戳 |
| timestamp with time zoneAT TIME ZONEzone | timestamp without time zone | 将带时区with time zone的时间戳转换为不带时区的时间。 |
| time with time zoneAT TIME ZONEzone | time with time zone | 将带时区with time zone的时间转换成给定时区的时间 |
在这些表达式里，zone可以声明为文本串(比如'PST')或者一个 时间间隔(比如INTERVAL '-08:00')。 在文本的情况下，可用的时区名字在Section 8.5.3有详细描述
Examples (assuming the local time zone isPST8PDT): 例子(假设本地时区是PST8PDT)：
SELECT TIMESTAMP '2001-02-16 20:38:40' AT TIME ZONE 'MST'; Result:2001-02-16 19:38:40-08 SELECT TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40-05' AT TIME ZONE 'MST'; Result:2001-02-16 18:38:40
第一个例子接受一个无时区的时间戳然后把它解释成 MST(UTC-7) 时间生成 UTC 时间戳，然后把这个时间转换为 PST(UTC-8) 显示。第二个例子接受一个 声明为 EST(UTC-5) 的时间戳，然后把它转换成 MST(UTC-7) 的当地时间。
timezone(zone，timestamp)
函数等效于 SQL 兼容的构造timestampAT TIME ZONEzone
9.9.4. 当前日期/时间
PostgreSQL提供许多返回当前日期和时间的函数。 这些符合 SQL 标准的函数全部都按照当前事务的开始时刻返回结果：
CURRENT_DATE CURRENT_TIME CURRENT_TIMESTAMP CURRENT_TIME(precision) CURRENT_TIMESTAMP(precision) LOCALTIME LOCALTIMESTAMP LOCALTIME(precision) LOCALTIMESTAMP(precision)
CURRENT_TIME和CURRENT_TIMESTAMP返回带有时区的值；
LOCALTIME和LOCALTIMESTAMP返回不带时区的值
CURRENT_TIME，
CURRENT_TIMESTAMP，
LOCALTIME和LOCALTIMESTAMP
可以有选择地给予一个精度参数，该精度导致结果的秒数域四舍五入到指定小数位。
如果没有精度参数，将给予所能得到的全部精度。
一些示例:
SELECT CURRENT_TIME; Result:14:39:53.662522-05 SELECT CURRENT_DATE; Result:2001-12-23 SELECT CURRENT_TIMESTAMP; Result:2001-12-23 14:39:53.662522-05 SELECT CURRENT_TIMESTAMP(2); Result:2001-12-23 14:39:53.66-05 SELECT LOCALTIMESTAMP; Result:2001-12-23 14:39:53.662522
因为这些函数全部都按照当前事务的开始时刻返回结果，所以它们的值在事务运行的整个期间内都不改变。 我们认为这是一个特性：目的是为了允许一个事务在"当前时间"上有连贯的概念， 这样在同一个事务里的多个修改可以保持同样的时间戳。
Note: 许多其它数据库系统更频繁地更新这些数值
PostgreSQL同样也提供了返回实时时间值的函数， 它们的返回值会在事务中随时间的前进而变化。 这些不附合 SQL 标准的函数列表如下:
transaction_timestamp() statement_timestamp() clock_timestamp() timeofday() now()
transaction_timestamp()等效于CURRENT_TIMESTAMP，不过其命名准确的表明了其
含义。statement_timestamp()返回当前事务开始时刻的时间戳(更准确的说是收到
客户端最后一条命令的时间)。statement_timestamp()和transaction_timestamp()
在一个事务的第一条命令里返回值相同，但是在随后的命令中却不一定相同。
clock_timestamp()返回实时时钟的当前时间戳，因此它的值甚至在同一条
SQL 命令中都会变化。timeofday()相当于clock_timestamp()，也返回实时
时钟的当前时间戳，由于历史原因， 它返回一个text字符串，而不是timestamp with time zone值。
now()是PostgreSQL的一个传统的等效于transaction_timestamp()。
所有日期/时间类型还接受特殊的文本值now，用于声明当前的日期和时间(重申：当前事务的开始时刻)。 因此，下面三个都返回相同的结果
SELECT CURRENT_TIMESTAMP; SELECT now(); SELECT TIMESTAMP 'now'; -- incorrect for use with DEFAULT
Tip: 在创建表的时候你不应该用第三种形式声明一个DEFAULT值。 系统将在分析这个常量的时候把now转换为一个timestamp， 因此这个缺省值就会变成创建表的时间！而前两种形式要到实际使用缺省值的时候才计算， 因为它们是函数调用。因此它们可以给出每次插入行的时刻。
9.9.5. 延时执行
下面的这个函数可以用于让服务器进程延时执行：
pg_sleep(seconds)
pg_sleep让当前的会话进程休眠seconds秒以后再执行。
seconds是一个double precision类型的值，所以可以指定带小数的秒数。
例如：
SELECT pg_sleep(1.5);
Note: 有效的休眠时间间隔精度是平台相关的，通常 0.01 秒是通用的。休眠的时间将至少等于指定的时间， 也有可能由于服务器荷载较重等原因而比指定的时间长。
| Warning |
请确保调用 |
Notes
| [1] | 60 ，如果闰秒由操作系统实现。 |