You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: CREATE EXTERNAL TABLE (Transact-SQL) creates an external table.
4
4
author: MikeRayMSFT
5
5
ms.author: mikeray
6
-
ms.reviewer: hudequei
7
-
ms.date: 01/07/2025
6
+
ms.reviewer: hudequei, randolphwest
7
+
ms.date: 05/19/2025
8
8
ms.service: sql
9
9
ms.subservice: t-sql
10
10
ms.topic: reference
@@ -1092,14 +1092,21 @@ PolyBase can push some of the query computation to Hadoop to improve query perfo
1092
1092
1093
1093
You can create many external tables that reference the same or different external data sources.
1094
1094
1095
-
Pay attention to source data using the UTF-8 collation. For any source data using the UTF-8 collation, you must manually provide a non-UTF-8 collation each UTF-8 column in the `CREATE EXTERNAL TABLE` statement. This is because UTF-8 support does not extend to external tables. When you attempt to create an external table with a UTF-8 collation, you will receive an `Unsupported collation` error message. If the external table's database collation is a UTF-8 collation, external table creation will fail unless you provide an explicit non-UTF-8 column collation, for example, `[UTF8_column] varchar(128) COLLATE LATIN1_GENERAL_100_CI_AS_KS_WS NOT NULL,`.
1096
-
1097
1095
Serverless and dedicated SQL pools in Azure Synapse Analytics use different code bases for data virtualization. Serverless SQL pools support a native data virtualization technology. Dedicated SQL pools support both native and PolyBase data virtualization. PolyBase data virtualization is used when the EXTERNAL DATA SOURCE is created with `TYPE=HADOOP`.
1098
1096
1099
1097
## Limitations and restrictions
1100
1098
1101
1099
Since the data for an external table is not under the direct management control of Azure Synapse, it can be changed or removed at any time by an external process. As a result, query results against an external table aren't guaranteed to be deterministic. The same query can return different results each time it runs against an external table. Similarly, a query might fail if the external data is moved or removed.
1102
1100
1101
+
External tables do not support source data with UTF-8 collations. If your source data uses UTF-8 collation, you must explicitly assign a non-UTF-8 collation to each UTF-8 column in the CREATE EXTERNAL TABLE statement. Failing to do so results in an error message similar to the following output:
1102
+
1103
+
```output
1104
+
Msg 105105, Level 16, State 1, Line 22
1105
+
105105;No column collation was specified in external table definition and the collation of current database 'Latin1_General_100_CI_AS_SC_UTF8' is not supported for external tables of type 'HADOOP'. Please specify a supported collation in the column definition.
1106
+
```
1107
+
1108
+
If the external table's database collation is UTF-8, the table creation fails unless each column is explicitly defined with a non-UTF-8 collation (for example, `[UTF8_column] VARCHAR(128) COLLATE LATIN1_GENERAL_100_CI_AS_KS_WS NOT NULL`).
1109
+
1103
1110
You can create multiple external tables that each reference different external data sources.
1104
1111
1105
1112
Only these Data Definition Language (DDL) statements are allowed on external tables:
0 commit comments