CREATE EXTERNAL TABLE AS SELECT (CETAS) (Transact-SQL)

Se aplica a: SQL Server 2022 (16.x) y versiones posteriores azure Synapse Analytics Analytics Platform System (PDW)

Crea una tabla externa y, después, exporta en paralelo los resultados de una instrucción SELECT de Transact-SQL.

• Azure Synapse Analytics y Analytics Platform System admiten Hadoop o Azure Blob Storage.
• SQL Server 2022 (16.x) y versiones posteriores admiten CREATE EXTERNAL TABLE AS SELECT (CETAS) para crear una tabla externa y, después, exportar, en paralelo, el resultado de una instrucción SELECT de Transact-SQL a Azure Data Lake Storage (ADLS) Gen2, la cuenta de Azure Storage V2 y el almacenamiento de objetos compatible con S3.

Nota:

Las funcionalidades y la seguridad de CETAS para Azure SQL Managed Instance son diferentes de las de SQL Server o Azure Synapse Analytics. Para más información, consulte la versión de Azure SQL Managed Instance de CREATE EXTERNAL TABLE AS SELECT.

Nota:

Las funcionalidades y la seguridad de CETAS para grupos sin servidor en Azure Synapse Analytics son diferentes de las de SQL Server. Para más información, consulte CETAS con Synapse SQL.

Convenciones de sintaxis de Transact-SQL

Sintaxis

CREATE EXTERNAL TABLE { [ [ database_name . [ schema_name ] . ] | schema_name . ] table_name }
    [ (column_name [ , ...n ] ) ]
    WITH (
        LOCATION = 'hdfs_folder' | '<prefix>://<path>[:<port>]' ,
        DATA_SOURCE = external_data_source_name ,
        FILE_FORMAT = external_file_format_name
        [ , <reject_options> [ , ...n ] ]
    )
    AS <select_statement>
[;]

<reject_options> ::=
{
    | REJECT_TYPE = value | percentage
    | REJECT_VALUE = reject_value
    | REJECT_SAMPLE_VALUE = reject_sample_value
}

<select_statement> ::=
    [ WITH <common_table_expression> [ , ...n ] ]
    SELECT <select_criteria>

Argumentos

[ [ database_name. [ schema_name ] . ] | schema_name. ] table_name

Nombre de una, dos o tres partes de la tabla que se va a crear en la base de datos. Para una tabla externa, la base de datos relacional solo almacena los metadatos de la tabla.

[ ( column_name [ ,...n ] ) ]

El nombre de una columna de la tabla.

LOCATION

Se aplica a: Azure Synapse Analytics y Sistema de la plataforma de análisis

'hdfs_folder'**
Especifica dónde se deben escribir los resultados de la instrucción SELECT en el origen de datos externo. La ubicación es un nombre de carpeta y puede incluir opcionalmente una ruta de acceso relativa a la carpeta raíz del clúster de Hadoop o Blob Storage. PolyBase crea la ruta de acceso y la carpeta si aún no existen.

Los archivos externos escriben en hdfs_folder y se denominan QueryID_date_time_ID.format, donde ID es un identificador incremental y format, el formato de los datos exportados. Un ejemplo es QID776_20160130_182739_0.orc.

La ubicación debe apuntar a una carpeta y tener un carácter / final; por ejemplo: aggregated_data/.

Se aplica a: SQL Server 2022 (16.x) y versiones posteriores.

prefix://path[:port] proporciona el protocolo de conectividad (prefijo), la ruta de acceso y, opcionalmente, el puerto, al origen de datos externo, donde se escribirá el resultado de la instrucción SELECT.

Si el destino es un almacenamiento de objetos compatible con S3, primero debe existir un cubo, pero PolyBase puede crear subcarpetas si es necesario. SQL Server 2022 (16.x) admite Azure Data Lake Storage Gen2, la cuenta de Azure Storage V2 y el almacenamiento de objetos compatible con S3. Los archivos ORC no se admiten actualmente.

DATA_SOURCE = external_data_source_name

