目录搜索
前言何为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和OFFSET7.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 BY11.5. 组合多个索引11.6. 唯一索引11.7. 表达式上的索引11.8. 部分索引11.9. 操作类和操作簇11.10. 检查索引的使用章12. Full Text Search12.1. Introduction12.2. Tables and Indexes12.3. Controlling Text Search12.4. Additional Features12.5. Parsers12.6. Dictionaries12.7. Configuration Example12.8. Testing and Debugging Text Search12.9. GiST and GIN Index Types12.10. psql Support12.11. Limitations12.12. Migration from Pre-8.3 Text Search章13. 并发控制13.1. 介绍13.2. 事务隔离13.3. 明确锁定13.4. 应用层数据完整性检查13.5. 锁和索引章14. 性能提升技巧14.1. 使用EXPLAIN14.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 Windows16.1. Building with Visual C++ or the Platform SDK16.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 Tests30.1. Running the Tests30.2. Test Evaluation30.3. Variant Comparison Files30.4. Test Coverage ExaminationIV. 客户端接口章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 C33.1. The Concept33.2. Connecting to the Database Server33.3. Closing a Connection33.4. Running SQL Commands33.5. Choosing a Connection33.6. Using Host Variables33.7. Dynamic SQL33.8. pgtypes library33.9. Using Descriptor Areas33.10. Informix compatibility mode33.11. Error Handling33.12. Preprocessor directives33.13. Processing Embedded SQL Programs33.14. Library Functions33.15. Internals章34. 信息模式34.1. 关于这个模式34.2. 数据类型34.3. information_schema_catalog_name34.4. administrable_role_authorizations34.5. applicable_roles34.6. attributes34.7. check_constraint_routine_usage34.8. check_constraints34.9. column_domain_usage34.10. column_privileges34.11. column_udt_usage34.12. 字段34.13. constraint_column_usage34.14. constraint_table_usage34.15. data_type_privileges34.16. domain_constraints34.18. domains34.17. domain_udt_usage34.19. element_types34.20. enabled_roles34.21. foreign_data_wrapper_options34.22. foreign_data_wrappers34.23. foreign_server_options34.24. foreign_servers34.25. key_column_usage34.26. parameters34.27. referential_constraints34.28. role_column_grants34.29. role_routine_grants34.30. role_table_grants34.31. role_usage_grants34.32. routine_privileges34.33. routines34.34. schemata34.35. sequences34.36. sql_features34.37. sql_implementation_info34.38. sql_languages34.39. sql_packages34.40. sql_parts34.41. sql_sizing34.42. sql_sizing_profiles34.43. table_constraints34.44. table_privileges34.45. tables34.46. triggered_update_columns34.47. 触发器34.48. usage_privileges34.49. user_mapping_options34.50. user_mappings34.51. view_column_usage34.52. view_routine_usage34.53. view_table_usage34.54. 视图V. 服务器端编程章35. 扩展SQL35.1. 扩展性是如何实现的35.2. PostgreSQL类型系统35.3. User-Defined Functions35.4. Query Language (SQL) Functions35.5. Function Overloading35.6. Function Volatility Categories35.7. Procedural Language Functions35.8. Internal Functions35.9. C-Language Functions35.10. User-Defined Aggregates35.11. User-Defined Types35.12. User-Defined Operators35.13. Operator Optimization Information35.14. Interfacing Extensions To Indexes35.15. 用C++扩展章36. 触发器36.1. 触发器行为概述36.3. 用 C 写触发器36.2. 数据改变的可视性36.4. 一个完整的例子章37. 规则系统37.1. The Query Tree37.2. 视图和规则系统37.3. 在INSERT,UPDATE和DELETE上的规则37.4. 规则和权限37.5. 规则和命令状态37.6. 规则与触发器得比较章38. Procedural Languages38.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 Hood39.11. 开发PL/pgSQL的一些提示39.12. 从OraclePL/SQL 进行移植章40. PL/Tcl - Tcl Procedural Language40.1. Overview40.2. PL/Tcl Functions and Arguments40.3. Data Values in PL/Tcl40.4. Global Data in PL/Tcl40.5. Database Access from PL/Tcl40.6. Trigger Procedures in PL/Tcl40.7. Modules and the unknown command40.8. Tcl Procedure Names章41. PL/Perl - Perl Procedural Language41.1. PL/Perl Functions and Arguments41.2. Data Values in PL/Perl41.3. Built-in Functions41.4. Global Values in PL/Perl41.6. PL/Perl Triggers41.5. Trusted and Untrusted PL/Perl41.7. PL/Perl Under the Hood章42. PL/Python - Python Procedural Language42.1. Python 2 vs. Python 342.2. PL/Python Functions42.3. Data Values42.4. Sharing Data42.5. Anonymous Code Blocks42.6. Trigger Functions42.7. Database Access42.8. Utility Functions42.9. Environment Variables章43. Server Programming Interface43.1. Interface FunctionsSpi-spi-connectSpi-spi-finishSpi-spi-pushSpi-spi-popSpi-spi-executeSpi-spi-execSpi-spi-execute-with-argsSpi-spi-prepareSpi-spi-prepare-cursorSpi-spi-prepare-paramsSpi-spi-getargcountSpi-spi-getargtypeidSpi-spi-is-cursor-planSpi-spi-execute-planSpi-spi-execute-plan-with-paramlistSpi-spi-execpSpi-spi-cursor-openSpi-spi-cursor-open-with-argsSpi-spi-cursor-open-with-paramlistSpi-spi-cursor-findSpi-spi-cursor-fetchSpi-spi-cursor-moveSpi-spi-scroll-cursor-fetchSpi-spi-scroll-cursor-moveSpi-spi-cursor-closeSpi-spi-saveplan43.2. Interface Support FunctionsSpi-spi-fnameSpi-spi-fnumberSpi-spi-getvalueSpi-spi-getbinvalSpi-spi-gettypeSpi-spi-gettypeidSpi-spi-getrelnameSpi-spi-getnspname43.3. Memory ManagementSpi-spi-pallocSpi-reallocSpi-spi-pfreeSpi-spi-copytupleSpi-spi-returntupleSpi-spi-modifytupleSpi-spi-freetupleSpi-spi-freetupletableSpi-spi-freeplan43.4. Visibility of Data Changes43.5. ExamplesVI. 参考手册I. SQL命令Sql-abortSql-alteraggregateSql-alterconversionSql-alterdatabaseSql-alterdefaultprivilegesSql-alterdomainSql-alterforeigndatawrapperSql-alterfunctionSql-altergroupSql-alterindexSql-alterlanguageSql-alterlargeobjectSql-alteroperatorSql-alteropclassSql-alteropfamilySql-alterroleSql-alterschemaSql-altersequenceSql-alterserverSql-altertableSql-altertablespaceSql-altertsconfigSql-altertsdictionarySql-altertsparserSql-altertstemplateSql-altertriggerSql-altertypeSql-alteruserSql-alterusermappingSql-alterviewSql-analyzeSql-beginSql-checkpointSql-closeSql-clusterSql-commentSql-commitSql-commit-preparedSql-copySql-createaggregateSql-createcastSql-createconstraintSql-createconversionSql-createdatabaseSql-createdomainSql-createforeigndatawrapperSql-createfunctionSql-creategroupSql-createindexSql-createlanguageSql-createoperatorSql-createopclassSql-createopfamilySql-createroleSql-createruleSql-createschemaSql-createsequenceSql-createserverSql-createtableSql-createtableasSql-createtablespaceSql-createtsconfigSql-createtsdictionarySql-createtsparserSql-createtstemplateSql-createtriggerSql-createtypeSql-createuserSql-createusermappingSql-createviewSql-deallocateSql-declareSql-deleteSql-discardSql-doSql-dropaggregateSql-dropcastSql-dropconversionSql-dropdatabaseSql-dropdomainSql-dropforeigndatawrapperSql-dropfunctionSql-dropgroupSql-dropindexSql-droplanguageSql-dropoperatorSql-dropopclassSql-dropopfamilySql-drop-ownedSql-droproleSql-dropruleSql-dropschemaSql-dropsequenceSql-dropserverSql-droptableSql-droptablespaceSql-droptsconfigSql-droptsdictionarySql-droptsparserSql-droptstemplateSql-droptriggerSql-droptypeSql-dropuserSql-dropusermappingSql-dropviewSql-endSql-executeSql-explainSql-fetchSql-grantSql-insertSql-listenSql-loadSql-lockSql-moveSql-notifySql-prepareSql-prepare-transactionSql-reassign-ownedSql-reindexSql-release-savepointSql-resetSql-revokeSql-rollbackSql-rollback-preparedSql-rollback-toSql-savepointSql-selectSql-selectintoSql-setSql-set-constraintsSql-set-roleSql-set-session-authorizationSql-set-transactionSql-showSql-start-transactionSql-truncateSql-unlistenSql-updateSql-vacuumSql-valuesII. 客户端应用程序App-clusterdbApp-createdbApp-createlangApp-createuserApp-dropdbApp-droplangApp-dropuserApp-ecpgApp-pgconfigApp-pgdumpApp-pg-dumpallApp-pgrestoreApp-psqlApp-reindexdbApp-vacuumdbIII. PostgreSQL服务器应用程序App-initdbApp-pgcontroldataApp-pg-ctlApp-pgresetxlogApp-postgresApp-postmasterVII. 内部章44. PostgreSQL内部概览44.1. 查询路径44.2. 连接是如何建立起来的44.3. 分析器阶段44.4. ThePostgreSQL规则系统44.5. 规划器/优化器44.6. 执行器章45. 系统表45.1. 概述45.2. pg_aggregate45.3. pg_am45.4. pg_amop45.5. pg_amproc45.6. pg_attrdef45.7. pg_attribute45.8. pg_authid45.9. pg_auth_members45.10. pg_cast45.11. pg_class45.12. pg_constraint45.13. pg_conversion45.14. pg_database45.15. pg_db_role_setting45.16. pg_default_acl45.17. pg_depend45.18. pg_description45.19. pg_enum45.20. pg_foreign_data_wrapper45.21. pg_foreign_server45.22. pg_index45.23. pg_inherits45.24. pg_language45.25. pg_largeobject45.26. pg_largeobject_metadata45.27. pg_namespace45.28. pg_opclass45.29. pg_operator45.30. pg_opfamily45.31. pg_pltemplate45.32. pg_proc45.33. pg_rewrite45.34. pg_shdepend45.35. pg_shdescription45.36. pg_statistic45.37. pg_tablespace45.38. pg_trigger45.39. pg_ts_config45.40. pg_ts_config_map45.41. pg_ts_dict45.42. pg_ts_parser45.43. pg_ts_template45.44. pg_type45.45. pg_user_mapping45.46. System Views45.47. pg_cursors45.48. pg_group45.49. pg_indexes45.50. pg_locks45.51. pg_prepared_statements45.52. pg_prepared_xacts45.53. pg_roles45.54. pg_rules45.55. pg_settings45.56. pg_shadow45.57. pg_stats45.58. pg_tables45.59. pg_timezone_abbrevs45.60. pg_timezone_names45.61. pg_user45.62. pg_user_mappings45.63. pg_views章46. Frontend/Backend Protocol46.1. Overview46.2. Message Flow46.3. Streaming Replication Protocol46.4. Message Data Types46.5. Message Formats46.6. Error and Notice Message Fields46.7. Summary of Changes since Protocol 2.047. PostgreSQL Coding Conventions47.1. Formatting47.2. Reporting Errors Within the Server47.3. Error Message Style Guide章48. Native Language Support48.1. For the Translator48.2. For the Programmer章49. Writing A Procedural Language Handler章50. Genetic Query Optimizer50.1. Query Handling as a Complex Optimization Problem50.2. Genetic Algorithms50.3. Genetic Query Optimization (GEQO) in PostgreSQL50.4. Further Reading章51. 索引访问方法接口定义51.1. 索引的系统表记录51.2. 索引访问方法函数51.3. 索引扫描51.4. 索引锁的考量51.5. 索引唯一性检查51.6. 索引开销估计函数章52. GiST Indexes52.1. Introduction52.2. Extensibility52.3. Implementation52.4. Examples52.5. Crash Recovery章53. GIN Indexes53.1. Introduction53.2. Extensibility53.3. Implementation53.4. GIN tips and tricks53.5. Limitations53.6. Examples章54. 数据库物理存储54.1. 数据库文件布局54.2. TOAST54.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 ConformanceD.1. Supported FeaturesD.2. Unsupported FeaturesE. Release NotesRelease-0-01Release-0-02Release-0-03Release-1-0Release-1-01Release-1-02Release-1-09Release-6-0Release-6-1Release-6-1-1Release-6-2Release-6-2-1Release-6-3Release-6-3-1Release-6-3-2Release-6-4Release-6-4-1Release-6-4-2Release-6-5Release-6-5-1Release-6-5-2Release-6-5-3Release-7-0Release-7-0-1Release-7-0-2Release-7-0-3Release-7-1Release-7-1-1Release-7-1-2Release-7-1-3Release-7-2Release-7-2-1Release-7-2-2Release-7-2-3Release-7-2-4Release-7-2-5Release-7-2-6Release-7-2-7Release-7-2-8Release-7-3Release-7-3-1Release-7-3-10Release-7-3-11Release-7-3-12Release-7-3-13Release-7-3-14Release-7-3-15Release-7-3-16Release-7-3-17Release-7-3-18Release-7-3-19Release-7-3-2Release-7-3-20Release-7-3-21Release-7-3-3Release-7-3-4Release-7-3-5Release-7-3-6Release-7-3-7Release-7-3-8Release-7-3-9Release-7-4Release-7-4-1Release-7-4-10Release-7-4-11Release-7-4-12Release-7-4-13Release-7-4-14Release-7-4-15Release-7-4-16Release-7-4-17Release-7-4-18Release-7-4-19Release-7-4-2Release-7-4-20Release-7-4-21Release-7-4-22Release-7-4-23Release-7-4-24Release-7-4-25Release-7-4-26Release-7-4-27Release-7-4-28Release-7-4-29Release-7-4-3Release-7-4-30Release-7-4-4Release-7-4-5Release-7-4-6Release-7-4-7Release-7-4-8Release-7-4-9Release-8-0Release-8-0-1Release-8-0-10Release-8-0-11Release-8-0-12Release-8-0-13Release-8-0-14Release-8-0-15Release-8-0-16Release-8-0-17Release-8-0-18Release-8-0-19Release-8-0-2Release-8-0-20Release-8-0-21Release-8-0-22Release-8-0-23Release-8-0-24Release-8-0-25Release-8-0-26Release-8-0-3Release-8-0-4Release-8-0-5Release-8-0-6Release-8-0-7Release-8-0-8Release-8-0-9Release-8-1Release-8-1-1Release-8-1-10Release-8-1-11Release-8-1-12Release-8-1-13Release-8-1-14Release-8-1-15Release-8-1-16Release-8-1-17Release-8-1-18Release-8-1-19Release-8-1-2Release-8-1-20Release-8-1-21Release-8-1-22Release-8-1-23Release-8-1-3Release-8-1-4Release-8-1-5Release-8-1-6Release-8-1-7Release-8-1-8Release-8-1-9Release-8-2Release-8-2-1Release-8-2-10Release-8-2-11Release-8-2-12Release-8-2-13Release-8-2-14Release-8-2-15Release-8-2-16Release-8-2-17Release-8-2-18Release-8-2-19Release-8-2-2Release-8-2-20Release-8-2-21Release-8-2-3Release-8-2-4Release-8-2-5Release-8-2-6Release-8-2-7Release-8-2-8Release-8-2-9Release-8-3Release-8-3-1Release-8-3-10Release-8-3-11Release-8-3-12Release-8-3-13Release-8-3-14Release-8-3-15Release-8-3-2Release-8-3-3Release-8-3-4Release-8-3-5Release-8-3-6Release-8-3-7Release-8-3-8Release-8-3-9Release-8-4Release-8-4-1Release-8-4-2Release-8-4-3Release-8-4-4Release-8-4-5Release-8-4-6Release-8-4-7Release-8-4-8Release-9-0Release-9-0-1Release-9-0-2Release-9-0-3Release-9-0-4F. 额外提供的模块F.1. adminpackF.2. auto_explainF.3. btree_ginF.4. btree_gistF.5. chkpassF.6. citextF.7. cubeF.8. dblinkContrib-dblink-connectContrib-dblink-connect-uContrib-dblink-disconnectContrib-dblinkContrib-dblink-execContrib-dblink-openContrib-dblink-fetchContrib-dblink-closeContrib-dblink-get-connectionsContrib-dblink-error-messageContrib-dblink-send-queryContrib-dblink-is-busyContrib-dblink-get-notifyContrib-dblink-get-resultContrib-dblink-cancel-queryContrib-dblink-get-pkeyContrib-dblink-build-sql-insertContrib-dblink-build-sql-deleteContrib-dblink-build-sql-updateF.9. dict_intF.10. dict_xsynF.11. earthdistanceF.12. fuzzystrmatchF.13. hstoreF.14. intaggF.15. intarrayF.16. isnF.17. loF.18. ltreeF.19. oid2nameF.20. pageinspectF.21. passwordcheckF.22. pg_archivecleanupF.23. pgbenchF.24. pg_buffercacheF.25. pgcryptoF.26. pg_freespacemapF.27. pgrowlocksF.28. pg_standbyF.29. pg_stat_statementsF.30. pgstattupleF.31. pg_trgmF.32. pg_upgradeF.33. segF.34. spiF.35. sslinfoF.36. tablefuncF.37. test_parserF.38. tsearch2F.39. unaccentF.40. uuid-osspF.41. vacuumloF.42. xml2G. 外部项目G.1. 客户端接口G.2. 过程语言G.3. 扩展H. The Source Code RepositoryH.1. Getting The Source Via GitI. 文档I.1. DocBookI.2. 工具集I.3. 制作文档I.4. 文档写作I.5. 风格指导J. 首字母缩略词参考书目BookindexIndex
文字

