SnowConvert AI - SQL Server-Azure Synapse - System Tables¶
Translation spec for Transact-SQL System Tables
System tables¶
Transact-SQL |
Snowflake SQL |
Notes |
|
|---|---|---|---|
SYS.ALL_VIEWS |
INFORMATION_SCHEMA.VIEWS |
||
SYS.ALL_COLUMNS |
INFORMATION_SCHEMA.COLUMNS |
||
SYS.COLUMNS |
INFORMATION_SCHEMA.COLUMNS |
||
SYS.OBJECTS |
INFORMATION_SCHEMA.OBJECT_PRIVILEGES |
||
SYS.PROCEDURES |
INFORMATION_SCHEMA.PROCEDURES |
||
SYS.SEQUENCES |
INFORMATION_SCHEMA.SEQUENCES |
||
SYS.ALL_OBJECTS |
INFORMATION_SCHEMA.OBJECT_PRIVILEGES |
||
ALL_PARAMETERS |
Not supported |
||
SYS.ALL_SQL_MODULES |
Not supported |
||
SYS.ALLOCATION_UNITS |
Not supported |
||
SYS.ASSEMBLY_MODULES |
Not supported |
||
SYS.CHECK_CONSTRAINTS |
Not supported |
||
SYS.COLUMN_STORE_DICTIONARIES |
Not supported |
||
SYS.COLUMN_STORE_ROW_GROUPS |
Not supported |
||
SYS.COLUMN_STORE_SEGMENTS |
Not supported |
||
SYS.COMPUTED_COLUMNS |
Not supported |
||
SYS.DEFAULT_CONSTRAINTS |
Not supported |
||
SYS.EVENTS |
Not supported |
||
SYS.EVENT_NOTIFICATIONS |
Not supported |
||
SYS.EVENT_NOTIFICATION_EVENT_TYPES |
Not supported |
||
SYS.EXTENDED_PROCEDURES |
Not supported |
||
SYS.EXTERNAL_LANGUAGE_FILES |
Not supported |
||
SYS.EXTERNAL_LANGUAGES |
Not supported |
||
SYS.EXTERNAL_LIBRARIES |
Not supported |
||
SYS.EXTERNAL_LIBRARY_FILES |
Not supported |
||
SYS.FOREIGN_KEYS |
INFORMATION_SCHEMA.TABLE_CONSTRAINTS |
||
SYS.FOREIGN_KEY_COLUMNS |
Not supported |
||
SYS.FUNCTION_ORDER_COLUMNS |
Not supported |
||
SYS.HASH_INDEXES |
Not supported |
||
SYS.INDEXES |
Not supported |
||
SYS.INDEX_COLUMNS |
Not supported |
||
SYS.INDEX_RESUMABLE_OPERATIONS |
Not supported |
||
SYS.INTERNAL_PARTITIONS |
Not supported |
||
SYS.INTERNAL_TABLES |
Not supported |
||
SYS.KEY_CONSTRAINTS |
Not supported |
||
SYS.MASKED_COLUMNS |
Not supported |
||
SYS.MEMORY_OPTIMIZED_TABLES_INTERNAL_ATTRIBUTES |
Not supported |
||
SYS.MODULE_ASSEMBLY_USAGES |
Not supported |
||
SYS.NUMBERED_PROCEDURES |
Not supported |
||
SYS.NUMBERED_PROCEDURE_PARAMETERS |
Not supported |
||
SYS.PARAMETERS |
Not supported |
||
SYS.PARTITIONS |
Not supported |
||
SYS.PERIODS |
Not supported |
||
SYS.SERVER_ASSEMBLY_MODULES |
Not supported |
||
SYS.SERVER_EVENTS |
Not supported |
||
SYS.SERVER_EVENT_NOTIFICATIONS |
Not supported |
||
SYS.SERVER_SQL_MODULE |
Not supported |
||
SYS.SERVER_TRIGGERS |
Not supported |
||
SYS._SERVER_TRIGGER_EVENTS |
Not supported |
||
SYS.SQL_DEPENDENCIES |
Not supported |
||
SYS.SQL_EXPRESSION_DEPENDENCIES |
Not supported |
||
SYS.SQL_MODULES |
Not supported |
||
SYS.STATS |
Not supported |
||
SYS.STATS_COLUMNS |
Not supported |
||
SYS.SYNONYMS |
Not supported |
||
SYS.SYSTEM_COLUMNS |
Not supported |
||
SYS.SYSTEM_OBJECTS |
Not supported |
||
SYS.SYSTEM_PARAMETERS |
Not supported |
||
SYS.SYSCONSTRAINTS |
INFORMATION_SCHEMA.TABLE_CONSTRAINTS |
||
SYS.SYSTEM_SQL_MODULES” |
Not supported |
SYSCONSTRAINTS¶
Applies to
SQL Server
Azure Synapse Analytics
Note
Some parts in the output code are omitted for clarity reasons.
Description¶
The sysconstraints compatibility view maps constraint IDs to the objects and tables they belong to. It is a legacy system table from earlier SQL Server versions (SQL Server documentation).
SnowConvert AI transforms queries against sysconstraints (or sys.sysconstraints) into queries against Snowflake’s INFORMATION_SCHEMA.TABLE_CONSTRAINTS. The transformation also rewrites common OBJECT_NAME() patterns:
sysconstraints pattern |
Snowflake equivalent |
|---|---|
|
|
|
|
When OBJECT_NAME() is called with an unrecognized argument or compared against a non-literal value, the expression is preserved and SSC-EWI-TS0104 is emitted.
Sample Source Patterns¶
1. Basic sysconstraints query¶
SQL Server¶
Snowflake¶
2. Qualified sys.sysconstraints¶
SQL Server¶
Snowflake¶
3. sysconstraints inside IF EXISTS with DROP CONSTRAINT¶
SQL Server¶
Snowflake¶
Note
The WITH ( ONLINE = OFF ) clause is removed because Snowflake does not support index options on DROP CONSTRAINT. The IF EXISTS at the constraint level is also stripped because Snowflake does not support it in that position.
4. Unmapped argument emits EWI¶
SQL Server¶
Snowflake¶
Known Issues¶
1. Only OBJECT_NAME(constid) and OBJECT_NAME(id) are automatically mapped¶
Other arguments to OBJECT_NAME() inside sysconstraints queries cannot be automatically resolved and will emit SSC-EWI-TS0104.
2. Non-literal comparisons are not converted¶
If OBJECT_NAME() is compared to a column reference, variable, or expression (instead of a string literal), the expression is preserved with an EWI annotation.
3. JOIN statements with sysconstraints are not supported¶
Queries that join sysconstraints with other tables are not automatically translated.
SYS.FOREIGN_KEYS¶
Applies to
SQL Server
Azure Synapse Analytics
Note
Some parts in the output code are omitted for clarity reasons.
Description¶
Contains a row per object that is a FOREIGN KEY constraint (SQLServer Documentation).
The columns for FOREIGN KEY (sys.foreign_keys) are the following:
Column name |
Data type |
Description |
Has equivalent column in Snowflake |
|---|---|---|---|
- |
For a list of columns that this view inherits, see sys.objects (Transact-SQL). |
Partial |
|
referenced_object_id |
int |
ID of the referenced object. |
No |
key_index_id |
int |
ID of the key index within the referenced object. |
No |
is_disabled |
bit |
FOREIGN KEY constraint is disabled. |
No |
is_not_for_replication |
bit |
FOREIGN KEY constraint was created by using the NOT FOR REPLICATION option. |
No |
is_not_trusted |
bit |
FOREIGN KEY constraint has not been verified by the system. |
No |
delete_referential_action |
tinyint |
The referential action that was declared for this FOREIGN KEY when a delete happens. See SQLServer Documentation. |
No |
delete_referential_action_desc |
nvarchar(60) |
Description of the referential action that was declared for this FOREIGN KEY when a delete occurs. See SQLServer Documentation. |
No |
update_referential_action |
tinyint |
The referential action that was declared for this FOREIGN KEY when an update happens. See SQLServer Documentation. |
No |
update_referential_action_desc |
nvarchar(60) |
Description of the referential action that was declared for this FOREIGN KEY when an update happens. See SQLServer Documentation. |
No |
is_system_named |
bit |
1 = Name was generated by the system. |
No |
The inherited columns from sys.objects are the following:
For more information, review the sys.objects documentation.
Column name |
Data type |
Description |
Has equivalent column in Snowflake |
|---|---|---|---|
name |
sysname |
Object name. |
Yes |
object_id |
int |
Object identification number. Is unique within a database. |
No |
principal_id |
int |
ID of the individual owner, if different from the schema owner. |
No |
schema_id |
int |
ID of the schema that the object is contained in. |
No |
parent_object_id |
int |
ID of the object to which this object belongs. |
No |
type |
char(2) |
Object type |
Yes |
type_desc |
nvarchar(60) |
Description of the object type |
Yes |
create_date |
datetime |
Date the object was created. |
Yes |
modify_date |
datetime |
Date the object was last modified by using an ALTER statement. |
Yes |
is_ms_shipped |
bit |
Object is created by an internal SQL Server component. |
No |
is_published |
bit |
Object is created by an internal SQL Server component. |
No |
is_schema_published |
bit |
Only the schema of the object is published. |
No |
Warning
Notice that, in this case, for the sys.foreign_keys, there is no equivalence in Snowflake. But, the equivalence is made under the columns inherited from sys.objects.
Applicable column equivalence¶
SQLServer |
Snowflake |
Limitations |
Applicable |
|---|---|---|---|
name |
CONSTRAINT_NAME |
Names auto-generated by the database may be reviewed to the target Snowflake auto-generated name, |
Yes |
type |
CONSTRAINT_TYPE |
The type column has a variety of options. But, in this case, the support is only for the letter ‘F’ which represents the foreign keys. |
No. Because of the extra validation to determine the foreign keys from all table constraints, it is not applicable. |
type_desc |
CONSTRAINT_TYPE |
No limitations found. |
No. Because of the extra validation to determine the foreign keys from all table constraints, it is not applicable. |
create_date |
CREATED |
Data type differences. |
Yes |
modify_date |
LAST_ALTERED |
Data type differences. |
Yes |
parent_object_id |
CONSTRAINT_CATALOG, CONSTRAINT_SCHEMA, TABLE_NAME |
Columns are generated only for the cases that use the OBJECT_ID() function and, the name has a valid pattern. |
Yes |
Syntax in SQL Server¶
Syntax in Snowflake¶
Note
Since the equivalence for the system foreign keys is the catalog view in Snowflake for in ormation_schema.table_constraints, it is necessary to define the type of the constraint in an additional ‘WHERE’ clause to identify foreign key constraints from other constraints.
Sample Source Patterns¶
To accomplish correctly the following samples, it is required to run the following statements:
SQL Server¶
Snowflake¶
1. Simple Select Case¶
SQL Server¶
Result¶
name |
object_id |
principal_id |
schema_id |
type |
type_desc |
create_date |
modify_date |
parent_object_id |
is_ms_shipped |
is_published |
is_schema_published |
referenced_object_id |
key_index_id |
is_disabled |
is_not_for_replication |
is_not_trusted |
delete_referential_action |
delete_referential_action_desc |
update_referential_action |
update_referential_action_desc |
is_system_named |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
FK_Name_Test |
1719677174 |
NULL |
1 |
F |
FOREIGN_KEY_CONSTRAINT |
2023-09-11 22:20:04.160 |
2023-09-11 22:20:04.160 |
1687677060 |
false |
true |
false |
1655676946 |
1 |
false |
false |
0 |
NO_ACTION |
0 |
NO_ACTION |
true |
Snowflake¶
Result¶
CONSTRAINT_CATALOG |
CONSTRAINT_SCHEMA |
CONSTRAINT_NAME |
TABLE_CATALOG |
TABLE_SCHEMA |
TABLE_NAME |
CONSTRAINT_TYPE |
IS_DEFERRABLE |
INITIALLY_DEFERRED |
ENFORCED |
COMMENT |
CREATED |
LAST_ALTERED |
RELY |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DBTEST |
PUBLIC |
FK_Name_Test |
DATETEST |
PUBLIC |
ORDERS |
FOREIGN KEY |
NO |
YES |
NO |
null |
2023-09-11 15:23:51.969 -0700 |
2023-09-11 15:23:52.097 -0700 |
NO |
Warning
Results differ due to the differences in column objects and missing equivalence. The result may be checked.
2. Name Column Case¶
SQL Server¶
Result¶
name |
object_id |
principal_id |
schema_id |
type |
type_desc |
create_date |
modify_date |
parent_object_id |
is_ms_shipped |
is_published |
is_schema_published |
referenced_object_id |
key_index_id |
is_disabled |
is_not_for_replication |
is_not_trusted |
delete_referential_action |
delete_referential_action_desc |
update_referential_action |
update_referential_action_desc |
is_system_named |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
FK_Name_Test |
1719677174 |
NULL |
1 |
F |
FOREIGN_KEY_CONSTRAINT |
2023-09-11 22:20:04.160 |
2023-09-11 22:20:04.160 |
1687677060 |
false |
true |
false |
1655676946 |
1 |
false |
false |
0 |
NO_ACTION |
0 |
NO_ACTION |
true |
Snowflake¶
Result¶
CONSTRAINT_CATALOG |
CONSTRAINT_SCHEMA |
CONSTRAINT_NAME |
TABLE_CATALOG |
TABLE_SCHEMA |
TABLE_NAME |
CONSTRAINT_TYPE |
IS_DEFERRABLE |
INITIALLY_DEFERRED |
ENFORCED |
COMMENT |
CREATED |
LAST_ALTERED |
RELY |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DBTEST |
PUBLIC |
FK_Name_Test |
DATETEST |
PUBLIC |
ORDERS |
FOREIGN KEY |
NO |
YES |
NO |
null |
2023-09-11 15:23:51.969 -0700 |
2023-09-11 15:23:52.097 -0700 |
NO |
Warning
This translation may require verification if the constraint name is auto-generated by the database and used in the query. For more information review the Known Issues section.
3. Parent Object ID Case¶
In this example, a database and schema were created to exemplify the processing of the names to create different and equivalent columns.
SQL Server¶
Result¶
name |
object_id |
principal_id |
schema_id |
type |
type_desc |
create_date |
modify_date |
parent_object_id |
is_ms_shipped |
is_published |
is_schema_published |
referenced_object_id |
key_index_id |
is_disabled |
is_not_for_replication |
is_not_trusted |
delete_referential_action |
delete_referential_action_desc |
update_referential_action |
update_referential_action_desc |
is_system_named |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
FK_Name_Test |
1719677174 |
NULL |
1 |
F |
FOREIGN_KEY_CONSTRAINT |
2023-09-11 22:20:04.160 |
2023-09-11 22:20:04.160 |
1687677060 |
false |
true |
false |
1655676946 |
1 |
false |
false |
0 |
NO_ACTION |
0 |
NO_ACTION |
true |
Snowflake¶
Result¶
CONSTRAINT_CATALOG |
CONSTRAINT_SCHEMA |
CONSTRAINT_NAME |
TABLE_CATALOG |
TABLE_SCHEMA |
TABLE_NAME |
CONSTRAINT_TYPE |
IS_DEFERRABLE |
INITIALLY_DEFERRED |
ENFORCED |
COMMENT |
CREATED |
LAST_ALTERED |
RELY |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DATABASE_NAME_TEST |
SCHEMA_NAME_TEST |
FK_Name_Test |
DATABASE_NAME_TEST |
SCHEMA_NAME_TEST |
ORDERS |
FOREIGN KEY |
NO |
YES |
NO |
null |
2023-09-11 15:23:51.969 -0700 |
2023-09-11 15:23:52.097 -0700 |
NO |
Warning
If the name coming inside the OBJECT_ID() function does not have a valid pattern, it will not be converted due to name processing limitations on special characters.
Warning
Review the database that is being used in Snowflake.
4. Type Column Case¶
The ‘F’ in SQL Server means ‘Foreign Key’ and it is removed due to the validation at the ending to specify the foreign key from all the table constraints.
SQL Server¶
Result¶
name |
object_id |
principal_id |
schema_id |
type |
type_desc |
create_date |
modify_date |
parent_object_id |
is_ms_shipped |
is_published |
is_schema_published |
referenced_object_id |
key_index_id |
is_disabled |
is_not_for_replication |
is_not_trusted |
delete_referential_action |
delete_referential_action_desc |
update_referential_action |
update_referential_action_desc |
is_system_named |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
FK_Name_Test |
1719677174 |
NULL |
3 |
F |
FOREIGN_KEY_CONSTRAINT |
2023-09-11 22:20:04.160 |
2023-09-11 22:20:04.160 |
1687677060 |
false |
true |
false |
1655676946 |
1 |
false |
false |
0 |
NO_ACTION |
0 |
NO_ACTION |
true |
Snowflake¶
Result¶
CONSTRAINT_CATALOG |
CONSTRAINT_SCHEMA |
CONSTRAINT_NAME |
TABLE_CATALOG |
TABLE_SCHEMA |
TABLE_NAME |
CONSTRAINT_TYPE |
IS_DEFERRABLE |
INITIALLY_DEFERRED |
ENFORCED |
COMMENT |
CREATED |
LAST_ALTERED |
RELY |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DBTEST |
PUBLIC |
FK_Name_Test |
DATETEST |
PUBLIC |
ORDERS |
FOREIGN KEY |
NO |
YES |
NO |
null |
2023-09-11 15:23:51.969 -0700 |
2023-09-11 15:23:52.097 -0700 |
NO |
5. Type Desc Column Case¶
The ‘type_desc’ column is removed due to the validation at the ending to specify the foreign key from all the table constraints.
SQL Server¶
Result¶
name |
object_id |
principal_id |
schema_id |
type |
type_desc |
create_date |
modify_date |
parent_object_id |
is_ms_shipped |
is_published |
is_schema_published |
referenced_object_id |
key_index_id |
is_disabled |
is_not_for_replication |
is_not_trusted |
delete_referential_action |
delete_referential_action_desc |
update_referential_action |
update_referential_action_desc |
is_system_named |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
FK_Name_Test |
1719677174 |
NULL |
3 |
F |
FOREIGN_KEY_CONSTRAINT |
2023-09-11 22:20:04.160 |
2023-09-11 22:20:04.160 |
1687677060 |
false |
true |
false |
1655676946 |
1 |
false |
false |
0 |
NO_ACTION |
0 |
NO_ACTION |
true |
Snowflake¶
Result¶
CONSTRAINT_CATALOG |
CONSTRAINT_SCHEMA |
CONSTRAINT_NAME |
TABLE_CATALOG |
TABLE_SCHEMA |
TABLE_NAME |
CONSTRAINT_TYPE |
IS_DEFERRABLE |
INITIALLY_DEFERRED |
ENFORCED |
COMMENT |
CREATED |
LAST_ALTERED |
RELY |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DBTEST |
PUBLIC |
FK_Name_Test |
DATETEST |
PUBLIC |
ORDERS |
FOREIGN KEY |
NO |
YES |
NO |
null |
2023-09-11 15:23:51.969 -0700 |
2023-09-11 15:23:52.097 -0700 |
NO |
6. Modify Date Column Simple Case¶
SQL Server¶
Result¶
Snowflake¶
Result¶
7. Modify Date Column with DATEDIFF() Case¶
The following example shows a more complex scenario where the columns from sys.foreign_keys (inherited from sys.objects) are inside a function DATEDIFF. In this case, the argument corresponding to the applicable equivalence is changed to the corresponding column from the information.schema in Snowflake.
SQL Server¶
Result¶
Snowflake¶
Result¶
8. Create Date Column Case¶
SQL Server¶
Result¶
Snowflake¶
Result¶
Warning
The result may change if the creation date is specific due to the time on which the queries were executed. It is possible to execute a specified query at one time on the origin database and then execute the objects at another time in the new Snowflake queries.
9. Selected Columns Single Name Case¶
SQL Server¶
Result¶
name |
|---|
FK_Name_Test |
Snowflake¶
Result¶
CONSTRAINT_NAME |
|---|
FK_Name_Test |
10. Selected Columns Qualified Name Case¶
SQL Server¶
Result¶
name |
|---|
FK_Name_Test |
Snowflake¶
Result¶
CONSTRAINT_NAME |
|---|
FK_Name_Test |
Known Issues¶
1. The ‘name’ column may not show a correct output if the constraint does not have a user-created name¶
If the referenced name is one auto-generated from the database, it would be probable to review it and use the wanted value.
2. When selecting columns, there is a limitation that depends on the applicable columns that are equivalent in Snowflake¶
Since the columns from sys.foreign_keys are not completely equivalent in Snowflake, some results may change due to the limitations on the equivalence.
3. The OBJECT_ID() function may have a valid pattern to be processed or the database, schema or table could not be extracted¶
Based on the name that receives the OBJECT_ID() function, the processing of this name will be limited and dependent on formatting.
4. Name Column With OBJECT_NAME() Function Case¶
Since the OBJECT_NAME() function is not supported yet, the transformations related to this function are not supported.
SQL Server¶
Snowflake¶
5. SCHEMA_NAME() and TYPE_NAME() functions are also not supported yet.¶
6. Different Join statement types may be not supported if the system table is not supported. Review the supported system tables.¶
7. Cases with JOIN statements are not supported.¶
8. Names with alias AS are not supported.¶
Related EWIs¶
SSC-EWI-0073: Pending Functional Equivalence Review.