Especifica el nombre del objeto de origen de datos externo que contiene la ubicación en donde se almacenan (o se almacenarán) los datos externos. La ubicación es un clúster de Hadoop o una instancia de Azure Blob Storage. Para crear un origen de datos externo, use CREATE EXTERNAL DATA SOURCE (Transact-SQL).

FILE_FORMAT = external_file_format_name

Especifica el nombre del objeto de formato de archivo externo que contiene el formato del archivo de datos externos. Para crear un formato de archivo externo, use CREATE EXTERNAL FILE FORMAT (Transact-SQL).

Opciones de REJECT

Las opciones de REJECT no son aplicables en el momento en que se ejecuta esta instrucción CREATE EXTERNAL TABLE AS SELECT. En su lugar, se especifican aquí para que la base de datos pueda usarlas en un momento posterior, cuando importe datos de la tabla externa. Más adelante, cuando la instrucción CREATE TABLE AS SELECT seleccione datos de la tabla externa, la base de datos usará las opciones de rechazo para determinar el número o el porcentaje de filas que pueden no importarse antes de que la importación se detenga.

• REJECT_VALUE = reject_value

  Especifica el valor o el porcentaje de filas que pueden no importarse antes de que la base de datos detenga la importación.

• REJECT_TYPE = value | percentage

  Especifica si la opción REJECT_VALUE es un valor literal o un porcentaje.

  • value

    Se usa si REJECT_VALUE es un valor literal, no un porcentaje. La base de datos detiene la importación de filas del archivo de datos externos cuando el número de filas con errores supera el valor de reject_value.

    Por ejemplo, si REJECT_VALUE = 5 y REJECT_TYPE = value, la base de datos detiene la importación de filas cuando no se han podido importar cinco filas.

  • percentage

    Se usa si REJECT_VALUE es un porcentaje, no un valor literal. La base de datos detiene la importación de filas del archivo de datos externos cuando el valor de percentage de las filas con errores supere el valor de reject_value. El porcentaje de filas con errores se calcula a intervalos. Solo es válido en grupos de SQL dedicados cuando TYPE=HADOOP.

• REJECT_SAMPLE_VALUE = reject_sample_value

  Necesario cuando REJECT_TYPE = percentage. Especifica el número de filas para intentar importarlas antes de que la base de datos recalcule el porcentaje de filas con errores.

  Por ejemplo, si REJECT_SAMPLE_VALUE = 1000, la base de datos calculará el porcentaje de filas con errores después de haber intentado importar 1000 filas desde el archivo de datos externos. Si el porcentaje de filas con errores es inferior al valor de reject_value, la base de datos intenta cargar otras 1000 filas. La base de datos seguirá recalculando el porcentaje de filas con errores después de intentar importar cada 1000 filas más.

  Nota:

  Puesto que la base de datos calcula el porcentaje de filas con errores a intervalos, el porcentaje real de filas con errores puede llegar a superar el valor de reject_value.

  Ejemplo:

  En este ejemplo se muestra cómo interactúan entre sí las tres opciones REJECT. Por ejemplo, si REJECT_TYPE = percentage, REJECT_VALUE = 30, REJECT_SAMPLE_VALUE = 100, podría darse el siguiente escenario:

  • La base de datos intenta cargar las 100 primeras filas; 25 no se importan y 75 sí.
  • El porcentaje de las filas con errores se calcula en un 25 %, que es menor que el valor de rechazo de 30 %. Por lo tanto, no es necesario detener la carga.
  • La base de datos intenta cargar las siguientes 100 filas. Esta vez, 25 se cargan correctamente y 75 generan un error.
  • El porcentaje de filas con errores se recalcula en un 50 %. El porcentaje de filas con errores supera pues el valor de rechazo de 30 %.
  • La carga no se efectúa y refleja un 50 % de filas con errores después de intentar cargar 200 filas, lo cual es superior al límite de 30 % especificado.

WITH common_table_expression

Especifica un conjunto de resultados temporal con nombre, conocido como expresión de tabla común (CTE). Para más información, consulte WITH common_table_expression (Transact-SQL)

SELECT <select_criteria>

