Convert SQL to E-R Diagram

https://blog.sqlflow.cn/gudu-sqlflow-er-diagram/
Gudu SQLFlow is capable to convert SQL to Entity-Relation(ER) Diagram as well as to visualize the relations between tables and fields so that you can quickly understand the design model of the database and conduct efficient team communication.

Two Sources of Visualization ER Model

  • From SQL Script
    SQLFlow can analyze Database creation SQL script and visualize the provided scripts. In order to create ER diagram, user need to provide SQL statements such as create table or alter table and include foreign keys.
  • From Database
    You can simply make SQLFlow connect to your database for the ER diagram. SQLFlow will automatically retrieve metadata from the database and generate the ER diagram.
Hint: The feature is only available in Simple Job. E-R Diagram visualization is currently not supported in Regular Job.

Three Ways to Visualize ER Model

Let's now take a look on how exactly to use Gudu SQLFlow.
Gudu SQLFlow provides three ways:

1. Paste SQL Statements into the SQLText Editor

Directly paste your SQL statements into the SQLText Editor
Click the icon of the ER model and you will have the correspond ER diagram instantly.

2. Upload SQL files

Click upload sql
Choose upload file as the job source and choose the SQL type in the dbvendor. Upload file and create the Job.
Choose the job in the job list panel when it is complete.
Click show ER diagram in the schema explorer and check the result.

3. Connect to DB

Connect to your database for the ER diagram, check following table for the supported database types and the permissions/roles needed:
Database Type
Permissions/Roles required
Comment
MySQL
SELECT
ER Diagram needs DB user to have SELECT permission
PostgreSQL
SELECT
ER Diagram needs DB user to have SELECT permission
SQL Server
SELECT
ER Diagram needs DB user to have SELECT permission
Oracle
DBA
To generate ER Diagram from Oracle database, input user must has DBA role , otherwise ORA-01031 will be returned.
Hint: Other databases are not in current version's support list and will be supported in our future release
Choose the job in the job list panel when it is complete.
Click show ER diagram in the schema explorer and check the result.

E-R Diagram

The following capture is the ER diagram of Northwind database generated by Gudu SQLFlow. We will have tables, fields, field types and different kinds of key which are under different icons in the diagram.
The following ER diagram is a simple help-desk tickets system generate by Gudu SQLFlow from SQL file .

SQL Requirements to Create ER Diagram

In order to create ER diagram, foreign keys should be included in the provided SQL files. Other keys such as primary key, index key or unique key are not mandatory.

A) Foreign key

Foreign key is to build ER relations between different tables. Statements such as create table and alter table usually contain this information.

1. Foreign key in create table

CREATE TABLE SCOTT.EMP
(
EMPNO NUMBER(4,0),
ENAME VARCHAR2(10),
DEPTNO NUMBER(2,0),
CONSTRAINT PK_EMP PRIMARY KEY (EMPNO),
FOREIGN KEY(DEPTNO) REFERENCES SCOTT.DEPT(DEPTNO)
);

2. Foreign key in alter table

ALTER TABLE SCOTT.EMP ADD CONSTRAINT FK_DEPTNO FOREIGN KEY ("DEPTNO")
REFERENCES SCOTT.DEPT ("DEPTNO") ENABLE;
B) Primary key, index key, unique key

1. Primary key

Primary key can be specified in create table and alter table statement.
CREATE TABLE SCOTT.EMP
(
EMPNO NUMBER(4,0),
ENAME VARCHAR2(10),
DEPTNO NUMBER(2,0),
CONSTRAINT PK_EMP PRIMARY KEY (EMPNO),
FOREIGN KEY(DEPTNO) REFERENCES SCOTT.DEPT(DEPTNO)
);
ALTER TABLE SCOTT.DEPT
ADD CONSTRAINT dept_pk PRIMARY KEY (DEPTNO);
Icon of primary key in ER diagram
2. Unique key
Unique key can be specified in create table and alter table statement.
CREATE TABLE SCOTT.DEPT
(
DEPTNO NUMBER(2,0),
DNAME VARCHAR2(14),
LOC VARCHAR2(13),
CONSTRAINT constraint_name UNIQUE (DEPTNO)
) ;
ALTER TABLE SCOTT.DEPT
ADD CONSTRAINT constraint_name UNIQUE (DEPTNO);
Icon of unique key in ER diagram

3. Index key

Index key can be specified using create index statement.
-- Oracle
CREATE INDEX SCOTT.DEPT_INDEX
ON SCOTT.DEPT (LOC);
Or alter table add index
-- MySQL
ALTER TABLE
`ticketit` ADD INDEX `ticketit_subject_index`(`subject`);
Icon of index key in ER diagram