31.1. 数据库联接函数

下面的函数处理与PostgreSQL服务器服务器联接的事情。 一个应用程序一次可以与多个服务器建立联接。(这么做的原因之一是访问多于一个数据库。 ) 每个连接都是用一个从函数PQconnectdbPQconnectdbParamsPQsetdbLogin获得的PGconn对象表示。 注意,这些函数总是返回一个非空的对象指针,除非存储器少得连个PGconn对象都分配不出来。 在把查询发送给联接对象之前,可以调用PQstatus函数来检查一下联接是否成功。

在Unix上,分叉与开放的libpq连接进程可能会导致 不可预知的结果,因为父和子进程共享 相同的插座和操作系统资源。出于这个原因, 这种用法是不推荐,虽然做的exec 子进程加载一个新的可执行文件是安全的。

Note: 在Windows上,有一个方式可以提高性能,如果一个单一的数据库连接重复的开启和关闭。 内部,libpq为连接启动和关闭分别调用WSAStartup()WSACleanup()WSAStartup()引用WSACleanup()递减的技术来增量内置Windows库。 当引用的技术只有一时,调用WSACleanup()来释放所有的资源并写在所有的DLL。 这个操作的开销很大,为了避免,一个应用程序可以经常调用WSAStartup(), 这样当最后一个数据库连接关闭时,不会释放所有资源。