Rellena la nueva tabla con los resultados de una instrucción SELECT. select_criteria es el cuerpo de la instrucción SELECT que determina qué datos se copian en la nueva tabla. Para más información sobre las instrucciones SELECT, consulte SELECT (Transact-SQL).

Nota

La cláusula ORDER BY de SELECT no tiene ningún efecto en CETAS.

Opciones de columna

• column_name [ ,...n ]

  Los nombres de columna no admiten las opciones de columna mencionadas en CREATE TABLE. En su lugar, puede proporcionar una lista opcional de uno o más nombres de columna para la nueva tabla. Las columnas de la nueva tabla usan los nombres que especifique. Al especificar nombres de columna, el número de columnas de la lista de columnas debe coincidir con el número de columnas de los resultados de selección. Si no especifica nombres de columna, la nueva tabla de destino usa los nombres de columna de los resultados de la instrucción de selección.

  No se pueden especificar otras opciones de columna, como tipos de datos, intercalación o la nulabilidad. Cada uno de estos atributos se deriva de los resultados de la instrucción SELECT. Aun así, puede usar la instrucción SELECT para cambiar los atributos. Para obtener un ejemplo, vea Uso de CETAS para cambiar los atributos de columna.

Permisos

Para ejecutar este comando, el usuario de base de datos necesita todos estos permisos o pertenencias a grupos:

• Permiso ALTER SCHEMA en el esquema local que va a contener la nueva tabla o pertenencia al rol fijo de base de datos db_ddladmin.
• Permiso CREATE TABLE o pertenencia al rol fijo de base de datos db_ddladmin.
• Permiso SELECT en cualquier objeto al que se haga referencia en select_criteria.

El inicio de sesión necesita todos estos permisos:

• ADMINISTER BULK OPERATIONS
• ALTER ANY EXTERNAL DATA SOURCE
• ALTER ANY EXTERNAL FILE FORMAT
• En general, debe tener permisos para mostrar el contenido de la carpeta y escribir en la carpeta LOCATION de CETAS.
• En Azure Synapse Analytics y Analytics Platform System, el permiso de escritura para leer y escribir en la carpeta externa en el clúster de Hadoop o Azure Blob Storage.
• En SQL Server 2022 (16.x), también es necesario establecer los permisos adecuados en la ubicación externa. Permiso de escritura para generar los datos en la ubicación y permiso de lectura para acceder a ellos.
• En Azure Blob Storage y Azure Data Lake Gen2, se debe conceder al token SHARED ACCESS SIGNATURE los siguientes privilegios en el contenedor: Lectura, Escritura, Enumerar y Crear.
• En Azure Blog Storage, la casilla Allowed Services: Blob debe estar activada para generar el token de SAS.
• En Azure Data Lake Gen2, las casillas Allowed Services: Container y Object deben estar activadas para generar el token de SAS.

Importante

El permiso ALTER ANY EXTERNAL DATA SOURCE concede a cualquier entidad de seguridad la capacidad de crear y modificar cualquier objeto de origen de datos externo y, por tanto, también permite acceder a todas las credenciales con ámbito de base de datos de la base de datos. Debe considerarse como un permiso con muchos privilegios y solo debe concederse a las entidades de seguridad de confianza del sistema.

Control de errores

Cuando CREATE EXTERNAL TABLE AS SELECT exporta los datos a un archivo delimitado de texto, no hay ningún archivo de rechazo para las filas que no se pueden exportar.

Al crear la tabla externa, la base de datos intenta conectarse a la ubicación externa. Si se produce un error en la conexión, el comando genera un error y no se crea la tabla externa. El comando puede tardar un minuto (o más) en producir un error, ya que la base de datos intenta conectar al menos en tres ocasiones.

Si CREATE EXTERNAL TABLE AS SELECT se cancela o produce un error, la base de datos realiza un único intento para quitar los nuevos archivos y carpetas que ya se hayan creado en el origen de datos externo.

En Azure Synapse Analytics y Analytics Platform System, la base de datos notifica los errores de Java que se producen en el origen de datos externo durante la exportación de datos.

Comentarios

