文档 / IDE

数据库

支持 Oracle、SQL Server、MySQL、MariaDB、MongoDB 和 SQLite 的数据库客户端，提供 SQL 与 PL/SQL 控制台、执行计划以及代码 ↔ 数据库导航。

Yuli 内置数据库客户端。从左侧边栏点击 数据库 按钮（Alt+Shift+D）即可打开。

支持的引擎

引擎 要求
Oracle PATH 中有 Oracle Instant Client 19c 或更高版本（Basic 或 Basic Light）。
SQL Server 无额外要求。
MySQL 无额外要求。
MariaDB 无额外要求。
MongoDB 无额外要求。
SQLite 无额外要求。

目前暂不支持 PostgreSQL。

如果缺少 Oracle Instant Client，Yuli 会显示 “连接 Oracle 需要安装 Oracle Instant Client”，并给出适用于你系统的安装步骤。

创建连接

  1. 在 数据库 面板中，点击 新建连接。
  2. 选择引擎并填写服务器信息。
  3. 指定一个 环境（例如开发或测试）。
  4. 如果不希望允许写入，勾选 只读。
  5. 设置 智能体访问。参见安全的数据库访问。
  6. 点击 测试连接 并保存。

密码保存在系统密钥链中，绝不会存入项目。对于使用自有证书的内部服务器，请勾选 信任服务器证书。

模式浏览器

  • 表、视图、包、函数、存储过程和触发器。
  • 包、视图、函数和触发器的源代码。
  • PL/SQL 依赖关系及其流程。
  • 表的 ER 图。

SQL 与 PL/SQL 控制台

通过 工具 → 新建 SQL 查询（Ctrl+Alt+Q）打开控制台。

  • 基于真实模式的自动补全。
  • PL/SQL 块。
  • 树形展示的 执行计划，附带警告。
  • 完整结果可导出为 CSV 或 Excel。

控制台默认限制为 500 行，最多可扩展至 100,000 行。

代码 ↔ 数据库

  • Ctrl+Alt+J 从代码跳转到数据库对象：函数、包或表。
  • 图表中的 代码 ↔ 数据库 图显示哪些 DAO 和仓库调用了哪些函数、包和表。
  • 在 Hibernate 映射中，Yuli 会根据连接校验表和列。

调试 PL/SQL

Yuli 使用 DBMS_DEBUG 调试 Oracle 的 PL/SQL 代码。需要 DEBUG CONNECT SESSION 权限，且对象需使用 COMPILE DEBUG 编译。参见运行与调试。

迁移

迁移 按钮用于管理项目的迁移脚本。对智能体而言，迁移和 .sql 文件会提高风险级别，并需要确认。

与智能体协作

智能体始终通过 Yuli 的工具使用数据库，绝不使用命令行客户端：

工具 作用 要求
yuli_db_schema 读取模式和源代码。 仅查询
yuli_db_query 执行带行数限制的 SELECT。 仅查询
yuli_db_execute 执行写入语句。 超级权限并经你批准

你可以这样提问：

  • “为什么这个函数在这些参数下返回 NULL？”
  • “告诉我存储过程 PKG_ORDERS.CLOSE 会写入什么。”
  • “让实体 Order 与表的真实列保持一致。”