PQconnectdbParams

与服务器数据库服务器建立一个新的联接。

PGconn *PQconnectdbParams(const char **keywords,const char **values,int expand_dbname);

这个函数使用取自两个NULL终止数组的参数来开启一个新的数据库连接。 首先,被定义为一个字符串数组的keywords中的每个元素都是一个关键字。 其次,values为每个关键字赋值。不同于下面的PQsetdbLogin, 这个参数设置可以无需修改参数签名来扩展,因此,使用这个函数(或其非阻塞的变形PQconnectStartParamsPQconnectPoll) 更适合一个新的应用程序编程。

expand_dbname非0时,dbname关键字值允许被确认为 一个conninfo字符串。

所有传递的数组可以被清空以用于所有的缺省参数,或用于包含一个或多个参数设置。 它们必须是等长的。进程会随着keywords数组中最后一个非NULL元素而终止。

目前可识别的参数键字是:

host

要联接的主机名。如果主机名以斜杠开头,则它声明使用 Unix 域套接字通讯而 不是 TCP/IP 通讯;该值就是套接字文件所存储的目录。如果没有声明host, 那么缺省时是与位于/tmp目录(或者制作PostgreSQL的时候声明的套接字目录) 里面的 Unix-域套接字联接。在没有域套接字的机器上, 缺省是与localhost连接。