Una vez finalizada la instrucción CREATE EXTERNAL TABLE AS SELECT, se pueden ejecutar consultas de Transact-SQL en la tabla externa. Estas operaciones importan datos a la base de datos el tiempo que dure la consulta, a menos que la importación se realice con la instrucción CREATE TABLE AS SELECT.

La definición y el nombre de tabla externa se almacenan en los metadatos de la base de datos. Los datos se almacenan en el origen de datos externo.

La instrucción CREATE EXTERNAL TABLE AS SELECT siempre crea una tabla sin particiones, incluso si la tabla de origen tiene particiones.

En SQL Server 2022 (16.x), la opción allow polybase export debe habilitarse mediante sp_configure. Para obtener más información, consulte Establecimiento de la opción de configuraciónallow polybase export.

En el caso de los planes de consulta de Azure Synapse Analytics y Analytics Platform System que se han creado con EXPLAIN, la base de datos usa estas operaciones de plan de consulta para tablas externas: movimiento aleatorio externo, movimiento de difusión externo, movimiento de partición externa.

En Analytics Platform System, como requisito previo para crear una tabla externa, el administrador del dispositivo debe configurar la conectividad de Hadoop. Para más información, vea la sección sobre cómo configurar la conectividad a datos externos (Analytics Platform System) en la documentación de Analytics Platform System, que puede descargar desde el Centro de descarga de Microsoft.

Limitaciones y restricciones

Dado que los datos de la tabla externa están fuera de la base de datos, las operaciones de copia de seguridad y restauración solo funcionarán con los datos almacenados en la base de datos. Como consecuencia, solo se hará una copia de seguridad y una restauración de los metadatos.

La base de datos no comprueba la conexión al origen de datos externo al restaurar una copia de seguridad de base de datos que contiene una tabla externa. Si el origen inicial no está accesible, la restauración de metadatos de la tabla externa seguirá realizándose correctamente, pero no se podrán llevar a cabo operaciones SELECT en la tabla externa.

La base de datos no garantiza la coherencia de los datos entre la base de datos y los datos externos. Usted, como cliente, es el único responsable de mantener la coherencia entre los datos externos y la base de datos.

No se admiten operaciones de lenguaje de manipulación de datos (DML) en las tablas externas. Por ejemplo, no se pueden usar las instrucciones UPDATE, INSERT o DELETE de Transact-SQL para modificar los datos externos.

CREATE TABLE, DROP TABLE, CREATE STATISTICS, DROP STATISTICS, CREATE VIEW y DROP VIEW son las únicas operaciones de lenguaje de manipulación de datos (DDL) que se permiten en las tablas externas.

Limitaciones y restricciones de Azure Synapse Analytics

• En los grupos de SQL dedicados de Azure Synapse Analytics y en Analytics Platform System, PolyBase puede consumir un máximo de 33 000 archivos por carpeta al ejecutar 32 consultas simultáneas de PolyBase. Esta cifra máxima engloba los archivos y las subcarpetas de cada carpeta de HDFS. Si el grado de simultaneidad es inferior a 32, un usuario puede ejecutar consultas de PolyBase en carpetas de HDFS que contengan más de 33 000 archivos. Se recomienda que los usuarios de Hadoop y PolyBase mantengan unas rutas de acceso de archivo cortas y no usen más de 30 000 archivos por carpeta de HDFS. Si hay referencias a demasiados archivos, podría producirse una excepción de memoria insuficiente de JVM.

• En grupos de SQL sin servidor, no se pueden crear tablas externas en una ubicación donde actualmente tiene datos. A fin de volver a usar una ubicación que se ha utilizado para almacenar datos, la ubicación debe eliminarse manualmente en ADLS. Para conocer más limitaciones y procedimientos recomendados, consulte Procedimientos recomendados de optimización de filtros.

En los grupos de SQL dedicados de Azure Synapse Analytics y en Analytics Platform System, cuando CREATE EXTERNAL TABLE AS SELECT realiza una selección desde un RCFile, los valores de columna del RCFile no deben contener el carácter (|) de canalización.

SET ROWCOUNT (Transact-SQL) no tiene ningún efecto en CREATE EXTERNAL TABLE AS SELECT. Para lograr un comportamiento similar, use TOP (Transact-SQL).

