跳到主要内容

SQL 窗口(VectorDB)

本文介绍如何使用 SQL 窗口管理百度云向量数据库 VectorDB。

背景信息

随着 AI 应用的普及,云向量数据库 VectorDB 成为处理高维向量数据(如图像、文本嵌入)的核心基础设施。由于传统数据库管理工具对向量数据库的操作支持不足,且缺乏统一的可视化管理界面,因此一款专门针对向量数据库的数据管理工具就显得尤为重要。

NineData 作为新一代云原生数据管理平台,针对 VectorDB 的以下痛点提供解决方案:

  • 操作复杂:需通过 CLI 或 SDK 执行向量操作
  • 可视化缺失:无法直观查看集合/索引结构
  • 权限分散:用户、角色权限管理依赖外部系统
  • 开发低效:需手动编写 JSON 参数,调试耗时 

功能介绍

针对 VectorDB 数据库,NineData 的 SQL 窗口覆盖从元数据管理到高阶向量操作的全流程能力。

功能
说明
可视化库表对象管理支持以可视化树的方式访问、查看、管理 VectorDB 的库、表、列、索引等对象。
一键生成请求体官方实时同步的 VectorDB 操作接口,支持表管理、索引管理、数据更新、数据查询、角色管理、用户管理等 35 个操作。选中即自动在编辑器中生成对应操作的 JSON 请求体样例。
编辑器提供编辑器,在选择了预置的各种 VectorDB 操作接口后,根据需求调整请求体并执行操作。
工作现场恢复对于浏览器意外退出或突发宕机等场景,您只需要重新登录 NineData 控制台并打开 SQL 窗口,之前打开的数据源以及执行过的命令会被自动加载。由于页面状态保存在云端,不受浏览器或主机的限制,您可以随时随地恢复工作现场。

前提条件

  • 已将目标需要管理的数据库添加到 NineData。如何添加,请参见管理数据源

  • 在组织模式()下,您必须拥有目标数据源的只读、DML 或 DDL 权限。

    提示

    只读权限仅支持查询操作。

  • 在商业化版本下(),请确保您的包年包月订阅未过期,否则将无法正常使用数据库 DevOps 服务。您可以在 NineData 控制台页面右上方快速查看剩余配额以及到期时间。check_quota

操作步骤

  1. 登录 NineData 控制台

  2. 在左侧导航栏单击 >

    提示

    如果之前登录过数据源且没有关闭,则会自动进入该数据源页面。

  3. 单击 下方文本框,会弹出可用的数据源,单击目标数据源,并单击,跳转到 SQL 窗口。

    提示
    • 如果您之前没有创建过数据源,则会显示空白页。此时,请单击页面中的
    • 如果有多个数据源,您可以在框中输入全部或部分关键词进行精确查找或模糊查找。支持搜索的字段如下:

      • 数据源名称

      • IP 地址

      search_vdb

  4. 打开 SQL 窗口后,即可对数据源执行数据开发操作。SQL 窗口的详细使用方法,请参见界面说明

界面说明

vdb_interface

序号
功能
介绍
1SQL 窗口页签表示当前已打开的数据源 SQL 窗口,多个 SQL 窗口可以通过单击页签切换,单击页签右侧的X可以关闭该 SQL 窗口;双击页签可以更改页签的名称;拖动页签可以调整页签的位置。右键菜单支持如下操作:
  • :打开当前数据源详情窗口。
  • :更改当前标签的名称。
  • :打开一个当前数据源的 SQL 窗口。
  • :打开一个新的数据源 SQL 窗口。
  • :关闭当前 SQL 窗口。
  • :关闭除了当前 SQL 窗口以外的所有其他 SQL 窗口。
  • :关闭位于当前 SQL 窗口左侧的所有 SQL 窗口。
  • :关闭位于当前 SQL 窗口右侧的所有 SQL 窗口。
  • :关闭所有 SQL 窗口。
2打开数据源选择并打开新的数据源 SQL 窗口。
3数据源信息展示当前 SQL 窗口的数据源信息,包含环境、IP 地址以及端口号。
右键菜单:
  • :显示当前数据源的详情信息,包含用户名、连接地址等。
  • :打开一个当前数据源的 SQL 窗口。
  • :刷新数据源信息。
4收藏|刷新
  • 收藏:单击收藏图标可以将当前数据源添加到中,添加后可以在新建 SQL 窗口中快速选择。
  • 刷新:可刷新当前数据源中的数据。
5数据库名称选中目标数据库以执行 SQL 操作。
6API 操作请求针对 VectorDB 的管理操作,此处选择的所有操作最终将转换为对 VectorDB 原生 API 的标准调用。选择后系统将自动在编辑器中生成 JSON 格式的请求体样例,您可直接在样例上进行调整。支持的操作如下:
7功能按钮
  • execute 执行选中的 VectorDB 操作。
  • :百度云向量数据库 VectorDB 的官方文档链接。
  • expend 将 SQL 窗口以全屏方式显示(浏览器大小)。全屏后,单击右上角的compress 可以恢复到原始 SQL 窗口大小。
8对象树以树的形式展示当前 VectorDB 中的所有库、表、列、非表对象。您可以做如下操作:
  • :VectorDB 中没有任何库的情况下,单击页面中的的按钮;VectorDB 中已有数据库的情况下,右键单击任意数据库名称,单击。在弹出窗口中输入,然后单击
  • :右键单击目标数据库名称,单击,然后在确认窗口中单击
  • :右键单击目标表名,单击,查看表的详细信息,包含 Desc(表结构描述)、Alias(表别名信息)、Stats(表统计信息)。
    • Desc:描述表的完整元数据信息,包含字段定义、索引配置、分区策略等核心属性。
    • Alias:表的别名映射关系,用于实现逻辑表名与物理表名的解耦。
    • Stats:表的实时统计指标,用于监控与性能分析。
  • :右键单击任意对象,单击,可以为当前数据源新开一个 SQL 窗口页签。
  • :右键单击任意对象,单击,刷新索引列表。
9编辑器窗口执行 VectorDB 操作的窗口,该窗口支持如下功能:
  • 执行 VectorDB 操作:便捷选择操作类型,即可生成 JSON 格式的请求体样例,支持直接在样例上进行调整。
  • 语法高亮
  • 右键菜单:
    • :执行光标所在位置的 VectorDB 操作。
    • 常规操作:包括
    • :选中光标所在位置的命令。
10执行信息、结果集显示命令的执行信息以及结果集。
  • 执行信息:包含执行时间、执行耗时、执行的命令、执行详情等信息。
  • 结果集:显示命令的返回结果,以 JSON 格式显示。将鼠标悬浮在目标结果集的页签上,将显示该结果集对应的命令。