跳到主要内容

SQL 窗口（VectorDB）

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

背景信息​

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

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

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

功能介绍​

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

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

前提条件​

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

  • 在组织模式（数据库 DevOps 企业版）下，您必须拥有目标数据源的只读、DML 或 DDL 权限。

    提示

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

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

操作步骤​

  1. 登录 NineData 控制台。

  2. 在左侧导航栏单击 数据库 DevOps>SQL 窗口。

    提示

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

  3. 单击 SQL 窗口下方文本框，会弹出可用的数据源，单击目标数据源，并单击开始查询，跳转到 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 文档中心：百度云向量数据库 VectorDB 的官方文档链接。
  • expend：全屏 将 SQL 窗口以全屏方式显示（浏览器大小)。全屏后，单击右上角的compress 退出全屏可以恢复到原始 SQL 窗口大小。
8对象树以树的形式展示当前 VectorDB 中的所有库、表、列、非表对象。您可以做如下操作：
  • 创建数据库：VectorDB 中没有任何库的情况下，单击页面中的创建数据库的按钮；VectorDB 中已有数据库的情况下，右键单击任意数据库名称，单击创建数据库。在弹出窗口中输入库名称，然后单击确定。
  • 删除数据库：右键单击目标数据库名称，单击删除数据库，然后在确认窗口中单击确定。
  • 表详情：右键单击目标表名，单击表详情，查看表的详细信息，包含 Desc（表结构描述）、Alias（表别名信息）、Stats（表统计信息）。
    • Desc：描述表的完整元数据信息，包含字段定义、索引配置、分区策略等核心属性。
    • Alias：表的别名映射关系，用于实现逻辑表名与物理表名的解耦。
    • Stats：表的实时统计指标，用于监控与性能分析。
  • 复制查询：右键单击任意对象，单击复制查询，可以为当前数据源新开一个 SQL 窗口页签。
  • 刷新：右键单击任意对象，单击刷新，刷新索引列表。
9编辑器窗口执行 VectorDB 操作的窗口，该窗口支持如下功能：
  • 执行 VectorDB 操作：便捷选择操作类型，即可生成 JSON 格式的请求体样例，支持直接在样例上进行调整。
  • 语法高亮
  • 右键菜单：
    • 执行：执行光标所在位置的 VectorDB 操作。
    • 常规操作：包括剪切、复制、粘贴和全选。
    • 选中当前 SQL：选中光标所在位置的命令。
10执行信息、结果集显示命令的执行信息以及结果集。
  • 执行信息：包含执行时间、执行耗时、执行的命令、执行详情等信息。
  • 结果集：显示命令的返回结果，以 JSON 格式显示。将鼠标悬浮在目标结果集的页签上，将显示该结果集对应的命令。