CREATE EXTENSION命令依赖于每个扩展都有一个控制文件，其名称必须是扩展名加上 .control 后缀，并放在安装目录的 SHAREDIR/extension 目录中。还必须至少有一个 SQL 脚本文件，其名称遵循 extension--version.sql 的模式（例如，扩展 foo 的 1.0 版本使用 foo--1.0.sql）。默认情况下，脚本文件也放在 SHAREDIR/extension 目录中，但控制文件可以为脚本文件指定其他目录。

扩展控制文件的格式与 postgresql.conf 文件相同，即由一组 parameter_name = value 赋值组成，每行一条。允许空行和以 # 引入的注释。任何不是单个单词或数字的值都要记得加引号。

控制文件可以设置下列参数：

除主控制文件 extension.control 外，扩展还可以有按如下样式命名的次级控制文件：extension--version.control。如果提供了这些文件，它们必须位于脚本文件目录中。次级控制文件遵循与主控制文件相同的格式。在安装或更新到该扩展的相应版本时，次级控制文件中设置的任何参数都会覆盖主控制文件中的设置。不过，directory 和 default_version 这两个参数不能在次级控制文件中设置。

扩展的 SQL 脚本文件可以包含任何 SQL 命令，但事务控制命令（BEGIN、COMMIT 等）和无法在事务块内执行的命令（例如 VACUUM）除外。这是因为脚本文件会被隐式地放在事务块中执行。

扩展的 SQL 脚本文件也可以包含以 \echo 开头的行，扩展机制会忽略这些行（将其视为注释）。这一约定通常用于在脚本文件被直接交给 psql 而不是通过 CREATE EXTENSION 装载时抛出错误（见下文中的示例脚本）。如果没有这种机制，用户可能会意外地把扩展内容作为“松散”对象装载，而不是作为一个扩展来装载，这种状态恢复起来会有些麻烦。

虽然脚本文件可以包含指定编码允许的任意字符，但控制文件应只包含纯 ASCII 字符，因为 PostgreSQL 无法知道控制文件采用的是什么编码。在实践中，只有当你想在扩展注释中使用非 ASCII 字符时这才会成为问题。对此推荐的做法是不要使用控制文件中的 comment 参数，而是在脚本文件中使用 COMMENT ON EXTENSION 来设置注释。

用户经常希望把扩展中的对象装载到与扩展作者原先设想不同的模式中。对于这种可重定位性，支持三个级别：

在所有情况下，脚本文件执行时，其初始search_path都会指向目标模式；也就是说，CREATE EXTENSION 做的事情等价于：

SET LOCAL search_path TO @extschema@;

这使得脚本文件创建的对象能够进入目标模式。脚本文件当然也可以修改 search_path，但通常不建议这样做。CREATE EXTENSION 完成后，search_path 会恢复为先前的设置。

目标模式由控制文件中的 schema 参数决定（如果给出了该参数）；否则由 CREATE EXTENSION 的 SCHEMA 选项决定（如果给出了该选项）；否则由当前默认的对象创建模式决定（也就是调用者的 search_path 中第一个模式）。当使用控制文件中的 schema 参数时，如果目标模式尚不存在，则会自动创建；而在另外两种情况下，目标模式必须已经存在。

如果控制文件的 requires 中列出了任何前置扩展，它们的目标模式会追加到 search_path 的初始设置中。这样新扩展的脚本文件就可以看到这些扩展的对象。

虽然不可重定位扩展可以包含分布在多个模式中的对象，但通常仍然希望把所有供外部使用的对象放在单个模式中，这个模式会被视为该扩展的目标模式。这种安排与创建依赖扩展时 search_path 的默认设置配合起来会比较方便。

有些扩展包含配置表，其中存放的数据可能会在扩展安装后被用户新增或修改。通常，如果表属于某个扩展，那么 pg_dump 既不会转储该表的定义，也不会转储其内容。但这种行为对于配置表来说并不理想；用户所做的数据更改必须包含在转储中，否则在转储并恢复之后，扩展的行为就会发生变化。

为了解决这个问题，扩展脚本文件可以把它创建的某个表标记为配置表，这样 pg_dump 就会把该表的内容（而不是定义）包含到转储中。做法是在创建表之后调用函数 pg_extension_config_dump(regclass, text)，例如：

CREATE TABLE my_config (key text, value text);
SELECT pg_catalog.pg_extension_config_dump('my_config', '');

可以用这种方式标记任意数量的表。

当 pg_extension_config_dump 的第二个参数是空字符串时，pg_dump 会转储该表的全部内容。通常只有当该表在扩展脚本创建时最初为空时，这样做才是正确的。如果表中混有初始数据和用户提供的数据，那么 pg_extension_config_dump 的第二个参数就提供了一个用于选择要转储数据的 WHERE 条件。例如，你可以这样做：

CREATE TABLE my_config (key text, value text, standard_entry boolean);

SELECT pg_catalog.pg_extension_config_dump('my_config', 'WHERE NOT standard_entry');

然后确保只有扩展脚本创建的那些行，其 standard_entry 才为真。

更复杂的情况，例如用户可能会修改最初提供的数据行，可以通过在配置表上创建触发器来处理，以确保被修改的行被正确标记。

你可以再次调用 pg_extension_config_dump 来修改与配置表关联的过滤条件。（这通常在扩展更新脚本中很有用。）要把某个表标记为不再是配置表，唯一的方法是通过 ALTER EXTENSION ... DROP TABLE 将它与扩展解除关联。

注意，这些表之间的外键关系会决定 pg_dump 转储它们的顺序。具体来说，pg_dump 会尝试先转储被引用表，再转储引用表。由于外键关系是在 CREATE EXTENSION 时建立的（那时数据尚未装入这些表中），因此不支持环状依赖。若存在环状依赖，数据仍会被转储出来，但该转储将无法直接恢复，需要用户介入处理。

