文档 v3.7.0 版本已不再积极维护，你当前浏览的是一份归档快照。最新文档请参阅最新版本。

快速开始

安装、加载、创建、更新 PostgreSQL 扩展

Pigsty 为 14 个主流 Linux 发行版提供了无与伦比的 437 扩展。

概述

交付扩展需要 4 个步骤：下载、安装、配置和创建：

步骤 1

    [**下载**](#download-extension)：要下载哪些扩展包

    ```yaml tab="config" title="定义要下载的扩展"
    repo_extra_packages: [ postgis, timescaledb, vector ]
    ```
    ```bash tab="apply" title="下载包"
    make repo
    ```

步骤 2

    [**安装**](#install-extension)：要安装哪些扩展

    ```yaml tab="config"
    pg_extensions: [ postgis, pgvector, timescaledb ]
    ```
    ```bash tab="apply"
    ./pgsql.yml -t pg_ext     # 安装扩展
    ```

步骤 3

    [**加载**](#load-extension)：要预加载哪些扩展

    ```yaml tab="config"
    pg_libs: 'timescaledb, pg_stat_statements, auto_explain'  # 将扩展添加到预加载库（并非所有扩展都需要此操作）
    ```
    ```bash tab="apply" title="编辑现有集群配置并重新加载"
    pg edit-config --force -p shared_preload_libraries='timescaledb, pg_stat_statements, auto_explain'
    ```

步骤 4

    [**创建**](#create-extension)：在[数据库](/zh/docs/pgsql/db)中创建扩展

    ```yaml tab="config"
    pg_databases:
    - { name: meta ,extensions: [ postgis, timescaledb, vector ] }
    ```
    ```sql tab="apply" title="在现有数据库中创建扩展"
    CREATE EXTENSION postgis CASCADE;
    ```

快速开始

您可以在配置清单中描述扩展，Pigsty 将为您下载、安装、配置和启用扩展。此示例使 postgis、pgvector、timescaledb 开箱即用：

all:
  children:
    pg-meta:
      hosts: {10.10.10.10: { pg_seq: 1, pg_role: primary }}
      vars:
        pg_cluster: pg-meta
        pg_databases: {name: meta, extensions: [ postgis, vector ]} # 创建（在数据库中）
        pg_extensions: [ postgis, pgvector ]                        # 安装（在集群中）
  vars:
    repo_extra_packages: [ postgis, timescaledb, vector ]           # 下载（全局）

当您初始化此 PG 集群时，这些扩展将在 pg-meta 集群中为您提供。

这里是一个更复杂的示例：启动 Postgres 并带有自托管 supabase 所需的扩展：

all:
  children:
    pg-meta:
      hosts: { 10.10.10.10: { pg_seq: 1, pg_role: primary } }
      vars:
        pg_cluster: pg-meta
        pg_databases:
          - name: postgres
            baseline: supabase.sql
            schemas: [ extensions ,auth ,realtime ,storage ,graphql_public ,supabase_functions ,_analytics ,_realtime ]
            extensions:                                 # 在 postgres 数据库中启用的扩展
              - { name: pgcrypto  ,schema: extensions } # 加密函数
              - { name: pg_net    ,schema: extensions } # 异步 HTTP
              - { name: pgjwt     ,schema: extensions } # PostgreSQL 的 JSON Web Token API
              - { name: uuid-ossp ,schema: extensions } # 生成通用唯一标识符 (UUIDs)
              - { name: pgsodium        }               # PostgreSQL 的现代密码学
              - { name: supabase_vault  }               # Supabase Vault 扩展
              - { name: pg_graphql      }               # GraphQL 支持
              - { name: pg_jsonschema   }               # JSON 模式验证
              - { name: wrappers        }               # 外部数据包装器集合
              - { name: http            }               # 数据库内网页检索
              - { name: pg_cron         }               # PostgreSQL 的作业调度器
              - { name: timescaledb     }               # 时间序列数据支持
              - { name: pg_tle          }               # PostgreSQL 的可信语言扩展
              - { name: vector          }               # 向量相似性搜索
              - { name: pgmq            }               # 轻量级消息队列
        # supabase 加载所需扩展
        pg_libs: 'timescaledb, plpgsql, plpgsql_check, pg_cron, pg_net, pg_stat_statements, auto_explain, pg_tle, plan_filter'
        pg_parameters:
          cron.database_name: postgres
          pgsodium.enable_event_trigger: off
  vars:
    pg_version: 17
    repo_extra_packages: [pg17-core ,pg17-time ,pg17-gis ,pg17-rag ,pg17-fts ,pg17-olap ,pg17-feat ,pg17-lang ,pg17-type ,pg17-util ,pg17-func ,pg17-admin ,pg17-stat ,pg17-sec ,pg17-fdw ,pg17-sim ,pg17-etl ]
    pg_extensions:                  [pg17-time ,pg17-gis ,pg17-rag ,pg17-fts ,pg17-feat ,pg17-lang ,pg17-type ,pg17-util ,pg17-func ,pg17-admin ,pg17-stat ,pg17-sec ,pg17-fdw ,pg17-sim ,pg17-etl ] #,pg17-olap]

下载并安装了 PG 17 的所有可用扩展，并加载和启用了所需的扩展。