MySQL查询数据库中所有表名表结构及注释以及生成数据库文档

MySQL查询数据库中所有表名表结构及注释

生成数据库文档在后面！！！ 

select t.TABLE_COMMENT -- 数据表注释
, c.TABLE_NAME -- 表名称
, c.COLUMN_COMMENT -- 数据项
, c.COLUMN_NAME -- 英文名称
, '' -- 字段描述
, upper(c.DATA_TYPE) as DATA_TYPE -- 数据类型
, c.CHARACTER_MAXIMUM_LENGTH -- 数据长度
, '' -- 是否字典项
, '' -- 字典内容
, (case
when c.IS_NULLABLE = 'YES' then '是'
when c.IS_NULLABLE = 'NO' then '否'
else c.IS_NULLABLE
end) as IS_NULLABLE -- 是否为空
, (
case
when c.COLUMN_KEY = 'PRI' then '是'
when c.COLUMN_KEY is null or c.COLUMN_KEY = '' then '是'
else c.COLUMN_KEY
end
) as COLUMN_KEY-- 是否主键
, c.COLUMN_DEFAULT-- 默认值
from information_schema.COLUMNS c,
information_schema.TABLES t
where c.TABLE_NAME = t.TABLE_NAME
and c.TABLE_SCHEMA not in ('information_schema', 'sys', 'performance_schema', 'mysql')
order by t.TABLE_COMMENT
;

从information_schema.COLUMNS和information_schema.TABLES这两个系统视图中检索数据表及其列的详细信息。

1. 笛卡尔积：您的查询使用了逗号分隔的表名（information_schema.COLUMNS c, information_schema.TABLES t），这会导致两个表之间的笛卡尔积，除非您通过WHERE子句或其他方式明确指定连接条件。在您的例子中，您确实在WHERE子句中指定了c.TABLE_NAME = t.TABLE_NAME作为连接条件，但这仍然可能导致性能问题，因为不是标准的JOIN语法。
2. JOIN语法：建议使用显式的JOIN语法来连接表，因为它更清晰且更容易维护。
3. 表注释：t.TABLE_COMMENT可能是从TABLES视图中获取的，但是您没有确保TABLES视图中的TABLE_COMMENT是针对与COLUMNS中相同的TABLE_SCHEMA的。
4. 字段描述：您为“字段描述”预留了两个空字符串占位符，但您可能希望从某个地方获取实际的描述。
5. CASE表达式：您的CASE表达式用于确定IS_NULLABLE和COLUMN_KEY的值，但有一个潜在的问题：当COLUMN_KEY为NULL或空字符串时，您将其设置为'是'，这可能不是您想要的结果。通常，主键字段不会是'是'。

 简洁版：

SELECT   
    t.TABLE_COMMENT AS 数据表注释,  
    c.TABLE_NAME AS 表名称,  
    c.COLUMN_COMMENT AS 数据项,  
    c.COLUMN_NAME AS 英文名称,  
    '' AS 字段描述, -- 这里可以替换为实际的字段描述来源  
    UPPER(c.DATA_TYPE) AS DATA_TYPE,  
    c.CHARACTER_MAXIMUM_LENGTH AS 数据长度,  
    '' AS 是否字典项, -- 这里可以替换为实际的字典项来源  
    '' AS 字典内容, -- 这里可以替换为实际的字典内容来源  
    CASE   
        WHEN c.IS_NULLABLE = 'YES' THEN '是'  
        WHEN c.IS_NULLABLE = 'NO' THEN '否'  
        ELSE c.IS_NULLABLE  
    END AS IS_NULLABLE,  
    CASE   
        WHEN c.COLUMN_KEY = 'PRI' THEN '是'  
        WHEN c.COLUMN_KEY IN ('MUL', 'UNI') THEN '其他键' -- 例如：唯一键或多键  
        ELSE '否'  
    END AS COLUMN_KEY,  
    c.COLUMN_DEFAULT AS 默认值  
FROM   
    information_schema.COLUMNS c  
JOIN   
    information_schema.TABLES t ON c.TABLE_NAME = t.TABLE_NAME AND c.TABLE_SCHEMA = t.TABLE_SCHEMA  
WHERE   
    c.TABLE_SCHEMA NOT IN ('information_schema', 'sys', 'performance_schema', 'mysql')  
ORDER BY   
    t.TABLE_COMMENT;

生成数据库文档！！！
screw: 简洁好用的数据库表结构文档工具，支持MySQL/MariaDB/SqlServer/Oracle/PostgreSQL/TIDB/CacheDB 数据库。 - Gitee.com

使用方法：
1、在pom文件中添加插件

<build>
      
            <plugin>
                <groupId>cn.smallbun.screw</groupId>
                <artifactId>screw-maven-plugin</artifactId>
                <version>1.0.4</version>
                <dependencies>
                    <!-- HikariCP -->
                    <dependency>
                        <groupId>com.zaxxer</groupId>
                        <artifactId>HikariCP</artifactId>
                        <version>3.4.5</version>
                    </dependency>
                    <!--mysql driver-->
                    <dependency>
                        <groupId>mysql</groupId>
                        <artifactId>mysql-connector-java</artifactId>
                        <version>8.0.20</version>
                    </dependency>
                </dependencies>
                <configuration>
                    <!--username-->
                    <username>root</username>
                    <!--password-->
                    <password>#n4rj</password>
                    <!--driver-->
                    <driverClassName>com.mysql.cj.jdbc.Driver</driverClassName>
                    <!--jdbc url-->
                    <jdbcUrl>jdbc:mysql://1.1.1.1:3456/tlink_sdgf</jdbcUrl>
                    <!--生成文件类型、HTML-->
                    <fileType>WORD</fileType>
                    <!--打开文件输出目录-->
                    <openOutputDir>false</openOutputDir>
                    <!--生成模板-->
                    <produceType>freemarker</produceType>
                    <!--文档名称 为空时:将采用[数据库名称-描述-版本号]作为文档名称-->
                    <fileName>测试文档名称</fileName>
                    <!--描述-->
                    <description>数据库文档生成</description>
                    <!--版本-->
                    <version>${project.version}</version>
                    <!--标题-->
                    <title>数据库文档</title>
                </configuration>
                <executions>
                    <execution>
                        <phase>compile</phase>
                        <goals>
                            <goal>run</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

 2、点开maven找到该pom文件下面的插件双击run

3、成功之后在该pom文件的模块下面生成了一个doc文件夹下面就是生成的文档