扩展机制的一个优点是，它为管理定义扩展对象的 SQL 命令的更新提供了便利方式。这是通过为扩展安装脚本的每个已发布版本关联一个版本名或版本号来实现的。此外，如果你希望用户能够把数据库从一个版本动态更新到下一个版本，就应提供更新脚本，以完成从一个版本切换到下一版本所需的修改。更新脚本的名称遵循如下模式：extension--oldversion--newversion.sql（例如，foo--1.0--1.1.sql包含把扩展foo的版本 1.0修改为版本 1.1的命令）。

在有合适更新脚本可用的前提下，ALTER EXTENSION UPDATE 命令会把已安装的扩展更新到指定的新版本。更新脚本运行在 CREATE EXTENSION 为安装脚本提供的同一环境中：尤其是，search_path 的设置方式完全相同，而且脚本创建的任何新对象都会自动加入扩展中。

如果扩展有次级控制文件，那么用于更新脚本的控制参数就是与该脚本目标（新）版本相关联的那些参数。

更新机制可以用于解决一个重要的特殊情况：将“松散”对象集合转换为扩展。在 PostgreSQL 于 9.1 加入扩展机制之前，许多人编写的扩展模块只是创建各种未打包的对象。对于包含这些对象的现有数据库，如何将它们转换为正确打包的扩展？删除它们再执行普通的 CREATE EXTENSION 是一种办法，但如果对象具有依赖关系（例如，某些表列使用扩展创建的数据类型），就不适合这样做。解决方法是先创建一个空扩展，再使用 ALTER EXTENSION ADD 将每个现有对象附加到扩展中，最后创建当前扩展版本中存在、而未打包版本中没有的新对象。CREATE EXTENSION 通过 FROM old_version 选项支持这种情况：它不运行目标版本的普通安装脚本，而是运行名为 extension--old_version--target_version.sql 的更新脚本。用作 old_version 的虚拟版本名由扩展作者选择，不过通常约定使用 unpackaged。如果需要将多个先前版本更新为扩展形式，应使用不同的虚拟版本名来标识它们。

ALTER EXTENSION 能够执行一系列更新脚本文件来完成请求的更新。例如，如果只有 foo--1.0--1.1.sql 和 foo--1.1--2.0.sql 可用，那么当当前安装的是 1.0，而请求更新到 2.0 时，ALTER EXTENSION 就会按顺序应用这两个脚本。

PostgreSQL 并不对版本名称的属性作任何假设：例如，它并不知道 1.1 是否跟在 1.0 之后。它只是匹配可用的版本名，并选择需要应用更新脚本最少的那条路径。（实际上，版本名可以是任何不包含 --，且不以 - 开头或结尾的字符串。）

有时提供“降级”脚本也是有用的，例如 foo--1.1--1.0.sql 可用于回退与 1.1 版相关的修改。如果你这样做，要注意某个降级脚本可能会因为产生更短的路径而意外被采用。危险情况是，存在一个跨越多个版本的“快速路径”更新脚本，同时又有一个可降级到该快速路径起点的脚本。这时，先降级再走快速路径，可能比按版本逐步前进所需的步数更少。如果降级脚本删除了任何不可替代的对象，就会产生不希望看到的结果。

要检查是否存在意外的更新路径，可使用以下命令：

SELECT * FROM pg_extension_update_paths('extension_name');

它会显示指定扩展的每一对不同已知版本名，以及从源版本到目标版本将采用的更新路径序列；如果没有可用的更新路径，则显示 NULL。路径会以文本形式显示，并使用 -- 作为分隔符。如果你更喜欢数组形式，可以使用 regexp_split_to_array(path,'--')。

下面给出一个纯 SQL 扩展的完整示例：一个双元素复合类型，它可以在两个槽位中存储任意类型的值，这两个槽位名为 “k” 和 “v”。非文本值会自动强制转换为文本后再存储。

脚本文件pair--1.0.sql如下所示：

-- complain if script is sourced in psql, rather than via CREATE EXTENSION
\echo Use "CREATE EXTENSION pair" to load this file. \quit

CREATE TYPE pair AS ( k text, v text );

CREATE OR REPLACE FUNCTION pair(anyelement, text)
RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair';

CREATE OR REPLACE FUNCTION pair(text, anyelement)
RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair';

CREATE OR REPLACE FUNCTION pair(anyelement, anyelement)
RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair';

CREATE OR REPLACE FUNCTION pair(text, text)
RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair;';

CREATE OPERATOR ~> (LEFTARG = text, RIGHTARG = anyelement, PROCEDURE = pair);
CREATE OPERATOR ~> (LEFTARG = anyelement, RIGHTARG = text, PROCEDURE = pair);
CREATE OPERATOR ~> (LEFTARG = anyelement, RIGHTARG = anyelement, PROCEDURE = pair);
CREATE OPERATOR ~> (LEFTARG = text, RIGHTARG = text, PROCEDURE = pair);

控制文件pair.control如下所示：

# pair extension
comment = 'A key/value pair data type'
default_version = '1.0'
relocatable = true

虽然你几乎不需要专门写一个 makefile 来把这两个文件安装到正确的目录中，但你也可以使用如下内容的 Makefile：

EXTENSION = pair
DATA = pair--1.0.sql

PG_CONFIG = pg_config
PGXS := $(shell $(PG_CONFIG) --pgxs)
include $(PGXS)

这个 makefile 依赖于 PGXS，其说明见第 35.16 节。执行 make install 命令会把控制文件和脚本文件安装到 pg_config 报告的正确目录中。

安装文件后，使用CREATE EXTENSION命令将这些对象装入某个具体数据库。