hostaddr

与之联接的主机的IP地址。这个应该是标准的IPv4地址格式, 比如,172.28.40.9。如果你的机器支持IPv6,那么你也可以使用IPv6的地址。 如果声明了一个非空的字符串,那么使用TCP/IP通讯机制。

使用hostaddr取代host可以让应用避免一次主机名查找, 这一点对于那些有时间约束的应用来说可能是非常重要的。不过,Kerberos认证 系统要求主机(host)名。因此,应用下面的规则:如果声明了 不带hostaddrhost那么就强制进行主机名查找。如果声明中没有host,hostaddr的值 给出远端的地址; 如果使用了 Kerberos,将导致一次反向名字查询。 如果同时声明了hosthostaddr,除非使用了Kerberos, 否则将使用hostaddr的值作为远端地址;host的值将被忽略, 如果使用了Kerberos,host的值用于 Kerberos 认证。 (要注意如果传递给libpq的主机名(host)不是地址hostaddr处的机器名, 那么认证很有可能失败。) 同样,在~/.pgpass(参阅Section 31.14)中是 使用host而不是hostaddr来标识连接。

如果主机名(host)和主机地址都没有,那么libpq将使用一个本地 的 Unix 域套接字进行通讯; 或者是在没有 Unix 域套接字的机器上, 它将尝试与localhost连接。

