PostgreSQL 文档检索

DROP USER章节正文PG18DROP USER DROP USER — 移除一个数据库角色大纲 DROP USER [ IF EXISTS ] name [, ...]DROP USER DROP USER MAPPING章节正文PG18DROP USER MAPPING DROP USER MAPPING — 删除外部服务器的用户映射大纲 DROP USER MAPPING [ IF EXISTS ] FOR { user_name | USER | CURRENT_ROLE | CURRENT_USER | PUBLIC } SERVER server_nameDROP USER MAPPING DROP VIEW章节正文PG18DROP VIEW DROP VIEW — 移除一个视图大纲 DROP VIEW [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]DROP VIEW dropdb章节正文PG18dropdb dropdb — 移除一个PostgreSQL数据库大纲 dropdb [connection-option...] [option...] dbnamedropdb dropuser章节正文PG18dropuser dropuser — 移除一个PostgreSQL用户账户大纲 dropuser [connection-option...] [option...] [username]dropuser earthdistance — 计算大圆距离章节正文PG18F.14. earthdistance — 计算大圆距离 earthdistance 模块提供了两种不同的方法，用于计算地球表面上的大圆距离。首先介绍的一种依赖于 cube 模块。第二种方法基于内置的 point 数据类型，使用经度和纬度作为坐标。在这个模块中，地球被假定为完全球形的。（如果这种假设对你而言精度不足，可以参见 PostGIS 项目。）必须先安装 cube 模块，…earthdistance — 计算大圆距离 ecpg章节正文PG18ecpg ecpg — 嵌入式 SQL C 预处理器大纲 ecpg [option...] file...ecpg element_types章节正文PG1835.24. element_types 视图element_types包含数组元素的数据类型描述符。当一个表列、复合类型属性、域、函数参数或函数返回值被定义为一种数组类型时，相应的信息模式视图只在列data_type中包含ARRAY。要获得该数组元素类型的信息，你可以连接该相应的视图和这个视图。例如，要显示一个表的列及其数据类型和数组元素类型（如果适用），你可以：SELECT…element_types Emacs章节正文PG18J.5.1. Emacs nXML Mode随Emacs一起提供，是编辑XML文档时在Emacs中最常见的模式。它允许你使用Emacs插入标签并检查标记一致性，而且开箱即支持DocBook。详细文档请参阅 nXML manual。src/tools/editors/emacs.samples包含了这种模式的推荐设置。Emacs enabled_roles章节正文PG1835.25. enabled_roles 视图enabled_roles标识当前“已启用的角色”。已启用的角色递归地定义为：当前用户，以及所有通过自动继承方式授予给已启用角色的角色。换句话说，这些角色都是当前用户直接或间接自动继承其成员资格的角色。对于权限检查，使用的是一组“适用角色”，其范围可能比已启用角色的集合更广。因此，一般来说最好使用视图applicable_roles…enabled_roles END章节正文PG18END END — 提交当前事务大纲 END [ WORK | TRANSACTION ] [ AND [ NO ] CHAIN ]END EXCEPT 子句章节正文PG18EXCEPT 子句 EXCEPT子句的一般形式如下：select_statement EXCEPT [ ALL | DISTINCT ] select_statement select_statement 是任何没有ORDER BY、LIMIT、FOR NO KEY UPDATE、FOR UPDATE、FOR SHARE以及FOR KEY SHARE子句的 SELECT语句。E…EXCEPT 子句 EXCLUDE 约束章节正文PG18EXCLUDE 约束 EXCLUDE 约束类型是 PostgreSQL 的扩展。EXCLUDE 约束 EXECUTE章节正文PG18EXECUTE EXECUTE — 执行一个预备语句大纲 EXECUTE name [ ( parameter [, ...] ) ]EXECUTE EXECUTE章节正文PG1841.13.2.2. EXECUTE PL/pgSQL中的EXECUTE与PL/SQL中的版本工作方式相似，但必须记得按照第 41.5.4 节中的说明使用quote_literal和quote_ident。像 EXECUTE 'SELECT * FROM $1'; 这样的写法如果不借助这些函数，将无法可靠地工作。EXECUTE EXECUTE IMMEDIATE章节正文PG18EXECUTE IMMEDIATE EXECUTE IMMEDIATE — 动态地预备并执行一个语句大纲 EXECUTE IMMEDIATE stringEXECUTE IMMEDIATE EXISTS章节正文PG189.24.1. EXISTS EXISTS (subquery) EXISTS的参数是一个任意的SELECT语句，或者说子查询。系统对子查询进行运算以判断它是否返回行。如果它至少返回一行，那么EXISTS的结果就为“真”；如果子查询没有返回行，那么EXISTS的结果是“假”。子查询可以引用外层查询的变量，这些变量在该子查询的任何一次计算中都起常量的作用。这个子查询通常只是运行到…EXISTS EXIT章节正文PG1841.6.5.2. EXIT EXIT [ label ] [ WHEN boolean-expression ]; 如果没有给出label，那么最内层的循环会被终止，然后跟在END LOOP后面的语句会被执行。如果给出了label，那么它必须是当前或者更高层的嵌套循环或者语句块的标签。然后该命名循环或块就会被终止，并且控制会转移到该循环/块相应的END之后的语句上。如果指定了…EXIT EXPLAIN章节正文PG18EXPLAIN EXPLAIN — 显示一个语句的执行计划大纲 EXPLAIN [ ( option [, ...] ) ] statement 其中 option 可以是以下之一： ANALYZE [ boolean ] VERBOSE [ boolean ] COSTS [ boolean ] SETTINGS [ boolean ] GENERIC_PLAN [ bool…EXPLAIN EXPLAIN章节正文PG18E.6.3.2.3. EXPLAIN 自动将 BUFFERS 输出包含在 EXPLAIN ANALYZE 中（Guillaume Lelarge, David Rowley）§ 添加完整WAL缓冲区计数到 EXPLAIN (WAL) 输出（Bertrand Drouvot）§ 在 EXPLAIN ANALYZE 中，报告每个索引扫描节点使用的索引查找次数（Peter Geogh…EXPLAIN EXPLAIN (DEBUG)章节正文PG18F.29.1. EXPLAIN (DEBUG) DEBUG选项显示计划树中的一些杂项信息，这些信息通常不会展示，因为一般认为它们并不具有普遍意义。对于每个单独的计划节点，它会显示以下字段。关于这些字段的更多文档，请参见 Plan（定义见nodes/plannodes.h）。Disabled Nodes。常规的EXPLAIN会通过检查某个节点的禁用节点计数是否大于其底层节点计数之…EXPLAIN (DEBUG) EXPLAIN (RANGE_TABLE)章节正文PG18F.29.2. EXPLAIN (RANGE_TABLE) RANGE_TABLE选项显示计划树中专门与查询的范围表（range table）有关的信息。范围表条目大致对应于查询 FROM子句中出现的各项，但也有许多例外。例如，被证明不必要的子查询可能会从范围表中被完全删除，而继承展开则会为查询中未直接命名的子表添加范围表条目。在查询计划中，范围表条目通常通过范围表索引（ran…EXPLAIN (RANGE_TABLE) EXPLAIN ANALYZE章节正文PG1814.1.2. EXPLAIN ANALYZE 可以使用EXPLAIN的ANALYZE选项来检查规划器估计值的准确性。启用该选项后，EXPLAIN会实际执行查询，然后显示各个计划节点累计的真实行计数和真实运行时间，同时也保留普通EXPLAIN会显示的估计值。例如，可能会得到如下结果：EXPLAIN ANALYZE SELECT * FROM tenk1 t1, tenk2 t2…EXPLAIN ANALYZE EXPLAIN 的 FDW 例程章节正文PG1858.2.7. EXPLAIN 的 FDW 例程 void ExplainForeignScan(ForeignScanState *node, ExplainState *es); 打印额外的 EXPLAIN 输出，用于说明外部表扫描。此函数可以调用 ExplainPropertyText 及相关函数，向 EXPLAIN 输出添加字段。可以利用 es 中的标志字段确定打印内容…EXPLAIN 的 FDW 例程 EXPLAIN基础章节正文PG1814.1.1. EXPLAIN基础查询计划的结构是一棵由计划节点组成的树。树的最底层是扫描节点，它们从表中返回原始行。不同的表访问方法对应不同类型的扫描节点，例如顺序扫描、索引扫描和位图索引扫描。也有一些并非表的行来源，例如VALUES子句和FROM中的返回集合函数，它们也各自有对应的扫描节点类型。如果查询需要对原始行执行连接、聚合、排序或其他操作，那么扫描节点之上还会出现额外…EXPLAIN基础 EXTRACT, date_part章节正文PG189.9.1. EXTRACT, date_part EXTRACT(field FROM source) extract函数从日期/时间值中检索子字段，例如年份或小时。source必须是timestamp、date、time或interval类型的值表达式。（时间戳和时间可以带有或不带有时区。）field是一个标识符或字符串，用于选择从源值中提取哪个字段。并非每种输入数据类型都…EXTRACT, date_part FETCH章节正文PG1841.7.3.1. FETCH FETCH [ direction { FROM | IN } ] cursor INTO target; FETCH从游标中按指定方向检索下一行到目标中，目标可以是一个行变量、记录变量或者逗号分隔的简单变量列表，就像SELECT INTO一样。如果没有合适的行，目标会被设置为 NULL。与SELECT INTO一样，可以检查特殊变量FOUND来…FETCH FETCH章节正文PG18FETCH FETCH — 使用游标从查询中检索行大纲 FETCH [ direction ] [ FROM | IN ] cursor_name 其中 direction 可以是以下之一： NEXT PRIOR FIRST LAST ABSOLUTE count RELATIVE count count ALL FORWARD FORWARD count FORWARD AL…FETCH file_fdw — 访问服务器文件系统中的数据文件章节正文PG18F.15. file_fdw — 访问服务器文件系统中的数据文件 file_fdw模块提供了外部数据包装器 file_fdw，可用于访问服务器文件系统中的数据文件，或者在服务器上执行程序并读取其输出。数据文件或程序输出必须采用 COPY FROM可读取的格式；详见COPY。当前对数据文件的访问为只读。使用此包装器创建的外部表可以具有下列选项：filename 指定要读取的文件。…file_fdw — 访问服务器文件系统中的数据文件 FOR NO KEY UPDATE、FOR UPDATE、FOR SHARE、FOR KEY SHARE章节正文PG18FOR NO KEY UPDATE、FOR UPDATE、FOR SHARE、FOR KEY SHARE 尽管 SQL 标准中出现了FOR UPDATE，但标准只允许它作为 DECLARE CURSOR的一个选项。PostgreSQL允许它出现在任何 SELECT查询以及子SELECT中，但这是一种扩展。FOR NO KEY UPDATE、FOR SHARE 以及FOR KEY…FOR NO KEY UPDATE、FOR UPDATE、FOR SHARE、FOR KEY SHARE foreign_data_wrapper_options章节正文PG1835.26. foreign_data_wrapper_options 视图foreign_data_wrapper_options包含为当前数据库中外部数据包装器定义的所有选项。只有那些当前用户能够访问（作为拥有者或具有某些权限）的外部数据包装器被显示。表 35.24. foreign_data_wrapper_options 列 列类型 描述 foreign_data_wr…foreign_data_wrapper_options foreign_data_wrappers章节正文PG1835.27. foreign_data_wrappers 视图foreign_data_wrappers包含定义在当前数据库中的所有外部数据包装器。只有那些当前用户能够访问（作为拥有者或具有某些权限）的外部数据包装器才会被显示。表 35.25. foreign_data_wrappers 列 列类型 描述 foreign_data_wrapper_catalog sql_ide…foreign_data_wrappers foreign_server_options章节正文PG1835.28. foreign_server_options 视图foreign_server_options包含为当前数据库中外部服务器定义的所有选项。只有那些当前用户能够访问（作为拥有者或具有某些权限）的外部服务器才会被显示。表 35.26. foreign_server_options 列 列类型 描述 foreign_server_catalog sql_identifi…foreign_server_options foreign_servers章节正文PG1835.29. foreign_servers 视图foreign_servers包含当前数据库中定义的所有外部服务器。只有那些当前用户能够访问（作为拥有者或具有某些权限）的外部服务器才会被显示。表 35.27. foreign_servers 列 列类型 描述 foreign_server_catalog sql_identifier 该外部服务器所在的数据库名称（总是当前数据…foreign_servers foreign_table_options章节正文PG1835.30. foreign_table_options 视图foreign_table_options包含为当前数据库中外部表定义的所有选项。只有那些当前用户能够访问（作为拥有者或具有某些权限）的外部表才会被显示。表 35.28. foreign_table_options 列 列类型 描述 foreign_table_catalog sql_identifier 包含该外部…foreign_table_options foreign_tables章节正文PG1835.31. foreign_tables 视图foreign_tables包含定义在当前数据库中的所有外部表。只有那些当前用户能够访问（作为拥有者或具有某些权限）的外部表才会被显示。表 35.29. foreign_tables 列 列类型 描述 foreign_table_catalog sql_identifier 该外部表所在的数据库名称（总是当前数据库） foreig…foreign_tables format章节正文PG189.4.1. format 函数format根据一个格式字符串产生格式化的输出，其形式类似于 C 函数sprintf。format(formatstr text [, formatarg "any" [, ...] ]) formatstr是指定结果格式的字符串。格式字符串中的文本会直接复制到结果中，但格式说明符所在的位置除外。格式说明符充当字符串中的占位符，定义如何格式化后续…format FOR（整型变体）章节正文PG1841.6.5.5. FOR（整型变体）[ <<label>> ] FOR name IN [ REVERSE ] expression .. expression [ BY expression ] LOOP statements END LOOP [ label ]; 这种形式的FOR会创建一个在一个整数范围上迭代的循环。变量name会自动定义为类型integer并且只在循环…FOR（整型变体） FROM 子句章节正文PG18FROM 子句 FROM子句为SELECT 指定一个或者更多源表。如果指定了多个源表，结果将是所有源表的笛卡尔积（交叉连接）。但是通常会增加限定条件（通过 WHERE）来把返回的行限制为该笛卡尔积的一个小子集。FROM子句可以包含以下元素：table_name # 要扫描的现有表或视图的名称（可选模式限定符）。如果在表名之前指定ONLY，则仅扫描该表。如果未指定ONLY，则扫描…FROM 子句 FROM中的函数调用章节正文PG18FROM中的函数调用 PostgreSQL允许把函数调用直接写成 FROM列表中的一个成员。在 SQL 标准中，必须把这样的函数调用包装在一个子SELECT中。也就是说，语法 FROM func(...) alias 近似等价于 FROM LATERAL (SELECT func(...)) alias。注意该LATERAL被认为是隐式的，这是因为标准对于 FROM中的一个UN…FROM中的函数调用