连接到外部 PostgreSQL 数据库

LangSmith 使用 PostgreSQL 数据库作为事务性工作负载和运营数据（除“运行记录”外的几乎所有数据）的主要数据存储。默认情况下，LangSmith 自托管版本将使用内置的 PostgreSQL 数据库。 然而，您可以将 LangSmith 配置为使用外部 PostgreSQL 数据库（在生产环境中强烈推荐）。通过配置外部 PostgreSQL 数据库，您可以更轻松地管理数据库的备份、扩展及其他运维任务。

要求

• 一个已配置的 PostgreSQL 数据库，您的 LangSmith 实例将能够通过网络访问该数据库。我们建议使用托管式 PostgreSQL 服务，例如：
  • Amazon关系数据库服务
  • Google Cloud SQL
  • Azure 用于 PostgreSQL 的数据库
• 注意：我们仅正式支持 PostgreSQL 14 及更高版本。
• 拥有 PostgreSQL 数据库管理员访问权限的用户。该用户将用于创建必要的数据表、索引和数据库模式。
• 该用户还需具备在数据库中创建扩展的能力。我们将使用/尝试安装 btree_gin、btree_gist、pgcrypto、citext 和 pg_trgm 扩展。
• 如果使用非 public 的模式，请确保没有其他模式启用了相关扩展，否则必须将该模式包含在您的搜索路径中。
• 默认情况下，我们建议至少配备 2 个 vCPU 和 8GB 内存的实例。然而，实际需求将取决于您的工作负载以及用户数量。我们建议持续监控您的 Postgres 实例，并根据需要进行扩容。

连接字符串

您需要提供一个连接字符串来连接您的 PostgreSQL 数据库。该连接字符串应包含以下信息：

• 主机
• 端口
• 数据库
• 用户名
• 密码（如果包含任何特殊字符，请确保对其进行 URL 编码）
• URL 参数

这将表现为：

username:password@host:port/database?<url_params>

一个示例连接字符串可能如下所示：

myuser:mypassword@myhost:5432/mydatabase?sslmode=disable

不带 URL 参数时，连接字符串如下所示：

myuser:mypassword@myhost:5432/mydatabase

配置

获取连接字符串后，您可以将 LangSmith 实例配置为使用外部 PostgreSQL 数据库。您可以通过修改 LangSmith Helm Chart 安装的 values 文件，或 Docker 安装的 .env 文件来实现此配置。

Helm

postgres:
  external:
    enabled: true
    connectionUrl: "Your connection url"

Docker

# In your .env file
POSTGRES_DATABASE_URI="Your connection url"

配置完成后，您应该能够重新安装 LangSmith 实例。如果所有配置均正确，您的 LangSmith 实例现在应已使用外部 Postgres 数据库。