Verzeichnis suchen
前言 何为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
Figuren

9.23. 系统信息函数

Table 9-47显示了几个提取会话及系统信息的函数

另外在本节所列出的函数,有一些函数有关统计系统,也提供系统信息。参阅Section 27.2.2获取更多信息。

Table 9-47. 会话信息函数

名称 返回类型 描述
current_catalog name 当前数据库名(在SQL标准里叫"catalog"
current_database() name 当前数据库名
current_schema[()] name 当前模式名
current_schemas(boolean) name[] 搜索路径中的模式名字,包括可选的隐式模式
current_user name 当前执行环境下的用户名
current_query() text 执行当前的文本查询,由客户端提交(可能包含多于1句)
pg_backend_pid() int 连接到当前会话的服务器进程 ID
pg_listening_channels() setof text 正在侦听的当前会话的信道名称
inet_client_addr() inet 连接的远端地址
inet_client_port() int 连接的远端端口
inet_server_addr() inet 连接的本地地址
inet_server_port() int 连接的本地端口
pg_my_temp_schema() oid 会话的临时模式的OID ,不存在则为 0
pg_is_other_temp_schema(oid) boolean 是否为另一个会话的临时模式?
pg_postmaster_start_time() timestamp with time zone 服务器启动时间
pg_conf_load_time() timestamp with time zone 配置加载时间
session_user name 会话用户名
user name 等价于current_user
version() text PostgreSQL版本信息

Note: current_catalogcurrent_schemacurrent_usersession_useruserSQL有特殊的语法: 调用他们后面必须不加括号。 (在 PostgreSQL,current_schema括号是可选的,但是其它的不是。)

session_user通常是连接当前数据库的初始用户,不过超级用户可以 用 SET SESSION AUTHORIZATION 修改这个设置。current_user是用于权限 检查的用户标识。通常,它总是等于会话用户,但是可以通过SET ROLE改变它。 在函数执行的过程中随着属性SECURITY DEFINER的改变,其值也会改变。 用 Unix 术语来说,会话用户是"真实用户"real user"",而当前用户是"有效用户"effective user""。

current_schema返回在搜索路径前端的模式名字(如果搜索路径为空则返回 NULL)。 如果创建表或者其它命名对象时没有声明目标模式,那么它将是用于这些对象的模式。 current_schemas(boolean)返回一个搜索路径中所有模式名字的数组。布尔选项决定 像pg_catalog这样隐含包含的系统模式是否包含在返回的搜索路径中。

Note: 搜索路径可以通过运行时设置更改。命令是:

SET search_path TOschema[schema, ...]

pg_listening_channels返回当前会话正在监听的一组信道名称。见LISTEN获取更多信息。

inet_client_addr返回当前客户端的IP地址,而inet_client_port则 返回当前客户端的端口号。inet_server_addr返回服务器接收当前连接用的 IP 地址,而inet_server_port返回接收当前连接的端口号。 如果是通过 Unix-domain socket 连接的,那么所有这些函数都返回 NULL 。

pg_my_temp_schema返回当前会话的临时模式 OID ,如果不存在的话则 返回 0(因为没有创建任何临时表)。pg_is_other_temp_schema返回给定 的 OID 是否为其它会话的临时模式 OID , 这个函数是有实用价值的,比如,在显示一个目录的时候排除掉其它会话的临时表

pg_postmaster_start_time返回服务器启动时的timestamp with time zone

pg_conf_load_time返回最后载服务器配置文件的时间戳。 (如果当前会话时还活着,将是当前会话本身重新读取配置文件的时间,所以读取的时间会在不同的会话中稍微有所不同。 否则,它是postmaster进程重新读取配置文件的时间。)

version返回一个描述PostgreSQL服务器版本信息的字符串。

Table 9-48列出那些允许用户在程序里查询 对象访问权限的函数。参阅Section 5.6获取更多有关权限的信息

Table 9-48. 访问权限查询函数

名称 返回类型 描述
has_any_column_privilege(usertableprivilege) boolean 指定用户有没有访问表任何列的权限
has_any_column_privilege(tableprivilege) boolean 当前用户有没有访问表任何列的权限
has_column_privilege(usertablecolumnprivilege) boolean 指定用户有没有访问列的权限
has_column_privilege(tablecolumnprivilege) boolean 当前用户有没有访问列的权限
has_database_privilege(userdatabaseprivilege) boolean 指定用户是否有访问数据库的权限
has_database_privilege(databaseprivilege) boolean 当前用户是否有访问数据库的权限
has_foreign_data_wrapper_privilege(userfdwprivilege) boolean does user have privilege for foreign-data wrapper
has_foreign_data_wrapper_privilege(fdwprivilege) boolean does current user have privilege for foreign-data wrapper
has_function_privilege(userfunctionprivilege) boolean 指定用户是否有访问函数的权限
has_function_privilege(functionprivilege) boolean 当前用户是否有访问函数的权限
has_language_privilege(userlanguageprivilege) boolean 指定用户是否有访问语言的权限
has_language_privilege(languageprivilege) boolean 当前用户是否有访问语言的权限
has_schema_privilege(userschemaprivilege) boolean 指定用户是否有访问模式的权限
has_schema_privilege(schemaprivilege) boolean 当前用户是否有访问模式的权限
has_server_privilege(userserverprivilege) boolean 指定用户是否有访问外部服务的权限
has_server_privilege(serverprivilege) boolean 当前用户是否有访问外部服务的权限
has_sequence_privilege(usersequenceprivilege) boolean 指定用户是否有访问序列的权限
has_sequence_privilege(sequenceprivilege) boolean 当前用户是否有访问序列的权限
has_table_privilege(usertableprivilege) boolean 用户是否有访问表的权限
has_table_privilege(tableprivilege) boolean 当前用户是否有访问表的权限
has_tablespace_privilege(usertablespaceprivilege) boolean 指定用户是否有访问表空间的权限
has_tablespace_privilege(tablespaceprivilege) boolean 当前用户是否有访问该表空间的权限
pg_has_role(userroleprivilege) boolean 指定用户是否有该角色的权限
pg_has_role(roleprivilege) boolean 当前用户是否有该角色的权限

has_table_privilege检查用户是否可以用特定的方式访问表。 用户可以指定为名或OID(pg_authid.oid),或如果缺省该参数,则取current_user的值。 表可以指定为名或OID。(因此,has_table_privilege有六种变体,可以通过参数的个数和类型区分它们。) 当指定名时,如果有必要,名字可以用模式限定的。想要的访问权限,由文本字符串指定,其必须为SELECTINSERTUPDATEDELETETRUNCATEREFERENCESTRIGGER值之一。可选,可以添加WITH GRANT OPTION到权限类型, 以测试权限是否拥有授权选项。 也可以由','分隔 多个权限类型,如果拥有任何所列出的权限 ,则结果便为true。 (权限字符串不区分大小写,权限名之间允许有额外空白但不属于权限名的部分。) 一些例子:

SELECT has_table_privilege('myschema.mytable', 'select');
SELECT has_table_privilege('joe', 'mytable', 'INSERT, SELECT WITH GRANT OPTION');

has_sequence_privilege检查用户是否可以用特定的方式访问序列。参数可能与has_table_privilege类似。 想要的访问权限必须为USAGESELECT,或UPDATE

has_any_column_privilege检查用户是否可以用特定的方式访问表的任何列。 其参数可能与has_table_privilege类似,除了想要的权限类型必须是SELECTINSERTUPDATE, 或REFERENCES的一些值组合。 请注意,在表级别隐含任何这些特权授予它为每个表列,因此如果与has_table_privilege参数相同, has_any_column_privilege总是返回true。但是如果有至少一列的列级权限授予也成功。

has_column_privilege检查用户是否可以用特定的方式访问一列。 其可能的参数类似于has_table_privilege,带有额外的指定列,其要么为列名或列号。 想要的权限类型必须是SELECTINSERTUPDATE, 或REFERENCES的一些值组合。 请注意,在表级别隐含任何这些特权授予它为每个表列。

has_database_privilege检查一个用户是否能以特定方式访问一个数据库。 它可能的参数类似has_table_privilege。 权限类型必须是CREATECONNECTTEMPORARYTEMP(等价于TEMPORARY)之一。

has_function_privilege检查一个用户是否能以特定方式访问一个函数。 它可能的参数类似has_table_privilege。我们声明一个函数用的是文本字符 串而不是 OID ,允许的输入和regprocedure 数据类型一样(参阅Section 8.16)。权限类型必须是EXECUTE。 一个例子如下:

SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute');

has_language_privilege检查一个用户是否能以特定方式访问一个过程语言。 它可能的参数类似has_table_privilege。权限类型必须是USAGE

has_schema_privilege检查一个用户是否能以特定方式访问一个模式。 它可能的参数类似has_table_privilege。权限类型必须是CREATEUSAGE

has_tablespace_privilege检查一个用户是否能以特定方式访问一个表空间。 它可能的参数类似has_table_privilege。权限类型必须是CREATE

pg_has_role检查一个用户是否能以特定方式访问一个角色。 它可能的参数类似has_table_privilege。权限类型必须是MEMBERUSAGEMEMBER表示是角色中的直接或间接成员关系(也就是SET ROLE的权限), 而USAGE表示角色的权限是否无需SET ROLE即可立即生效。

Table 9-49显示了那些判断一个对象是否在当前模式搜索路径中可见的函数。 如果一个表所在的模式在搜索路径中,并且没有同名的表出现在搜索路径的 更靠前的地方,那么就说这个表是可见的。 它等效于表可以不带明确模式修饰进行引用。比如,要列出所有可见表的名字:

SELECT relname FROM pg_class WHERE pg_table_is_visible(oid);

Table 9-49. 模式可见性查询函数

名称 返回类型 描述
pg_conversion_is_visible(conversion_oid) boolean 该转换是否在搜索路径中可见
pg_function_is_visible(function_oid) boolean 该函数是否在搜索路径中可见
pg_operator_is_visible(operator_oid) boolean 该操作符是否在搜索路径中可见
pg_opclass_is_visible(opclass_oid) boolean 该操作符类是否在搜索路径中可见
pg_table_is_visible(table_oid) boolean 该表是否在搜索路径中可见
pg_ts_config_is_visible(config_oid) boolean 该文本检索配置是否在搜索路径中可见
pg_ts_dict_is_visible(dict_oid) boolean 该文本检索词典是否在搜索路径中可见
pg_ts_parser_is_visible(parser_oid) boolean 该文本解析是否在搜索路径中可见
pg_ts_template_is_visible(template_oid) boolean 该文本检索模板是否在搜索路径中可见
pg_type_is_visible(type_oid) boolean 该类型 (或 域) 是否在搜索路径中可见该类型(域)是否在搜索路径中可见

每个函数执行的一种类型的数据库对象的可见性检查。 pg_table_is_visible还可用于视图、索引、序列。pg_type_is_visible 还可用于域。对于函数和操作符,如果在搜索路径中没有名字相同并且参数的数 据类型也相同的对象出现在路径中更靠前的位置, 那么该对象就是可见的。对于操作符类,则要同时考虑名字和相关的索引访问方法。

所有这些函数都需要使用 OID 来标识要被检查的对象。 如果你想通过名字测试对象,那么使用 OID 别名 类型(regclassregtyperegprocedureregoperatorregconfig, orregdictionary)将会很方便。例如:

SELECT pg_type_is_visible('myschema.widget'::regtype);

请注意用这种方法测试一个未经修饰的名字没什么意义, 因为如果一个名字可以被识别,那它首先必须是可见的。

Table 9-50列出了从系统表中提取信息的函数

Table 9-50. 系统表信息函数

名称 返回类型 描述
format_type(type_oidtypemod) text 获取一个数据类型的 SQL 名称
pg_get_keywords() setof record 获取SQL关键字和类别列表
pg_get_constraintdef(constraint_oid) text 获取一个约束的定义
pg_get_constraintdef(constraint_oidpretty_bool) text 获取一个约束的定义
pg_get_expr(expr_textrelation_oid) text 反编译一个表达式的内部形式,假设其中的任何 Var 都引用第二个参数指出的关系
pg_get_expr(expr_textrelation_oidpretty_bool) text 反编译一个表达式的内部形式,假设其中的任何 Var 都引用第二个参数指出的关系
pg_get_functiondef(func_oid) text 获取一个函数的定义
pg_get_function_arguments(func_oid) text 获取参数列表的函数定义 (带默认值)
pg_get_function_identity_arguments(func_oid) text 获取参数列表的函数定义 (不带默认值)
pg_get_function_result(func_oid) text 获取函数的RETURNS子句
pg_get_indexdef(index_oid) text 获取索引的CREATE INDEX命令
pg_get_indexdef(index_oidcolumn_nopretty_bool) text 获取索引的CREATE INDEX命令,如果column_no不为零,则只获取一个索引字段的定义。
pg_get_ruledef(rule_oid) text 为规则获取CREATE RULE命令
pg_get_ruledef(rule_oidpretty_bool) text 为规则获取CREATE RULE命令
pg_get_serial_sequence(table_namecolumn_name) text 获取一个serialbigserial字段使用的序列名
pg_get_triggerdef(trigger_oid) text 为触发器获取CREATE [ CONSTRAINT ] TRIGGER命令
pg_get_triggerdef(trigger_oidpretty_bool) text getCREATE [ CONSTRAINT ] TRIGGERcommand for trigger
pg_get_userbyid(role_oid) name 获取给定 OID 的角色名
pg_get_viewdef(view_name) text 为视图获取底层的SELECT命令(已废弃)
pg_get_viewdef(view_namepretty_bool) text 为视图获取底层的SELECT命令(已废弃)
pg_get_viewdef(view_oid) text 为视图获取底层的SELECT命令
pg_get_viewdef(view_oidpretty_bool) text 为视图获取底层的SELECT命令
pg_tablespace_databases(tablespace_oid) setof oid 获取在指定的表空间有对象的数据库 OID 集合
pg_typeof(any) regtype 获取任何值的数据类型

format_type通过某个数据类型的类型 OID 以及可能的类型修饰词返回其 SQL 名称。 如果不知道具体的修饰词,那么在类型修饰词的位置传入 NULL。

pg_get_keywords返回一组记录描述服务器识别的 SQL 关键字。 word列包含关键字。catcode列 包含一个分类代码: U通用的,C列名,T类型或函数名,或R保留。 catdesc列包含了一个可能本地化描述分类的字符串。

pg_get_constraintdefpg_get_indexdefpg_get_ruledef, 和pg_get_triggerdef 分别从一个视图、规则、索引、触发器、约束上重新构造创建它们的命令(反编译的 重新构造,而不是该命令的原文)。pg_get_expr反编译一个独立表达式的内部形式, 比如一个字段的缺省值。在检查系统表的内容的时候很有用。pg_get_viewdef重新构 造出定义视图的SELECT查询。这些函数大多数都有两个变种,其中一个是"适合打印" 的结果。这种格式更容易读,但是缺省的格式更有可能被将来的PostgreSQL版本用 同样的方法解释;如果是用于转储,那么尽可能避免使用"适合打印"的格式。 给 pretty-print参数传递false生成的结果和那个没有这个参数的变种生成的结果是完全一样。

pg_get_functiondefreturns a complete CREATE OR REPLACE FUNCTIONstatement for a function. pg_get_function_argumentsreturns the argument list of a function, in the form it would need to appear in within CREATE FUNCTION. pg_get_function_resultsimilarly returns the appropriateRETURNSclause for the function. pg_get_function_identity_argumentsreturns the argument list necessary to identify a function, in the form it would need to appear in withinALTER FUNCTION, for instance. This form omits default values.

pg_get_serial_sequence返回与一个字段相关的序列名;如果没有 任何序列与给定的字段相关则返回 NULL 。第一个输入参数是可选模式的表名,第二个参数是列名。 因为第一个参数可能是一个模式和表,它不是视为一个双引号的标识符,意味着默认情况下小写, 而第二个参数只是列名称,被视为为双引号,并保留其大小写。 该函数返回适当格式化的值传递给序列函数(参阅Section 9.15)。 这种相关性可以通过ALTER SEQUENCE OWNED BY修改或删除。 (其实调用这个函数pg_get_owned_sequence或许更为妥当, 因为它的当前名字反映了通常用serialbigserial的列。)

pg_get_userbyidextracts a role's name given its OID. pg_get_userbyid通过角色OID获取对应的角色名。

pg_tablespace_databases允许检查一个表空间的状况,它返回在该表空间中保存了对象的数据库 OID 集合。 如果这个函数返回数据行,那么该表空间就是非空的,因此不能删除。要显示该表空间中的特定对象,你需要把pg_tablespace_databases返回的数据库标识 与pg_class表连接进行查询。

pg_typeofreturns the OID of the data type of the value that is passed to it. This can be helpful for troubleshooting or dynamically constructing SQL queries. The function is declared as returningregtype, which is an OID alias type (see Section 8.16); this means that it is the same as an OID for comparison purposes but displays as a type name. For example:

SELECT pg_typeof(33);

 pg_typeof 
-----------
 integer
(1 row)

SELECT typlen FROM pg_type WHERE oid = pg_typeof(33);
 typlen 
--------
      4
(1 row)

Table 9-51显示的函数将原来用 COMMENT命令存储的注释抽取出来。如果没有找到,则返回 NULL

Table 9-51. 注释信息函数

名称 返回类型 描述
col_description(table_oidcolumn_number) text 获取一个表字段注释
obj_description(object_oidcatalog_name) text 获取一个数据库对象的注释
obj_description(object_oid) text 获取一个数据库对象的注释(deprecated
shobj_description(object_oidcatalog_name) text 获取一个共享数据库对象的注释

col_description返回一个表中字段的注释,它是通过表 OID 和字段号来声明的。 obj_description不能用于表字段,因为字段没有自己的 OID 。

带有两个参数的obj_description返回一个数据库对象的注释,该对象是通过其 OID 和其所属的系统表名字声明的。比如,obj_description(123456,'pg_class') 将返回 OID 为 12345 的表的注释。只带一个参数的obj_description只要求对象 OID ,现在已经废弃了, 因为我们不再保证 OID 在不同的系统表之间是唯一的,因此可能会返回错误的注释

shobj_descriptionobj_description差不多,不同之处仅在于前者用于共享对象。 一些系统表是通用于集群中所有数据库的全局表,因此这些表的描述也是全局存储的

The functions shown inTable 9-52 provide server transaction information in an exportable form. The main use of these functions is to determine which transactions were committed between two snapshots.

Table 9-52. 事务ID和快照

名称 返回类型 描述
txid_current() bigint 获取当前事务 ID
txid_current_snapshot() txid_snapshot 获取当前快照
txid_snapshot_xmin(txid_snapshot) bigint 获取快照的xmin
txid_snapshot_xmax(txid_snapshot) bigint 获取快照的xmax
txid_snapshot_xip(txid_snapshot) setof bigint 获取在快照的进行中的事务IDs
txid_visible_in_snapshot(biginttxid_snapshot) boolean 在快照事务ID是否可见?(不使用子事务ID)

内部事务 ID 类型(xid)是32位,每40亿事务循环。 尽管这些函数导出一个64位格式,一个"epoch"计数器扩展,所以在安装过程中不会循环。 这些函数使用的数据类型txid_snapshot,存储在某时刻可见的关于事物ID的信息。其组件描述在Table 9-53。

Table 9-53. 快照构成

名称 描述
xmin 最早的事务ID(txid)仍然活动。所有较早事务将是可见提交了,或者要么死掉回滚了。
xmax 首先作为尚未分配的txid。所有大于或等于此的txids作为这时的快照都是尚未开始的,因此不可见。
xip_list 在快照的时间的活动txids。这个列表只包含在xminxmax之间的活动txids;有可能活动的txids高于xmax。 一个xmin <= txid <xmax的txid,不在这个列表中,在快照的这个时间已经是完成的, 因此要么可见或死掉对应它的提交状态。这个列表不包含子事务的txids。

txid_snapshot的文本表示为:xmin:xmax:xip_list。 例如10:20:10,14,15意思为:xmin=10, xmax=20, xip_list=10, 14, 15

Vorheriger Artikel: Nächster Artikel: