Transact-SQL Parsing

In this document, you will be able to see where Dataedo uses an SQL parser that uses the Transact-SQL dialect and what its capabilities are.

What is an SQL Parser?

A SQL parser is a tool that reads SQL code and converts it into a format that can be understood and processed by a computer. The parser is an important component of any metadata management system like Dataedo as it allows them to analyze SQL queries and fetch the relevant metadata.

Click to learn more about the other parser features.

Supported engines

Engines that use this dialect:

• SQL Server
• Azure SQL Database
• Azure Synapse Analytics (formerly SQL DW)
• Azure SQL Edge

Import schema from DDL

Data Definition Language (DDL) is a subset of SQL that is used to describe database structure and relationships in a database. With the help of an SQL Parser, Dataedo imports the schema based on the given DDL. Read more.

This feature is also available for PostgreSQL dialect.

Automatic column-level lineage from SELECT/CREATE VIEW statements

Dataedo will create column-level data lineage for views and SQL queries based on the script. Just leave the "Automatic lineage" option selected during import.

If you disable the this feature during import, you will still be able to trigger the automated creation of column-level lineage through the "Parse Script to Lineage" functionality, which is located in the Script tab.

This function also works for manually added views that was created using a script, as well as for SQL Query objects.

Supported SQL syntax

We support the creation of an automatic lineage in all dialects for the following SQL syntax:

• SELECT and CREATE VIEW statements,
• Aliases,
• Functions and operators,
• UNIONs,
• JOINs,
• Subqueries and nested queries,
• CASEs and other logic-related expressions,
• Not Recursive Common Table Expressions (CTE).

We do not support the creation of an automatic lineage for the following SQL syntax:

• Statements that access nested data such JSON, XML, or objects as columns
• PIVOT and UNPIVOT relational operators,
• Recursive Common Table Expressions (Recursive CTE),
• Dynamic queries,
• Window functions.

Automatic column-level lineage from imported Stored Procedures

Dataedo will create column-level data lineage for stored procedures based on the script. Just leave the "Automatic lineage" option selected during import or doing import changes, it is not possible yet to parse a single procedure or manual script beyond the mentioned operations.

Dataedo will divide the procedure into steps and represent them as processes, then create a data lineage for supported steps. Unsupported steps will be named after the first word from the process script and end with three dots.

In the script tab, the processes contain fragments of the procedure script to which they refer.

Dataedo will also divide into steps user-defined functions, but it will not create a lineage for them.

Supported SQL syntax

We support the creation of an automatic lineage for Transact-SQL dialect for the following SQL statements:

• SELECT INTO,
• INSERT,
• UPDATE,
• OUTPUT statements,
• Not Recursive Common Table Expressions (CTE, WITH statements),
• Variables and parameters,
• CREATE TABLE AS SELECT.

When temporary tables are created in a procedure (ones that do not normally exist in the documented database), Dataedo will try to combine the lineage that goes into them with the lineage that comes out of them, i.e. instead of SOURCE_TABLE -> #TEMP_TABLE -> DESTINATION_TABLE, will represent it as SOURCE_TABLE -> DESTINATION_TABLE.

Regrettably, due to the nature of ANTLR, the presence of unsupported elements within a procedure may result in the entire procedure being unable to be parsed. In the current stage, we treat procedures incorporating elements beyond those explicitly outlined as unsupported. Nevertheless, we do our best to make sure that the unsupported elements do not affect supported steps.

We do not support the creation of an automatic lineage for the following SQL syntax:

• MERGE statements,
• DELETE statements,
• BULK INSERT statements,
• COPY INTO statements,
• Syntax mentioned as unsupported in the SELECT/CREATE VIEW chapter.

Online SQL parser

You can testdrive SQL parsing capabilities online, in our SQL parsing/analyzing website.