directory search
前言 何为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
characters

4.1. 词法结构

SQL输入由一系列命令commands组成。一条命令 由一系列tokens构成,用一个分号 (";")结尾。输入流的终止也结束一条命令。哪些记号是合法 的取决于特定命令的语法。

记号可以是一个key word, 一个 identifier, quoted identifier, literal(或常量), 或特殊的字符符号。 记号通常由空白分隔(空格/tab/换行符),但如果不存在混淆的时候也 可以不用(通常只是一个特殊字符与一些其它记号类型相连的时候)。

比如,下列命令是(语法上)合法的SQL输入:

SELECT * FROM MY_TABLE;
UPDATE MY_TABLE SET A = 5;
INSERT INTO MY_TABLE VALUES (3, 'hi there');

这里是三条命令的序列,每条一行(尽管并不要求这么做;多条命令可以在 一行里,单条命令也可以合理地分裂成多行)。

另外,comments可以出现在SQL输入中,它们不是标记,但实际上它们等效于空白。

如果从哪些记号标识命令、哪些是操作数或参数的角度考虑,SQL 语法并 不是非常一致。通常头几个记号是命令名子,因此上面的例子我们通常可以 说是一个"SELECT",一个"UPDATE",和一个"INSERT"命令。不过,UPDATE命令总是 要求一个SET在某个位置出现,并且这个特定的INSERT还要求有一个VALUES才完整。 每条命令的准确语法规则都在Part VI里描述。

4.1.1. 标识符和关键子

像上面例子里的SELECT,UPDATEVALUES这样的记号都是关键子的例子,也就是那些 在SQL语言里有固定含义的单词。记号MY_TABLEA是标识符的例子。根据使用它们的命令的不同, 它们标识表、子段、或者其它数据库对象的名子。因此,有时候只是 简单地叫它们"names"。关键子和标识符有着同样的 词法结构,意思是我们在没有认识这种语言之前是无法区分一个 记号是标识符还是名子。你可以在Appendix C里找到一个关键子的完整列表。

SQL标识符和关键子必须以一个字母(a-z以及带变音符的字母和非拉丁字母)或下划线(_)开头, 随后的字符可以是字母、下划线、数字(0-9) 、美元符号($)。需要注意的是,根据SQL标准,美元符号 不允许出现在标识符中,因此使用美元符号将不易移植。SQL 标准不会定义 包含数字或者以下划线开头或结尾的关键子,因此按照这里的格式定义的 标识符是安全的,不会和将来标准的扩展特性冲突。

系统使用不超过NAMEDATALEN-1个字符作为标识符; 你可以在命令中写更长的名子,但它们会被截断。 NAMEDATALEN的缺省值是64,因此标识符最大长度是63。 如果觉得这个限制有问题,那么你可以在 src/include/pg_config_manual.h里修改NAMEDATALEN来改变它。

标识符和关键子名子都是大小写无关的。因此

UPDATE MY_TABLE SET A = 5;

也可以等效地写成

uPDaTE my_TabLE SeT a = 5;

一种好习惯是把关键子写成大写,而名子等用小写:

UPDATE my_table SET a = 5;

还有第二种标识符:delimited identifierquoted identifier。它是通过在"中包围 任意字符序列形成的。分隔标识符总是一个标识符,而不是关键子。因此, 你可以用"select"表示一个子段或者表的名子,而 一个没有引号的"select"将被当做一条命令的一部分, 因此如果把它当做一个表名或者子段名使用的话就会产生一个分析错误。 上面的例子可以用引号包围的标识符这么写:

UPDATE "my_table" SET "a" = 5;

引号包围的标识符可以包含编码不等于零的任意字符(要包含一个双引号, 可以写两个相连的双引号)。这样我们就可以构造那些原本是不允许的 表名或者子段名,比如那些包含空白或&符号的名子,但长度限制依旧。

一个带引号的标示符的变形允许带有代码点标记的逃逸Unicode字符。 该变形以U&开始(大/小写U后给有符号)紧跟着打开的双引号, 之间没有空格,例如 U&"foo"。 (需要注意的是,与&比较,这样做会产生歧义。在操作符周围加上空格来避免该问题) 在引号中,通过写一个后面跟有四位十六进制代码点或跟有六位十六进制代码点加号的反斜杠,Unicode字符可以写成逃逸格式。 例如,"data"可以写成:

U&"d\0061t\+000061"

下例以西里尔字母写俄文"slon"(象)。

U&"\0441\043B\043E\043D"

