Skip to main content
Cloud SQL 是一项完全托管的关系型数据库服务,提供高性能、无缝集成以及出色的可扩展性,并支持 PostgreSQL 等数据库引擎。 本指南简要介绍如何使用 Cloud SQL for PostgreSQL 通过 PostgresVectorStore 类存储向量嵌入。

概述

集成详情

开始之前

要使用此包,您首先需要完成以下步骤:
  1. 选择或创建一个 Cloud Platform 项目。
  2. 为您的项目启用计费功能。
  3. 启用 Cloud SQL Admin API。
  4. 设置身份验证。
  5. 创建一个 CloudSQL 实例
  6. 创建一个 CloudSQL 数据库
  7. 向数据库添加用户

身份验证

使用 gcloud auth login 命令在本地对您的 Google Cloud 帐户进行身份验证。

设置您的 Google Cloud 项目

设置您的 Google Cloud 项目 ID,以便在本地利用 Google Cloud 资源:
如果您不知道您的项目 ID,请尝试以下操作:
  • 运行 gcloud config list
  • 运行 gcloud projects list
  • 查看支持页面:查找项目 ID

设置 PostgresVectorStore 实例

要使用 PostgresVectorStore 库,您需要安装 @langchain/google-cloud-sql-pg 包,然后按照以下步骤操作。 首先,您需要登录您的 Google Cloud 帐户,并根据您的 Google Cloud 项目设置以下环境变量;这些变量将根据您配置(fromInstance、fromEngine、fromEngineArgs)PostgresEngine 实例的方式进行定义:

设置实例

要实例化 PostgresVectorStore,您首先需要通过 PostgresEngine 创建一个数据库连接,然后初始化向量存储表,最后调用 .initialize() 方法来实例化向量存储。

管理向量存储

向向量存储添加文档

要向向量存储添加文档,您可以通过传递或不传递 ID 来实现

从向量存储中删除文档

您可以通过传递要删除的 ID 数组来从向量存储中删除一个或多个文档:

搜索文档

一旦您的向量存储创建完成并且相关文档已添加,您很可能希望在链或代理运行期间对其进行查询。

直接查询

执行简单的相似性搜索可以按如下方式进行:
如果您想执行相似性搜索并接收相应的分数,可以运行:

使用最大边际相关性搜索进行查询

最大边际相关性优化了与查询的相似性以及所选文档之间的多样性。