库表管理

1.1 版本

1.2 应用场景

1）SQL 调试：数据开发过程中，数据开发人员常常需要编写和调试 SQL ，目前在 FDL 中不能预览 SQL 执行结果，用户往往在第三方数据库管理工具或数据库中执行 SQL 确认无误后，再复制到 FDL 中，数据开发过程涉及多个工具参与，不够方便便捷。

2）查看数据处理效果：FDL 中数据经过处理后，没有一个专门的入口查看处理效果是否符合预期，用户只能通过参数赋值、数据同步等取数类节点或者第三方数据库管理工具查询数据。

1.3 功能简介

「库表管理」功能简介：

• 对于支持 SQL 语句的数据库，支持用户写 SQL 进行查询、修改表。

• 可查看表数据、表结构、修改表名称/描述、清空表、删除表、复制表等。

使用「库表管理」功能，需要同时满足下面两个条件：

• 4.1.9.2 及之后版本，注册「库表管理」功能点，详情请参见：功能点限制

• 有「库表管理」功能的使用权限，详情请参见：数据平台使用权限

1）独立部署工程中，在「数据管理」中使用「库表管理」功能。如下图所示：

2）集成部署工程

• 4.1.9.2 之前版本：
  

• 4.1.9.2 及之后版本，暂时隐藏库表管理功能。

注：暂不支持查看存储过程和函数等数据库内的对象。

用户选择已配置且有使用权限的数据连接，可查看该数据连接下面的 「库/模式」和「表/视图」，支持搜索库/表/视图，写 SQL 语句进行查询和调试等。如下图所示：

4.1 数据源&数据连接

「库表管理」功能支持的数据源请参见：库表管理支持的数据源

选择已配置且有使用权限的数据连接，可对该数据连接下的表进行操作

4.2 搜索&刷新按钮说明

4.3 查看表数据&表结构&源SQL

1）选择某张表/视图，可查看表数据和表结构，可同时打开多张表。如下图所示：

注：4.1.9.2 及之后版本，支持设定每页的条数、支持分页查看数据。

2）4.1.9.2 及之后版本，支持查看构建视图的源 SQL 。如下图所示：

说明如下：

• 仅支持查看源 SQL，暂不支持编辑修改源 SQL 的操作。

• 视图建表语句里，仅展示查询语句，除查询语句以外的高级特性暂不展示。未展示的高级特性：比如算法、定义者、SQL安全性、检查选项等。

• 支持该查看源 SQL 的数据库：MySQL、Oracle、SQLServer、Postgresql、SQLite、TiDB、达梦、KingBase、Gaussdb、Greenplum、Doris、Starrocks、Gbase8a、YMatrix、PolarDB PostgreSQL
  

4.4 更多操作按钮说明

1）操作对象为表时，点击「更多操作」按钮，可修改表名称和描述、清空表、删除表、复制表、生成SQL等。如下图所示：

• 表名称：可包含英文、中文、数字、下划线，不限字数。

• 复制表：可跨库复制。

• 生成SQL：支持生成多种操作语句：SELECT、INSERT、UPDATE、MERGE、INSERT ON CONFLICT、UPDATE FROM、DELETE USING、DDL，生成的操作语句支持复制。
  

2）操作对象为视图时，点击「更多操作」按钮，可修改视图名称和描述、删除视图、复制视图、生成SQL。如下图所示：

• 视图名称：可包含英文、中文、数字、下划线，不限字数。

• 复制视图：支持复制视图的数据库：MySQL、Oracle、SQLServer、Postgresql、SQLite、TiDB、达梦、KingBase、Gaussdb、Greenplum、Doris、Starrocks、Gbase8a、YMatrix、PolarDB PostgreSQL；视图仅支持复制到当前的数据库/模式下，不支持跨数据库/模式复制。

• 生成SQL：支持生成多种操作语句：SELECT、INSERT、UPDATE、MERGE、INSERT ON CONFLICT、UPDATE FROM、DELETE USING、DDL，生成的操作语句支持复制。

4.5 已存SQL文件&新建SQL编辑器介绍

1）支持在选择的数据连接下写 SQL 语句，做查询和测试，便于调试 SQL 。如下图所示：

• 如果是 select 查询语句，SQL 语句中只能包含一个 select 。

• SQL 语句中不支持使用参数。

• 针对 SQL 语句，只保留最近一次执行的日志。

• 4.1.9.2 及之后版本，点击SQL文件名称右侧的编辑按钮，可修改SQL文件名称。

2）点击右上角「保存」按钮，可将 SQL 语句保存到「已存SQL文件」中，便于后续再次使用。如下图所示：