如果需要一个非反斜杠的不同的逃逸,可以通过在字符串之后使用UESCAPE语句来进行声明,如:

U&"d!0061t!+000061" UESCAPE '!'

逃逸字符可以是一个十六进制数字以外的任何单个字符,加号,一个单引号,双引号,或一个空白字符。 需要注意的是,逃逸字符是写在单引号中,而不是双引号中。

字面上,为了将逃逸字符写到标示符中,可以将它写两次。

只有服务器字符集是UTF8时,才会完全使用Unicode逃逸语法。 当使用其他服务器字符集时,只有在ASCII内的(最多\u007F)代码点可以被声明。 4位和8位的数字形式可以被用来将UTF-16代理对声明为大于U+FFFF的带有代码点的字符, 尽管这样做是不必的(通过可用8位数字形式技术)。 (当服务器字符集是UTF8时使用代理对,首先,它们结合成一个单一的代码点,然后再UTF-8编码)

把一个标识符用引号包围起来同时也令它大小写相关,而没有引号包围起来的 名子总是转成小写。 比如,PostgreSQL认为标识符FOO,foo"foo"是等价的, 但"Foo"但是"Foo""FOO"与上面三个以及彼此之间都是不同的。 PostgreSQL里对未加引号的名子总是转换成小写, 这和SQL标准是不兼容的,SQL标准要求未用引号包围起来的名子总是 转成大写。因此根据标准,foo等于 "FOO"但不等于"foo"。 如果你想编写可移植的程序,那么我们建议你要么就总是用引号 包围某个名子,要么就从来不引。

4.1.2. 常量

PostgreSQL里有三种implicitly-typed constants:字符串、位串、数值。常量也可以声明为明确的类型, 这样就可以使用更准确的表现形式以及可以通过系统更有效地处理。 这些将在后面的小节描述。

4.1.2.1. 字符串常量