port

主机服务器的端口号,或者在Unix域套接字联接时的套接字扩展文件名。

dbname

数据库名。缺省和用户名相同。

user

要联接的PostgreSQL用户名。 缺省是与运行该应用的用户操作系统名同名的用户。

password

如果服务器要求口令认证,所用的口令。

connect_timeout

连接的最大等待时间,以秒计(用十进制整数字串书写)。零或者不声明表示无穷。 我们不建议把连接超时的值设置得小于2秒。

options

发送给服务器的命令行选项。 例如,设置这-c geqo=off设置 会话的价值geqo参数为 off。为详细讨论了可用 选项,参阅Chapter 18。

application_name

为application_name配置参数指定值

fallback_application_name

为application_name配置参数声明一个备用值。 如果连接参数或PGAPPNAME环境变量没有为application_name赋值,那么就会使用该值。 在通用的应用程序(最好设置一个缺省应用程序名)中,声明一个备用名字时很有用的,这样用户自己可以重写该名字。

keepalives

控制是否保持客户端的TCP连接使用。缺省值是1,表示开启,但可以改为0,表示不开启。 通过一个Unix域套接字,可以为连接模式忽略该参数。

keepalives_idle

控制空闲秒数,在这个秒数之后,TCP应该向服务器发送一个保持活动的信息。 系统缺省是0。通过一个Unix域套接字,或者如果禁用保持活动,可以为连接模式忽略该参数。 只有在Windows,或TCP_KEEPIDLETCP_KEEPALIVE套接字选项可用的操作系统 上才可以使用这个参数,在其他操作系统上,该参数无效。

keepalives_interval

