Skip to content

Commit a0d0f74

Browse files
20221109 1536 limitations
1 parent 84c9ffd commit a0d0f74

File tree

1 file changed

+19
-8
lines changed

1 file changed

+19
-8
lines changed

articles/synapse-analytics/synapse-link/synapse-link-for-sql-known-issues.md

Lines changed: 19 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.service: synapse-analytics
66
ms.topic: troubleshooting
77
ms.subservice: synapse-link
88
ms.custom: event-tier1-build-2022
9-
ms.date: 11/08/2022
9+
ms.date: 11/09/2022
1010
ms.author: jburchel
1111
ms.reviewer: jburchel, chuckheinzelman, wiassaf, imotiwala
1212
---
@@ -30,7 +30,7 @@ This is the list of known limitations for Azure Synapse Link for SQL.
3030
* Source table row size can't exceed 7,500 bytes. For tables where variable-length columns are stored off-row, a 24-byte pointer is stored in the main record.
3131
* Tables enabled for Azure Synapse Link for SQL can have a maximum of 1,020 columns (not 1,024).
3232
* While a database can have multiple links enabled, a given table can't belong to multiple links.
33-
* When a database owner doesn't have a mapped log in, Azure Synapse Link for SQL will run into an error when enabling a link connection. User can set database owner to a valid user with the `ALTER AUTHORIZATION` command to fix this issue.
33+
* When a database owner doesn't have a mapped login, Azure Synapse Link for SQL will run into an error when enabling a link connection. User can set database owner to a valid user with the `ALTER AUTHORIZATION` command to fix this issue.
3434
* If the source table contains computed columns or columns with data types that aren't supported by Azure Synapse Analytics dedicated SQL pools, these columns won't be replicated to Azure Synapse Analytics. Unsupported columns include:
3535
* image
3636
* text
@@ -61,7 +61,15 @@ This is the list of known limitations for Azure Synapse Link for SQL.
6161
* The security configuration from the source database will **NOT** be reflected in the target dedicated SQL pool.
6262
* Enabling Azure Synapse Link for SQL will create a new schema called `changefeed`. Don't use this schema, as it is reserved for system use.
6363
* Azure Synapse Link for SQL will **NOT** work and can't be enabled if your database contains a schema or user named `changefeed`.
64-
* Source tables with collations that are unsupported by Synapse SQL dedicated pool, such as UTF8 and certain Japanese collations, can't be replicated. Here's the [supported collations in Synapse SQL Pool](../sql/reference-collation-types.md).
64+
* Source tables with collations that are unsupported by dedicated SQL pools, such as UTF8 and certain Japanese collations, can't be replicated. Here's the [supported collations in Synapse SQL Pool](../sql/reference-collation-types.md).
65+
* Additionally, some Thai language collations are currently supported by Azure Synapse Link for SQL. These unsupported collations include:
66+
* Thai100CaseInsensitiveAccentInsensitiveKanaSensitive
67+
* Thai100CaseInsensitiveAccentSensitiveSupplementaryCharacters
68+
* Thai100CaseSensitiveAccentInsensitiveKanaSensitive
69+
* Thai100CaseSensitiveAccentInsensitiveKanaSensitiveWidthSensitiveSupplementaryCharacters
70+
* Thai100CaseSensitiveAccentSensitiveKanaSensitive
71+
* Thai100CaseSensitiveAccentSensitiveSupplementaryCharacters
72+
* ThaiCaseSensitiveAccentInsensitiveWidthSensitive
6573
* Single row updates (including off-page storage) of > 370 MB are not supported.
6674

6775
### Azure SQL DB only
@@ -88,11 +96,11 @@ This is the list of known limitations for Azure Synapse Link for SQL.
8896
### Deleting an Azure Synapse Analytics workspace with a running link could cause the transaction log in the source database to fill
8997