Revise Nomenclatura y referencia a contenedores, blobs y metadatos para conocer las limitaciones de los nombres de archivo.

Errores de caracteres

Los caracteres siguientes presentes en los datos pueden provocar errores, incluidos los registros rechazados con CREATE EXTERNAL TABLE AS SELECT en archivos Parquet.

En Azure Synapse Analytics y Analytics Platform System, esto también se aplica a los archivos ORC.

• |
• " (carácter de comillas)
• \r\n
• \r
• \n

Para usar CREATE EXTERNAL TABLE AS SELECT con estos caracteres, primero debe ejecutar esta instrucción para exportar los datos a archivos de texto delimitados donde puede convertirlos en archivos ORC o de Parquet mediante una herramienta externa.

Trabajar con parquet

Al trabajar con archivos parquet, CREATE EXTERNAL TABLE AS SELECT generará un archivo parquet por CPU disponible, hasta el grado máximo de paralelismo configurado (MAXDOP). Cada archivo puede crecer hasta 190 GB, después de que SQL Server genere más archivos Parquet según sea necesario.

La sugerencia OPTION (MAXDOP n) de consulta solo afectará a la parte SELECT de CREATE EXTERNAL TABLE AS SELECT, no tiene ninguna influencia en la cantidad de archivos parquet. Solo se considera MAXDOP de nivel de base de datos y MAXDOP de nivel de instancia.

Bloqueo

Toma un bloqueo compartido en el objeto SCHEMARESOLUTION.

Supported data types (Tipos de datos admitidos)

CETAS se puede usar para almacenar conjuntos de resultados con los siguientes tipos de datos de SQL:

• binary
• varbinary
• char
• varchar
• nchar
• NVARCHAR
• smalldate
• date
• datetime
• datetime2
• datetimeoffset
• time
• Decimal
• NUMERIC
• FLOAT
• real
• bigint
• TINYINT
• SMALLINT
• int
• bigint
• bit
• money
• smallmoney

Ejemplos

A. Crear una tabla de Hadoop con CREATE EXTERNAL TABLE AS SELECT

Se aplica a: Azure Synapse Analytics y Sistema de la plataforma de análisis

En el siguiente ejemplo se crea una tabla externa denominada hdfsCustomer, usando para ello los datos y las definiciones de columna de la tabla de origen dimCustomer.

La definición de tabla se almacena en la base de datos y los resultados de la instrucción SELECT se exportan al archivo /pdwdata/customer.tbl en el origen de datos externo de Hadoop customer_ds. El archivo tiene un formato acorde al formato de archivo externo customer_ff.

La base de datos genera el nombre de archivo, que contiene el identificador de la consulta para que sea más fácil establecer una correlación entre el archivo y la consulta que lo generó.

La ruta de acceso hdfs://xxx.xxx.xxx.xxx:5000/files/ que precede al directorio Customer ya debe existir. Si no existe el directorio de cliente, la base de datos lo creará.

Nota:

En este ejemplo se especifica el puerto 5000. Si el puerto no se especifica, la base de datos usará 8020 como puerto predeterminado.

El nombre de archivo y ubicación de Hadoop resultantes serán hdfs:// xxx.xxx.xxx.xxx:5000/files/Customer/ QueryID_YearMonthDay_HourMinutesSeconds_FileIndex.txt..

-- Example is based on AdventureWorks
CREATE EXTERNAL TABLE hdfsCustomer
    WITH (
            LOCATION = '/pdwdata/customer.tbl',
            DATA_SOURCE = customer_ds,
            FILE_FORMAT = customer_ff
            ) AS

SELECT *
FROM dimCustomer;
GO

B. Usar una sugerencia de consulta con CREATE EXTERNAL TABLE AS SELECT

Se aplica a: Azure Synapse Analytics y Sistema de la plataforma de análisis

Esta consulta muestra la sintaxis básica para usar una sugerencia de combinación de consulta con la instrucción CREATE EXTERNAL TABLE AS SELECT. Después de enviar la consulta, la base de datos usa la estrategia de combinación hash para generar el plan de consulta. Para más información sobre las sugerencias de combinación y cómo usar la cláusula OPTION, consulte Cláusula OPTION (Transact-SQL).