控制空闲秒数,在这个秒数之后,一个服务器无法识别的TCP保持活动的信息应该被重新翻译。 系统缺省是0。通过一个Unix域套接字,或者如果禁用保持活动,可以为连接模式忽略该参数。 只有在Windows,或TCP_KEEPINTVL套接字选项可用的操作系统 上才可以使用这个参数,在其他操作系统上,该参数无效。

keepalives_count

控制那些在客户端到服务器端连接被认为dead之前会丢失的TCP保持连接的数目。 系统缺省是0。通过一个Unix域套接字,或者如果禁用保持活动,可以为连接模式忽略该参数。 只有在Windows,或TCP_KEEPINTVL套接字选项可用的操作系统 上才可以使用这个参数,在其他操作系统上,该参数无效。

tty

忽略(以前,这个选项声明服务器日志的输出方向)。

sslmode

这个选项决定是否需要和服务器协商一个SSL连接, 以及以什么样的优先级与服务器进行SSL连接。有六种模式可供 选择:

Table 31-1. sslmode选项

Option Description
disable 只有尝试非SSL连接
allow 首次尝试非SSL 连接,如果失败,尝试SSL 连接
prefer(缺省) 首次尝试SSL 连接,如果失败,尝试非SSL 连接。
require 仅尝试一个SSL连接
verify-ca 只尝试SSL连接,并通过可信任的CA验证 服务器证书。
verify-full 只尝试SSL连接,通过可信任的CA验证 服务器证书是和证书中 该服务器的主机名是否匹配。

了解这些选项的详细信息请查阅Section 31.17。

sslmode被Unix域套接字沟通忽略 如果不支持SSL编译PostgreSQL的, 使用选项requireverify-ca,或 verify-full将导致一个错误,而 选项??allowprefer会 接受,但的libpq实际上不会尝试 SSL连接。

requiressl

这个选项因为有了sslmode设置之后已经废弃了。

