集成数据库能力

本文将帮助你快速上手扣子编程内置的数据库服务，包括数据库服务的基础介绍，以及在 AI 编程项目中开通数据库、使用数据库等指引。

功能概述

扣子编程内置的数据库服务是专为 AI 编程项目设计的结构化数据托管方案，基于 PostgreSQL 引擎提供开箱即用的数据库能力，无需关注底层部署与运维工作。
在开发 AI 编程项目过程中，你可以通过自然语言与扣子 AI 对话，让其为你开发的 AI 编程项目开通数据库功能，也可以在可视化界面中手动配置。开通后，扣子 AI 会自动创建并连接到对应的 PostgreSQL 数据库，你可以在扣子编程的 AI 编程环境中直接操作数据库。
核心功能特性如下：

• 多样化的交互方式：支持通过自然语言对话、符合 PostgreSQL 方言的 SQL 语句和可视化界面三种操作方式，满足不同场景和用户习惯。
• 多层环境隔离：
  • 环境隔离：开发数据库与生产数据库物理独立，确保开发阶段的数据操作不影响线上业务数据。
  • 项目隔离：不同 AI 编程项目的数据库相互独立，数据访问权限隔离，保障数据安全。
• 自动备份与恢复：支持秒级自动备份，可在指定的回溯范围内按需选择时间点恢复数据库。
• 安全访问机制：数据库连接凭据（如地址、端口、用户名、密码）通过环境变量统一管理，提升访问安全性。
• 向量化写入与检索：知识库场景。支持集成向量处理能力，通过调用向量模型将文本转换为高维数值向量并存储。在检索时，通过计算语义相似度，返回更匹配的检索结果。更多信息，请参考数据向量化写入与检索。

开发与生产环境

扣子编程提供两类独立的数据库环境：开发数据库和生产数据库。两者采用完全相同的 PostgreSQL 数据库引擎，以确保环境一致性，但它们在物理上是完全隔离的，各自拥有独立的数据、表结构和配置。

支持的数据类型

扣子编程的 PostgreSQL 数据库支持如下数据类型。

权限说明

仅 AI 编程项目的所有者具备对应数据库的操作权限。

使用限制

每个项目均只提供一个开发环境数据库和一个生产环境数据库。

费用说明

• 在项目开发过程中，你与扣子 AI 的每轮对话均会产生扣子编程任务费用，更多信息，请参加扣子编程任务费用。
• 目前免收存储、数据库、向量模型的内置集成费用，后续正式计费的时间计划与产品定价请关注平台公告。

使用数据库

为项目接入数据库能力

你在开发 AI 编程项目时，可以与扣子 AI 对话为项目接入数据库能力。

1. 登录扣子编程。

2. 在页面顶部选择目标工作空间，然后在左侧导航栏中单击新建项目。

3. 按需输入你的开发需求，包括为项目接入数据库服务。
   例如输入：

   开发一个英语单词学习智能体，并为 Agent 添加一个数据库，用于存储已学习的单词
   

   
   为项目接入数据库能力后，你可以像聊天一样，通过自然语言指令直接对数据库进行操作。例如：

   • 创建数据表：

     创建产品表，包含产品ID、名称、价格和库存字段
     

   • 插入数据：

     帮我插入一条新的产品记录，名称是“智能耳机”，价格是 799
     

可视化界面操作数据库

为项目接入数据库能力后，你也可以像操作电子表格一样管理表数据，避免 SQL 语法错误。

1. 在 AI 编程开发界面的右上角，单击➕，然后在集成服务区域，单击数据库。
2. 在表管理中，操作数据表。
   你可以执行增加、删除、修改或查询数据表，增加、删除、修改或查询数据等操作。
   

执行 SQL 语句

如果你熟悉 SQL 语句，可直接在 SQL 编辑器中输入 SQL 语句进行操作。

1. 在 AI 编程开发界面的右上角，单击➕，然后在集成服务区域，单击数据库。
2. 在开发数据库的 SQL查询页签中，执行 SQL 语句。
   例如输入如下语句，并单击运行。
   

   CREATE TABLE users (
       -- 1. 自增主键：唯一标识用户，BIGINT 适配海量用户场景
       user_id BIGSERIAL PRIMARY KEY,
       -- 2. 用户名：非空，唯一，VARCHAR(50) 限定长度
       username VARCHAR(50) NOT NULL UNIQUE,
       -- 3. 密码：非空，建议实际存储加密后的密文，VARCHAR(255) 适配加密串长度
       password VARCHAR(255) NOT NULL,
       -- 4. 手机号：唯一，可选填，用于登录/验证
       phone VARCHAR(20) UNIQUE,
       -- 5. 邮箱：唯一，可选填，用于登录/找回密码
       email VARCHAR(100) UNIQUE,
       -- 6. 用户状态：小整数，1-正常，0-禁用，默认正常
       status SMALLINT DEFAULT 1 CHECK (status IN (0, 1)),
       -- 7. 创建时间：自动记录用户注册时间，带时区
       created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
       -- 8. 更新时间：自动记录信息修改时间，带时区
       updated_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
   );
   

数据库备份与恢复

扣子编程的数据库服务提供备份与恢复机制，确保数据安全。你可以按需设置可追溯时间，在恢复数据库时，选择恢复到可追溯时间范围内的数据库。

备份与恢复机制

• 扣子编程的数据库服务，支持秒级自动备份。
• 恢复数据库时，仅支持恢复到指定可追溯时间范围内的数据库。
• 回滚 AI 编程项目时，也可同步回滚、恢复数据库。
• 数据库恢复时，无法进行数据导入、修改等操作，请稍后再试。
• 恢复操作不可撤销，当前数据将被所需的备份数据替换。为最大程度地减少数据丢失，请选择最接近所需恢复点的有效时间点。
  如果需要重新恢复到稍后的状态，请在可追溯时间范围内选择较晚的时间戳再次运行恢复操作。

操作步骤

1. 在 AI 编程环境的右上角，单击➕，然后在集成服务区域，单击数据库。
2. 设置可溯回的时间。
   在总览页签的数据恢复区域，设置可溯回的时间，单击保存。
   
3. 恢复数据库。
   在数据恢复至指定时间区域，选择恢复的时间点，单击恢复。
   

管理数据库

下述表格罗列了数据库的相关操作。

参考信息：设置级联删除

在创建数据表时，可以添加外键关系，并通过如果引用的行删除时的操作配置，来实现级联删除。即指定父表行删除时对子表关联行的处理规则，选项如下：
Cascade：从父表中删除一行时，将进行级联删除，即子表中所有相关的行也会被删除。
Restrict：从父表中删除一行时，如果子表中存在任何相关行，则删除操作将被中止。
Set NULL：当从父表中删除一行时，子表中外键列的值将被设置为 NULL。
Set default：当从父表中删除一行时，子表中外键列的值将设置为其默认值。
No action：当从父表中删除一行时，如果子表中存在任何相关行，将引发报错。

常见问题

• 如何为项目接入数据库能力？
• 各个项目之间的数据库是共享的吗？
• 首次部署和二次部署的数据库同步策略有什么不同？
• 回滚项目版本对数据库有什么影响？
• 如何设置级联删除？