9098
* Applies To - Azure Synapse Link for Azure SQL Database and SQL Server 2022
91-
* Issue - When you delete an Azure Synapse Analytics workspace it is possible that running links might not be stopped, which will cause the source database to think that the link is still operational and could lead to the log filling and not being truncated.
99+
* Issue - When you delete an Azure Synapse Analytics workspace it is possible that running links might not be stopped, which will cause the source database to think that the link is still operational and could lead to the transaction log to not be truncated, and fill.
92100
* Resolution - There are two possible resolutions to this situation:
93101
1. Stop any running links prior to deleting the Azure Synapse Analytics workspace.
94102
1. Manually clean up the link definition in the source database.
95-
1. Find the table_group_id for the link(s) that need to be stopped using the following query:
103+
1. Find the `table_group_id` for the link(s) that need to be stopped using the following query:
96104
```sql
97105
SELECT table_group_id, workspace_id, synapse_workgroup_name
98106
FROM [changefeed].[change_feed_table_groups]
@@ -109,14 +117,17 @@ This is the list of known limitations for Azure Synapse Link for SQL.
109117
### Trying to re-enable change feed on a table for that was recently disabled table will show an error. This is an uncommon behavior.
110118
111119
* Applies To - Azure Synapse Link for Azure SQL Database and SQL Server 2022
112-
* Issue - When you try to enable a table that has been recently disabled with its metadata not yet been cleaned up and state marked as DISABLED, an error will be thrown stating "A table can only be enabled once among all table groups".
120+
* Issue - When you try to enable a table that has been recently disabled with its metadata not yet been cleaned up and state marked as DISABLED, an error will be thrown stating `A table can only be enabled once among all table groups`.
113121
* Resolution - Wait for sometime for the disabled table system procedure to complete and then try to re-enable the table again.
114122
115123
### Attempt to enable Synapse Link on database imported using SSDT, SQLPackage for Import/Export and Extract/Deploy operations
116124
117125
* Applies To - Azure Synapse Link for Azure SQL Database and SQL Server 2022
118-
* Issue - For SQL databases enabled with Azure Synapse Link, when you use SSDT Import/Export and Extract/Deploy operations to import/setup a new database, the `changefeed` schema and user do not get excluded in the new database. On attempting to enable Synapse Link on the imported/deployed database, the system stored procedure sys.sp_change_feed_enable_db fails as the `changefeed` user and schema already exists. This issue will also be encountered if you have a user or schema named `changefeed` that is not related to Synapse Link change feed capability.
119-
* Resolution - Manually drop the empty `changefeed` schema and `changefeed` user. Then, Synapse Link can be enabled successfully on the imported/deployed database. If you have defined a custom schema or user named `changefeed` in your database that is not related to Azure Synapse Link, and you do not intend to use Azure Synapse Link for SQL, it is not necessary to drop your `changefeed` schema or user.
126+
* Issue - For SQL databases enabled with Azure Synapse Link, when you use SSDT Import/Export and Extract/Deploy operations to import/setup a new database, the `changefeed` schema and user do not get excluded in the new database. However, the tables for the changefeed *are* ignored by DaxFX because they are marked as `is_ms_shipped=1` in `sys.objects`, and those objects never included in SSDT Import/Export and Extract/Deploy operations. When enabling Synapse Link on the imported/deployed database, the system stored procedure `sys.sp_change_feed_enable_db` fails if the `changefeed` user and schema already exist. This issue will also be encountered if you have created a user or schema named `changefeed` that is not related to Synapse Link change feed capability.
127+
* Resolution -
128+
* Manually drop the empty `changefeed` schema and `changefeed` user. Then, Synapse Link can be enabled successfully on the imported/deployed database.
129+
* If you have defined a custom schema or user named `changefeed` in your database that is not related to Azure Synapse Link, and you do not intend to use Azure Synapse Link for SQL, it is not necessary to drop your `changefeed` schema or user.
130+
* If you have defined a customer schema or user named `changedfeed` in your database, currently, this database cannot participate in the Azure Synapse Link for SQL.
120131
121132
## Next steps
122133

0 commit comments

Comments
 (0)