Nota:

En este ejemplo se especifica el puerto 5000. Si el puerto no se especifica, la base de datos usará 8020 como puerto predeterminado.

-- Example is based on AdventureWorks
CREATE EXTERNAL TABLE dbo.FactInternetSalesNew
    WITH (
            LOCATION = '/files/Customer',
            DATA_SOURCE = customer_ds,
            FILE_FORMAT = customer_ff
            ) AS

SELECT T1.*
FROM dbo.FactInternetSales T1
INNER JOIN dbo.DimCustomer T2
    ON (T1.CustomerKey = T2.CustomerKey)
OPTION (HASH JOIN);
GO

C. Uso de CETAS para cambiar los atributos de columna

Se aplica a: Azure Synapse Analytics y Sistema de la plataforma de análisis

En este ejemplo se usa CETAS para cambiar los tipos de datos, la nulabilidad y la intercalación de varias columnas en la tabla FactInternetSales.

-- Example is based on AdventureWorks
CREATE EXTERNAL TABLE dbo.FactInternetSalesNew
    WITH (
            LOCATION = '/files/Customer',
            DATA_SOURCE = customer_ds,
            FILE_FORMAT = customer_ff
            ) AS

SELECT T1.ProductKey AS ProductKeyNoChange,
    T1.OrderDateKey AS OrderDate,
    T1.ShipDateKey AS ShipDate,
    T1.CustomerKey AS CustomerKeyNoChange,
    T1.OrderQuantity AS Quantity,
    T1.SalesAmount AS MONEY
FROM dbo.FactInternetSales T1
INNER JOIN dbo.DimCustomer T2
    ON (T1.CustomerKey = T2.CustomerKey)
OPTION (HASH JOIN);
GO

D. Uso de CREATE EXTERNAL TABLE AS SELECT al exportar datos como parquet

Se aplica a: SQL Server 2022 (16.x)

En el siguiente ejemplo se crea una tabla externa denominada ext_sales, usando para ello los datos de columna de la tabla SalesOrderDetail de AdventureWorks2022. La opción de configuración para permitir exportación de PolyBase debe estar habilitada.

El resultado de la instrucción SELECT se guardará en un almacenamiento de objetos compatible con S3 configurado previamente y denominado s3_eds, y se crearán las credenciales adecuadas como s3_dsc. La ubicación del archivo parquet será <ip>:<port>/cetas/sales.parquet donde cetas es el depósito de almacenamiento creado anteriormente.

Nota

El formato Delta solo se admite actualmente como de solo lectura.

-- Credential to access the S3-compatible object storage
CREATE DATABASE SCOPED CREDENTIAL s3_dsc
    WITH IDENTITY = 'S3 Access Key',
        SECRET = '<accesskeyid>:<secretkeyid>'
GO

-- S3-compatible object storage data source
CREATE EXTERNAL DATA SOURCE s3_eds
    WITH (
            LOCATION = 's3://<ip>:<port>',
            CREDENTIAL = s3_dsc
            )

-- External File Format for PARQUET
CREATE EXTERNAL FILE FORMAT ParquetFileFormat
    WITH (FORMAT_TYPE = PARQUET);
GO

CREATE EXTERNAL TABLE ext_sales
    WITH (
            LOCATION = '/cetas/sales.parquet',
            DATA_SOURCE = s3_eds,
            FILE_FORMAT = ParquetFileFormat
            ) AS

SELECT *
FROM AdventureWorks2022.[Sales].[SalesOrderDetail];
GO

E. Uso de CREATE EXTERNAL TABLE AS SELECT de la tabla delta a parquet

Se aplica a: SQL Server 2022 (16.x)

En el ejemplo siguiente se crea una nueva tabla externa denominada Delta_to_Parquet, que usa el tipo de la tabla Delta de los datos ubicados en un almacenamiento de objetos de compatible con S3 denominado s3_delta, y escribe el resultado en otro origen de datos denominado s3_parquet como un archivo parquet. Para ello, el ejemplo usa el comando OPENROWSET. La opción de configuración para permitir exportación de PolyBase debe estar habilitada.