SQL里的一个字符串文本是用单引号(')包围的任意字符序列, 比如'This is a string'。这种声明字符串常量的 方法是SQL标准定义的。在这种类型的字符串常量里嵌入单引号的标准兼容的 做法是敲入两个连续的单引号,比如'Dianne''s horse'。 注意:两个连续的单引号not是双引号 (")

两个只是通过with at least one newline的空白分隔 的字符串常量会被连接在一起,并当做它们是写成一个常量处理。比如:

SELECT 'foo'
'bar';

等效于

SELECT 'foobar';

但是

SELECT 'foo'      'bar';

是非法的语法。这个怪异的行为是SQL声明的, PostgreSQL遵循标准。

4.1.2.2. C结构的逃逸字符串常量

PostgreSQL还允许"escape"字符串中 的内容,这是一个PostgreSQL对SQL标准的扩展。逃逸字符串语法是通过 在字符串前写字母E(大写或者小写)的方法声明的。 比如 E'foo'。当需要续行包含逃逸字符的字符串时,仅需要在第一行的 开始引号前写上E就可以了。 在逃逸字符串中,通过一个\开始C-结构的反斜杠逃逸序列, 在该逃逸中,反斜杠与其之后字符的组合代表一个特殊的子节值,可参阅Table 4-1。

Table 4-1. 反斜杠逃逸序列

反斜杠逃逸序列 解释
\b 退格
\f 进纸
\n 换行
\r 回车
\t 水平制表符
\o, \oo, \ooo (o = 0 - 7) 八进制子节值
\xh, \xhh (h = 0 - 9, A - F) 十六进制值
\uxxxx, \Uxxxxxxxx (x = 0 - 9, A - F) 16或32位十六进制Unicode字符值

任何其它跟在反斜杠后面的字符都当做文本看待。因此,要在字符串常量 里包含反斜杠,则写两个反斜杠(\\)。另外,PostgreSQL 允许用一个反斜杠来逃逸单引号(\'),不过,将来版本 的 PostgreSQL 将不允许这么用。所以最好坚持使用符合标准的 ''.。

你有必要为你所创建的子节序列(特别是在使用八进制或十六进制逃逸时)编写有效的服务器字符集编码字符。 当服务器编码是UTF-8时,应该使用Unicode逃逸或另一种Unicode逃逸语法(参阅Section 4.1.2.3)。 (后者通过写出子节来处理UTF-8字符集,这样做是很繁琐的)。

只有服务器字符集是UTF8时,才会完全使用Unicode逃逸语法。 当使用其他服务器字符集时,只有在ASCII内的(最多\u007F)代码点可以被声明。 4位和8位的数字形式可以被用来将UTF-16代理对声明为大于U+FFFF的带有代码点的字符, 尽管这样做是不必的(通过可用8位数字形式技术)。 (当服务器字符集是UTF8时使用代理对,首先,它们结合成一个单一的代码点,然后再UTF-8编码)

Caution

如果配置参数 standard_conforming_strings 的值是 off,那么PostgreSQL 将能够识别所有(无论有无前导 E)字符串常量中的反斜杠逃逸,这是为了 与过去的历史行为兼容。虽然standard_conforming_strings 目前的默认值是off,但是在不久的将来会变成on 以与标准兼容。我们鼓励在应用中不使用反斜杠逃逸。如果你确实需要使用 反斜杠逃逸来表示特殊字符,那么请在字符串常量前加上E 以确保能够被正确的处理。

standard_conforming_strings之外, escape_string_warning和backslash_quote 置参数也影响字符串常量中反斜杠的处理。

编码为零的字符不允许出现在字符串常量中。

4.1.2.3. Unicode逃逸字符串常量

一个带引号的标示符的变形允许带有代码点标记的逃逸Unicode字符。 该变形以U&开始(大/小写U后给有符号)紧跟着打开的双引号, 之间没有空格,例如 U&"foo"。 (需要注意的是,与&比较,这样做会产生歧义。在操作符周围加上空格来避免该问题) 在引号中,通过写一个后面跟有四位十六进制代码点或跟有六位十六进制代码点加号的反斜杠,Unicode字符可以写成逃逸格式。 例如,"data"可以写成:

U&'d\0061t\+000061'

下例以西里尔字母写俄文"slon"(象)。

U&'\0441\043B\043E\043D'

如果需要一个非反斜杠的不同的逃逸,可以通过在字符串之后使用UESCAPE语句来进行声明,如:

U&"d!0061t!+000061" UESCAPE '!'

逃逸字符可以是一个十六进制数字以外的任何单个字符,加号,一个单引号,双引号,或一个空白字符。 需要注意的是,逃逸字符是写在单引号中,而不是双引号中。

只有服务器字符集是UTF8时,才会完全使用Unicode逃逸语法。 当使用其他服务器字符集时,只有在ASCII内的(最多\u007F)代码点可以被声明。 4位和8位的数字形式可以被用来将UTF-16代理对声明为大于U+FFFF的带有代码点的字符, 尽管这样做是不必的(通过可用8位数字形式技术)。 (当服务器字符集是UTF8时使用代理对,首先,它们结合成一个单一的代码点,然后再UTF-8编码)

同样,字符串常量的Unicode逃逸语法只有当配置参数standard_conforming_strings启用时才能生效。 否则,该语法在解析SQL语法时给客户端造成混淆,导致SQL注入或其他安全问题。 如果该参数设为OFF,该语法会带着一条错误信息一起呗注入。

字面上,为了将逃逸字符写到标示符中,可以将它写两次。

4.1.2.4. 美元符界定字符串常量

尽管声明字符串常量的标准方法通常都很方便,但是如果字符串中包含 很多单引号或者反斜杠,那么理解字符串的内容可能就会变得很苦涩, 因为每个单引号都要加倍。为了让这种场合下的查询更具可读性, PostgreSQL允许另外一种称作"美元符界定"的 字符串常量书写办法。一个通过美元符界定声明的字符串常量由一个美元 符号($)、零个或多个字符组成的"tag"、 另一个美元符号、组成字符串常量的任意字符序列、一个美元符号、 与前面相同的记号、一个美元符号组成的。比如,下面是两个不同的用美元 符界定的方法声明"Dianne's horse"的例子:

$$Dianne's horse$$
$SomeTag$Dianne's horse$SomeTag$

请注意,在美元符界定的字符串里,单引号不允许逃逸。实际上, 在一个美元符界定的字符串里, 不允许逃逸任何字符:字符串内容总是按照子面内容书写。反斜杠不是特殊的、 美元符自己也不是特殊的(除非它们和开标签的一部分匹配)。

我们可以通过在不同嵌套级别使用不同的"标记"来实现嵌套。 最常见的是写函数定义的时候。比如:

$function$
BEGIN
    RETURN ($1 ~ $q$[\t\r\n\v\\]$q$);
END;
$function$

这里,序列$q$[\t\r\n\v\\]$q$表示一个美元符界定的字符串 文本 [\t\r\n\v\\] ,在函数体被 PostgreSQL 执行的时候,它将被识别出来。但是因为这个序列不匹配外层的界定符 $function$,所以只要考虑了外层字符串,它就只是常量 里面的普通字符而已。

如果有标签的话,一个美元符界定的字符串遵循和无引号包围的标识符相同 的规则,只是它不能包含美元符。标签是大小写相关的,因此 $tag$String content$tag$是正确的,而 $TAG$String content$tag$则是错误的。

一个后面紧跟着关键子或者标识符的美元符界定字符串必须用空白与其后 的关键子或者标识符隔开;否则美元符界定符将会被当作标识符的开 头部分(否则,美元界定符会被看成其前面的标识符)。

美元符界定不是SQL标准,但是在写复杂的字符串文本的时候,它通常 比标准的单引号语法更方便。尤其是在其它常量里表现字符串常量的时候 更有用。比如在过程函数定义里,如果用单引号语法,每个上面例子里的 每个反斜杠都必须写四个,它们在作为字符串文本分析的时候会减少为两个, 然后在函数执行的时候在内层字符串常量里会再次被解析为一个。

4.1.2.5. 位串常量

位串常量看起来很像在开引号前面有一个B(大写或小写) 的普通字符串(它们之间没有空白),比如B'1001'。 位串常量里可以用的字符只有01

另外,位串常量可以用十六进制表示法声明,方法是使用前缀X(大写或者小写), 比如X'1FF', 其中的每个十六进制位等效于四个二进制位。

两种形式的位串常量都可以像普通字符串常量那样跨行连续。位串常量 不能用美元符界定。

4.1.2.6. 数值常量

数值常量接受下列通用的形式:

digits
digits.[digits][e[+-]digits]
[digits].digits[e[+-]digits]
digitse[+-]digits

这里的digits是一个或多个十进制数字(0-9)。 如果有小数点,那么至少有一位在小数点前面或后面。如果出现了指数 分隔符(e)那么至少有一个数字跟在它后面。 在常量里不能有空格或者其它字符。请注意任何前导正号或负号实际上 都不认为是常量的一部分;它是施加于常量的一个操作符。

这里是一些合法的数值常量的例子:

42
3.5
4.
.001
5e2
1.925e-3

如果一个数值常量既不包含小数点,也不包含指数操作符,那么如果它 的数值可以放在integer类型中(32位),则认为它是integer类型; 如果它的数值可以放在bigint中(64位),则认为它是bigint, 否则认为它是numeric类型。包含小数点和/或指数操作符的常量总是 被认为是numeric类型。

给一个数值常量赋予初始数据类型只是类型解析算法的开端。 在大多数情况下该常量会根据环境被自动强制转换成最合适的类型。 必要时,你可以通过强制类型转换把一个数值解析成特定的数据类型。 比如,你可以强制要求把一个数值当作real(float4)类型来看,方法是这么写:

REAL '1.23'  -- 字符串风格
1.23::REAL   -- PostgreSQL(历史的)风格

这些实际上只是下面讨论的通用转换的特例。

4.1.2.7. 其它类型的常量

arbitrary类型的常量都可以用下列表示法中的 任何一种来输入:

type 'string'
'string'::type
CAST ( 'string' AS type )

其中的'string'将会被转换为type类型的常量。 如果不存在该常量所属类型的歧义,那么可以省略明确的 类型转换(比如,当你把它直接赋予一个表子段的时候),这种情况下它 会自动转换。

其中的'string'可以用普通SQL表示法或者美元符界定来书写。

我们还可以用函数风格的语法来声明类型转换:

typename ( 'string' )

不过并非所有类型名都可以这样使用;参阅Section 4.2.9获取细节。

::, CAST()和函数调用语法 也可以用于声明任意表达式的运行时类型转换(如节Section 4.2.9中讨论的那样)。但是为了避免语句歧义, type 'string'的形式 只能用于声明一个子面常量的类型。type 'string'的另外一个限制是它不能用于 数组类型(要用::CAST()声明一个数组常量的类型)。

CAST()语法遵循SQL标准。type'string'语法是标准的一个推广: SQL只是给少数几种数据类型声明了这个语法,但PostgreSQL允许将其用于所有类型。 ::和函数调用的语法 是PostgreSQL的历史用法。

4.1.3. 操作符

一个操作符是最多NAMEDATALEN-1(缺省63个)个下列 字符的序列:

+ - * / < > = ~ ! @ # % ^ & | ` ?

不过,有几个限制:

  • --/*不能出现在操作符 中的任何地方,因为它们会被当做注释开始对待。

  • 多字符操作符不能以+-, 结束, 除非其中至少还包含下列操作符之一:

    ~ ! @ # % ^ & | ` ?

    比如,@-是允许的操作符,但*-不是。这个限制允许 PostgreSQL在不要求记号之间有空白的情况下分析 SQL 兼容的查询。

当你使用非SQL标准的操作符的时候,你通常需要用空白分隔相邻的 操作符以避免歧义。比如,如果你定义了一个叫@的左单目操作符, 那么你就不能写成X*@Y; 而是要写成X* @Y以确保PostgreSQL把它读成两个操作符, 而不是一个。

4.1.4. 特殊字符

有些非字母数字字符有一些特殊含义,因此不能用做操作符。它们的用法细节可 以在相应的描述语法元素的地方找到。本节只是描述它们的存在和概括一下 这些字符的目的。

  • 美元符号($)后面跟着数字用于在一个函数体定义或者 预备语句中表示参数的位置。在其它环境里美元符号可能是一个标识符名子 或者是一个美元符界定的字符串常量的一部分。

  • 圆括弧(())用于分组和强制优先级的时候含义与 平常一样。有些场合里圆括弧是作为一个特定SQL命令的固定语法的 一部分要求的。

  • 方括弧([])用于选取数组元素。参阅节 Section 8.14 获取更多信息。

  • Commas (,) are used in some syntactical constructs to separate the elements of a list. 逗号(,)在一些语法构造里用于分隔一个列表的元素。

  • 分号(;)结束一条SQL命令。它不能出现在 一条命令里的任何地方,除了在引号包围的字符串常量或者标识符中。

  • 冒号(:)用于从数组中选取"slices" (参阅节Section 8.14)。在一些SQL语言里(比如嵌入SQL),冒号用于前缀变量名。

  • 星号(*)在某些环境里表示一个表的全部子段或者 一个复合类型的值。在用作聚集函数的参数时还表示该聚集并不需要明确的参数。

  • 句点(.)用在数字常量里,并用于分隔模式、表、子段名。

4.1.5. 注释

注释是任意以双划线开头并延伸到行尾的任意字符序列,比如:

-- This is a standard SQL comment

另外,还可以使用C-结构的块注释:

/* multiline comment
 * with nesting: /* nested block comment */
 */

这里注释以/*开头并扩展到对应的*/。 这些块注释可以嵌套,就像SQL标准里说的那样(但和C不一样), 因此我们可以注释掉一大块已经包含块注释的代码。

注释在进一步的语法分析之前被从输入中流删除并用空白代替。

4.1.6. 词法优先级

Table 4-2显示了PostgreSQL里面的操作符的优先级和关联性。 大多数操作符都有相同的优先级并且都是左关联的。 这种情况可能会有不那么直观的行为; 比如,布尔操作符<>与 布尔操作符<=>=之间有 着不同的优先级。同样,当你把双目和单目操作符组合使用的时候,有时候也需要 加圆括弧。比如

SELECT 5 ! - 6;

会被分析成

SELECT 5 ! (- 6);

因为分析器不知道!被定义成了后缀操作符,而不是中缀操作符 (知道的时候只能是太晚了)。要在本例中获得你需要的特性,你要写成 SELECT (5 !) - 6; 这是我们为扩展性付出的代价。

Table 4-2. 操作符优先级(递减)

操作符/元素 关联性 描述
. 表/子段名分隔符
:: PostgreSQL特有的类型转换操作符
[ ] 数组元素选择
- 单目负号
^
*/% 乘,除,模
+ - 加,减
IS   IS TRUE,IS FALSE,IS UNKNOWN,IS NULL
ISNULL   测试是否为 NULL
NOTNULL   测试是否不为 NULL
(其他) 所有其它的本地和用户定义操作符
IN   集合成员
BETWEEN   范围包含
OVERLAPS   时间间隔重叠
LIKEILIKESIMILAR   字符串模式匹配
<>   小于,大于
= 等于,赋值
NOT 逻辑非
AND 逻辑与
OR 逻辑或

请注意操作符优先级也适用于和上面提到的同名的内置操作符和用户定义操作符。 比如,如果你为一些客户数据类型定义一个"+"操作符,那么 它和内置的"+"操作符有同样的优先级,不管用它来干什么。

如果在OPERATOR语法里使用了模式修饰的操作符名,比如

SELECT 3 OPERATOR(pg_catalog.+) 4;

那么OPERATOR构造就会有表Table 4-2 里面为"any other"操作符显示的缺省优先级。不管什么特定的操作符 出现在OPERATOR()里都是这样。

Previous article: Next article: