本指南解释了如何在现有的 PostgreSQL 数据库中安装 pg_search 扩展。这些说明适用于在 Linux Debian/Ubuntu 上部署。如果您使用的是 Linux 的不同版本，请联系我们。

先决条件

首先，确保您对 Postgres 数据库具有超级用户访问权限。

接下来，安装 libicu。

  1. # Ubuntu 20.04 或 22.04
  2. sudo apt-get install -y libicu70
  4. # Ubuntu 24.04
  5. sudo apt-get install -y libicu74

安装 pg_search

ParadeDB 为 Debian 11、Debian 12、Ubuntu 22.04 和 Red Hat Enterprise Linux 9 提供了预构建的 pg_search 扩展二进制文件，适用于 Postgres 14、15 和 16，支持 amd64 (x86_64) 和 arm64。它们可以在 GitHub Releases 中找到。如果您使用的是不同版本的 Postgres 或不同的操作系统，您将需要从源代码构建扩展。

使用预构建的二进制文件

  1. # 示例适用于 Ubuntu 22.04，别忘了替换为您系统的 OS、arch 和 Postgres
  2. curl -L "https://github.com/paradedb/paradedb/releases/download/v0.7.6/pg_search-v0.7.6-ubuntu-22.04-amd64-pg16.deb"  -o /tmp/pg_search.deb
  3. sudo apt-get install -y /tmp/*.deb

注意：您可以将 v0.7.6 替换为您希望安装的 pg_search 版本，并将 pg16 替换为您正在使用的 Postgres 版本。

从源代码构建

请遵循这些说明。

更新 postgresql.conf

接下来，在 postgresql.conf 中的 shared_preload_libraries 添加 pg_search。

  1. shared_preload_libraries = 'pg_search'

重新加载您的 PostgreSQL 服务器，使这些更改生效。

加载扩展

一旦扩展二进制文件安装在您的系统上，通过您选择的客户端（例如 psql）连接到您的 Postgres 数据库，并运行以下命令：

  1. CREATE EXTENSION pg_search;

就是这样！您现在可以在数据库中使用 pg_search 了。要开始使用，我们建议您遵循快速入门指南。

pg_search 可以与 pgvector 结合使用进行混合搜索。您可以在这里找到安装 pgvector 的说明。