-- External File Format for PARQUET
CREATE EXTERNAL FILE FORMAT ParquetFileFormat
    WITH (FORMAT_TYPE = PARQUET);
GO

CREATE EXTERNAL TABLE Delta_to_Parquet
    WITH (
            LOCATION = '/backup/sales.parquet',
            DATA_SOURCE = s3_parquet,
            FILE_FORMAT = ParquetFileFormat
            ) AS

SELECT *
FROM OPENROWSET(BULK '/delta/sales_fy22/', FORMAT = 'DELTA', DATA_SOURCE = 's3_delta') AS [r];
GO

F. Usar CREATE EXTERNAL TABLE AS SELECT con una vista como origen

Se aplica a: grupos de SQL dedicados y grupos de SQL sin servidor de Azure Synapse Analytics.

En este ejemplo, podemos ver un ejemplo de código de plantilla para escribir CETAS con una vista definida por el usuario como origen, mediante la identidad administrada como autenticación y wasbs:.

CREATE DATABASE [<mydatabase>];
GO

USE [<mydatabase>];
GO

CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<strong password>';

CREATE DATABASE SCOPED CREDENTIAL [WorkspaceIdentity] WITH IDENTITY = 'managed identity';
GO

CREATE EXTERNAL FILE FORMAT [ParquetFF] WITH (
    FORMAT_TYPE = PARQUET,
    DATA_COMPRESSION = 'org.apache.hadoop.io.compress.SnappyCodec'
);
GO

CREATE EXTERNAL DATA SOURCE [SynapseSQLwriteable] WITH (
    LOCATION = 'wasbs://<mystoageaccount>.dfs.core.windows.net/<mycontainer>/<mybaseoutputfolderpath>',
    CREDENTIAL = [WorkspaceIdentity]
);
GO

CREATE EXTERNAL TABLE [dbo].[<myexternaltable>] WITH (
        LOCATION = '<myoutputsubfolder>/',
        DATA_SOURCE = [SynapseSQLwriteable],
        FILE_FORMAT = [ParquetFF]
) AS
SELECT * FROM [<myview>];
GO

G. Usar CREATE EXTERNAL TABLE AS SELECT con una vista como origen

Se aplica a: grupos de SQL dedicados y grupos de SQL sin servidor de Azure Synapse Analytics.

En este ejemplo, podemos ver un ejemplo de código de plantilla para escribir CETAS con una vista definida por el usuario como origen, mediante la identidad administrada como autenticación y https:.

CREATE DATABASE [<mydatabase>];
GO

USE [<mydatabase>];
GO

CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<strong password>';

CREATE DATABASE SCOPED CREDENTIAL [WorkspaceIdentity] WITH IDENTITY = 'managed identity';
GO

CREATE EXTERNAL FILE FORMAT [ParquetFF] WITH (
    FORMAT_TYPE = PARQUET,
    DATA_COMPRESSION = 'org.apache.hadoop.io.compress.SnappyCodec'
);
GO

CREATE EXTERNAL DATA SOURCE [SynapseSQLwriteable] WITH (
    LOCATION = 'https://<mystoageaccount>.dfs.core.windows.net/<mycontainer>/<mybaseoutputfolderpath>',
    CREDENTIAL = [WorkspaceIdentity]
);
GO

CREATE EXTERNAL TABLE [dbo].[<myexternaltable>] WITH (
        LOCATION = '<myoutputsubfolder>/',
        DATA_SOURCE = [SynapseSQLwriteable],
        FILE_FORMAT = [ParquetFF]
) AS
SELECT * FROM [<myview>];
GO

Pasos siguientes

• CREATE EXTERNAL DATA SOURCE (Transact-SQL)
• CREATE EXTERNAL FILE FORMAT (Transact-SQL)
• CREATE EXTERNAL TABLE (Transact-SQL)
• CREATE TABLE (Azure Synapse Analytics y Almacenamiento de datos paralelos)
• CREATE TABLE AS SELECT (Azure Synapse Analytics)
• DROP TABLE (Transact-SQL)
• ALTER TABLE (Transact-SQL)