如果设为1,则要求与服务器进行SSL联接 (等效于sslmode。 如果服务器不支持SSL,那么libpq 将马上拒绝联接。设置为0(缺省)与服务器进行协商连接类型(等效于 sslmode)。这个选项只有 在编译PostgreSQL时打开了SSL支持才有效。

sslcert

此参数指定的客户端SSL 证书文件名,替换默认 ~/.postgresql/postgresql.crt。 如果没有一个SSL连接,则忽略此参数。

sslkey

这个参数声明用于客户端认证的密钥的位置。要么声明一个文件名用于代替缺省的~/.postgresql/postgresql.key, 要么从外部"engine"获得并声明的一个关键字("engine"OpenSSL可加载模块)。 一个外部引擎声明得是由一个冒号分隔的引擎名称和一个特定引擎的密钥标识符组成。 如果不是SLL连接模式,那么忽略该参数。

sslrootcert

此参数指定的文件包含SSL的名称 证书颁发机构(CA)证书(S)。 如果该文件存在,服务器的证书 由这些机构签署确认。 默认是~/.postgresql/root.crt

sslcrl

这个参数声明的是CRL的文件名。如果存在,那么在这个文件中的声明列表在尝试认证服务器端认证时会使用。 缺省是~/.postgresql/root.crl

krbsrvname

当认证带有Kerberos 5或GSSAPI是使用的Kerberos服务名。 它必须匹配在Kerberos认证成功的服务器配置参数中声明的服务名。 (参阅Section 19.3.5和Section 19.3.3)。

gsslib

用于GSSAPI认证的GSS库。只用于Windows操作系统。 设置gssapi强制libpq使用GSSAPI库以代替缺省的SSPI来认证。

service

用于额外参数的服务名。它在pg_service.conf里面声明一个服务名, 这个配置文件保 存额外的连接参数。这样就允许应用应用只声明一个服务名,而连接参数就可以在一 个地方维护了。参阅安装目录中的Section 31.15获取如何设置这个文 件的信息。

如果有任何没有声明的参数,那么将检查对应的环境变量 (参阅Section 31.13小节)。 如果环境变量也没有设置,那么使用编译时的指明的内置缺省。

如果expand_dbname非0,同时dbname中包含 一个=标记,它会看做是一个conninfo字符串, 以相同的方式传递到PQconnectdb中。之前的关键字会被conninfo 中的关键字代替。

通常情况下,关键字会从索引序列中的数组的开始进程处理。这样的话,如果关键字重复了,那么在这之前的最后一个 处理结果会被保留。因此,通过仔细防放置dbname关键字, 可以决定哪些方式可以通过conninfo字符串来覆盖,哪些不可以。

PQconnectdb

与服务器数据库服务器建立一个新的联接。

PGconn *PQconnectdb(const char *conninfo);

此函数打开一个新的数据库连接, 从字符串conninfo使用所采取的参数。

可以清空传递的字符串以使用所有的缺省参数,或包含一个或多个通过空格分开的参数设置。 每个参数设置是以keyword = value出现的。 等号两边的空格可以有,也可以没有。在写一个空值,或value中包含空格,可以在其两边使用单引号,如keyword = 'a value'。 在value中的单引号和反斜杠必须使用一个反斜杠来逃逸,如\'\\

目前公认的参数关键词是与上述相同。

PQsetdbLogin

Makes a new connection to the database server.

PGconn *PQsetdbLogin(const char *pghost,
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *dbName,
                     const char *login,
                     const char *pwd);

这个函数是PQconnectdb前身, 它有固定个数的参数。它有相同的功能, 只是在调用中那些它缺少的参数总是用缺省值。如果么给任意的固定参数设置缺省值, 那么写一个NULL或者一个空字串给它们。

如果的dbName包含=符号,它 作为的conninfo字符串完全相同的方式 如果它已通过PQconnectdb,其余 上述参数然后被应用。

PQsetdb

与服务器数据库服务器建立一个新的联接。

PGconn *PQsetdb(char *pghost,
                char *pgport,
                char *pgoptions,
                char *pgtty,
                char *dbName);

这是一个调用PQsetdbLogin的宏, 只是loginpwd参数null代替。 提供这个函数是为了与非常老版本的程序兼容

PQconnectStartParams
PQconnectStart
PQconnectPoll

与数据库服务器建立一次非阻塞的联接。

PGconn *PQconnectStartParams(const char **keywords,const char **values,int expand_dbname);


PGconn *PQconnectStart(const char *conninfo);


PostgresPollingStatusType PQconnectPoll(PGconn *conn);

这3个函数用于打开一个与数据库服务器之间的非阻塞的联接: 你的应用的执行线索在执行它的时候不会因远端的I/O而阻塞。 这个方法的要点是等待I/O结束可以发生在应用的主循环里, 而不是在PQconnectdbParamsPQconnectdb里, 这样应用可以把这件事与其它操作并发起来一起执行。

通过PQconnectStartParams,数据库连接使用来自keywordsvalues数组的参数,并且通过expand_dbname控制,如在PQconnectdbParams 中的描述。

数据库联接是用从conninfo字符串里取得的参数传递给 PQconnectStart进行的。 这个字符串的格式与上面PQconnectdb里描述的一样

PQconnectStartParamsPQconnectStartPQconnectPoll 都不会阻塞,只要有一些限制。

  • 必须正确提供hostaddrhost参数以确保不会发生正向或者反向的名字查找。 参阅上面PQconnectdbParams里的这些参数的文档获取细节。

  • 如果你调用了PQtrace,确保你跟踪进入的流对象不会阻塞。

  • 你必须在调用PQconnectPoll之前确保socket处于正确的状态, 象下面描述的那样。

注意:PQconnectStartParams是类似于PQconnectStart如下所示。

要开始一次非阻塞连接请求,调用 conn = PQconnectStart("connection_info_string")。 如果conn是空,表明libpq无法分配一个新的PGconn结构。 否则,返回一个有效的PGconn指针 (尽管还不一定代表一个与数据库有效联接)。PQconnectStart一返回,调用 status = PQstatus(conn)。 如果status等于CONNECTION_BADPQconnectStart失败。

如果PQconnectStart成功了,下一个阶段是轮询libpq,这样它就可以继续连接序列动作。 使用PQsocket(conn)获取数据库链接下层的套接字描述符。象这样循环: 如果PQconnectPoll(conn)的最后一个返回是PGRES_POLLING_READING,那么就等到套接 字准备好被读取了的时候(就像系统函数select()poll(),或者类似的系统调用声明的那样)。 然后再次调用PQconnectPoll(conn)。同样,如果PQconnectPoll(conn)最后返 回PGRES_POLLING_WRITING,那么就等到套接字准备好可以写了,然后再次调用PQconnectPoll(conn)。 如果你还没调用PQconnectPoll,比如,刚刚调用完PQconnectStart,那么按照它刚 返回PGRES_POLLING_WRITING的原则行动。继续这个循环直到PQconnectPoll(conn)返 回PGRES_POLLING_FAILED,表明连接失败,或者PGRES_POLLING_OK,表明连接成功建立。

在联接的任意时刻,我们都可以通过调用PQstatus来检查联接的状态。 如果这是CONNECTION_BAD,那么联接过程失败;如果是CONNECTION_OK,那么联接已经做好。 这两种状态同样也可以从上面的PQconnectPoll的返回值里检测到。其他状态可能(也只能) 在一次异步联接过程中发生。这些标识联接过程的当前状态,因而可能对给用户提供反馈有帮助。 这些状态可能包括:

CONNECTION_STARTED

等待进行联接。

CONNECTION_MADE

联接成功;等待发送

CONNECTION_AWAITING_RESPONSE

等待来自服务器的响应。

CONNECTION_AUTH_OK

已收到认证;等待联接启动继续进行。

CONNECTION_SSL_STARTUP

协商SSL加密。

CONNECTION_SETENV

协商环境驱动的参数设置。

注意,尽管这些常量将保持下去(为了维持兼容性),应用决不应该依赖于这些常 量以某种特定顺序出现,或者是根本不应依赖于这些常量,或者是不应该依赖于这些 状态总是某个文档声明的值。一个应用可能象象下面这样:

switch(PQstatus(conn))
{
        case CONNECTION_STARTED:
            feedback = "Connecting...";
            break;

        case CONNECTION_MADE:
            feedback = "Connected to server...";
            break;
.
.
.
        default:
            feedback = "Connecting...";
}

在使用PQconnectPoll的时候,连接参数connect_timeout将被忽略; 判断是否超时是应用的责任。否则,后面跟着一个PQconnectPoll循环的 PQconnectStart等效于PQconnectdb

要注意如果PQconnectStart返回一个非空的指针,你必须在使用完它(指针)之后调用 PQfinish, 以处理那些结构和所有相关的存储块,甚至连接失败时也要这样处理。

PQconndefaults

返回缺省的联接选项。

PQconninfoOption *PQconndefaults(void);

typedef struct
{
    char   *keyword;   /* The keyword of the option */
    char   *envvar;    /* Fallback environment variable name */
    char   *compiled;  /* Fallback compiled in default value */
    char   *val;       /* Option's current value,or NULL */
    char   *label;     /* Label for field in connect dialog */
    char   *dispchar;  /* Indicates how to display this field
                          in a connect dialog. Values are:
                          ""        Display entered value as is
                          "*"       Password field - hide value
                          "D"       Debug option - don't show by default */
    int     dispsize;  /* Field size in characters for dialog */
} PQconninfoOption;

返回一个连接选项数组。可以用于获取所有可能的PQconnectdb选项和它们的当前缺省值。 返回值指向一个PQconninfoOption结构的数组,该数组以一个有NULLkeyword指针的条目结束。 如果无法分配内存,则返回空指针。注意缺省值(val域)将依赖于环境变量和其他环境。 调用者必须把连接选项当作只读对待。

在处理完选项数组后,把数组交给PPQconninfoFree释放。如果没有这么做, 每次调用PQconndefaults都会有一小部分内存泄漏。

PQconninfoParse

返回解析提供的连接字符串的连接选项。

PQconninfoOption *PQconninfoParse(const char *conninfo,char **errmsg);

解析一个连接字符串,并返回结果选项为一个数组,或这,如果连接字符串有问题,那么返回一个NULL。 这个可以用于决定在提供的连接字符串中的PQconnectdb选项。 返回值指向一个PQconninfoOption结构的数组,这个结构一个带有空keyword指针 的条目结束。

需要注意的是,只有明确在字符串中声明的选项可以在结果数组中的设置中有参数值;没有缺省的话是插入。

如果errmsgNULL,那么成功的时候,*errmsg被设置为NULL, 否则设置为malloc的错误字符串以说明错误。 (也可以将*errmsg设置为NULL,即使返回一个NULL;这表示内存溢出)。

在处理完选项数组之后,通过将其传递给PQconninfoFree来进行释放。 如果没有这么做,那么每个PQconninfoParse的请求时会有一些内存溢出。 反过来,如果发生错误并且errmsgNULL,通过PQfreemem 来释放错误字符串。

PQfinish

关闭与服务器的连接。同时释放被PGconn对象使用的存储器。

void PQfinish(PGconn *conn);

注意,即使与服务器的连接尝试失败(可由PQstatus判断),应用也要 调用PQfinish释放被PGconn对象使用的存储器。 不应该在调用PQfinish后再使用PGconn 指针。

PQreset

重置与服务器的通讯端口。

void PQreset(PGconn *conn);

此函数将关闭与服务器的连接并且试图与同一个服务器重建新的连接, 使用所有前面使用过的参数。这在失去工作连接后进行故障恢复时很有用。

PQresetStart
PQresetPoll

以非阻塞模式重置与服务器的通讯端口。

int PQresetStart(PGconn *conn);

PostgresPollingStatusType PQresetPoll(PGconn *conn);

此函数将关闭与服务器的连接并且试图与同一个服务器重建新的连接,使用所有前面使用过的参数。 这在失去工作连接后进行故障恢复时很有用。它们和上面的PQreset的区别是它们工作在非阻塞模式。 这些函数的使用有与上面PQconnectStartParamsPQconnectStartPQconnectPoll一样的限制。

要发起一次连接重置,调用PQresetStart。如果它返回0,那么重置失败。 如果返回1,用与使用PQresetPoll建立连接的同样的方法使用PQconnectPoll重置连接。

上一篇:下一篇: