OPENROWSET BULK (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Un OPENROWSET comando T-SQL incluye toda la información de conexión necesaria para acceder a datos remotos desde un origen de datos externo. OPENROWSET también admite operaciones masivas a través de un proveedor BULK integrado, que permite que los datos se lean y se devuelvan como un conjunto de filas. OPENROWSET BULK es para leer archivos de datos externos, OPENROWSET sin bulk es para leer desde otro motor de base de datos.

Se OPENROWSET puede hacer referencia a la función en la FROM cláusula de una consulta como si fuera un nombre de tabla. También OPENROWSET se puede hacer referencia a la función como destino de una INSERTinstrucción , UPDATEo DELETE , sujeto a las funcionalidades del proveedor de datos. Aunque la consulta puede devolver varios conjuntos de resultados, OPENROWSET solo devuelve el primero.

OPENROWSET sin el BULK operador solo está disponible en SQL Server, para obtener más información, vea OPENROWSET (Transact-SQL).

Detalles y vínculos a ejemplos similares en otras plataformas:

• En Sintaxis de Microsoft Fabric Data Warehouse, seleccione Fabric en la lista desplegable versión.
• Para obtener ejemplos sobre Azure SQL Instancia administrada, consulte Consulta de orígenes de datos mediante OPENROWSET.
• Para obtener información y ejemplos con grupos de SQL sin servidor en Azure Synapse, consulte Uso de OPENROWSET mediante el grupo de SQL sin servidor en Azure Synapse Analytics.
• Los grupos de SQL dedicados en Azure Synapse no admiten la OPENROWSET función.

Convenciones de sintaxis de Transact-SQL

Sintaxis

OPENROWSET(BULK) La sintaxis se usa para leer archivos externos:

OPENROWSET( BULK 'data_file' ,
            { FORMATFILE = 'format_file_path' [ <bulk_options> ]
              | SINGLE_BLOB | SINGLE_CLOB | SINGLE_NCLOB }
)

<bulk_options> ::=
   [ , DATA_SOURCE = 'data_source_name' ]

   -- bulk_options related to input file format
   [ , CODEPAGE = { 'ACP' | 'OEM' | 'RAW' | 'code_page' } ]
   [ , FORMAT = { 'CSV' | 'PARQUET' | 'DELTA' } ]
   [ , FIELDQUOTE = 'quote_character' ]
   [ , FORMATFILE = 'format_file_path' ]
   [ , FORMATFILE_DATA_SOURCE = 'data_source_name' ]

   [ , FIRSTROW = first_row ]
   [ , LASTROW = last_row ]

   [ , MAXERRORS = maximum_errors ]
   [ , ERRORFILE = 'file_name' ]
   [ , ERRORFILE_DATA_SOURCE = 'data_source_name' ]

   [ , ROWS_PER_BATCH = rows_per_batch ]
   [ , ORDER ( { column [ ASC | DESC ] } [ , ...n ] ) [ UNIQUE ] ]

Argumentos

Argumentos BULK

Usa el proveedor de BULK conjuntos de filas para OPENROWSET leer datos de un archivo. En SQL Server, OPENROWSET puede leer desde un archivo de datos sin cargar los datos en una tabla de destino. Esto le permite usar OPENROWSET con una instrucción básica SELECT .

Los argumentos de la BULK opción permiten un control significativo sobre dónde empezar y finalizar la lectura de datos, cómo tratar los errores y cómo se interpretan los datos. Por ejemplo, puede especificar que el archivo de datos se lea como un conjunto de filas de una sola fila de tipo varbinary, varchar o nvarchar. El comportamiento predeterminado se describe en las descripciones de los argumentos que se muestran a continuación.

Para obtener información sobre cómo usar la BULK opción , vea la sección Comentarios más adelante en este artículo. Para obtener información sobre los permisos que requiere la BULK opción, consulte la sección Permisos , más adelante en este artículo.

Nota:

Cuando se usa para importar datos con el modelo de recuperación completa, OPENROWSET (BULK ...) no optimiza el registro.

Para obtener información sobre cómo preparar los datos para la importación masiva, consulte Preparación de datos para la exportación o importación masiva.

BULK "archivo_de_datos"

Ruta de acceso completa del archivo de datos cuyos datos se van a copiar en la tabla de destino.

SELECT * FROM OPENROWSET(
   BULK 'C:\DATA\inv-2017-01-19.csv',
   SINGLE_CLOB
) AS DATA;

A partir de SQL Server 2017 (14.x), data_file puede estar en Azure Blob Storage. Para obtener ejemplos, consulte Ejemplos de acceso masivo a los datos en Azure Blob Storage.

Opciones de control de errores BULK

ERRORFILE = "file_name"

Especifica el archivo utilizado para recopilar filas que tienen errores de formato y no pueden convertirse en un conjunto de filas OLE DB. Estas filas se copian en este archivo de errores desde el archivo de datos "tal cual".

El archivo de errores se crea cuando se inicia la ejecución del comando. Se produce un error si el archivo ya existe. Además, se crea un archivo de control con la extensión .ERROR.txt. Este archivo hace referencia a cada una de las filas del archivo de errores y proporciona diagnósticos de errores. Una vez corregidos los errores, se pueden cargar los datos.

A partir de SQL Server 2017 (14.x), error_file_path puede estar en Azure Blob Storage.

ERRORFILE_DATA_SOURCE_NAME

A partir de SQL Server 2017 (14.x), este argumento es un origen de datos externo denominado que apunta a la ubicación de Azure Blob Storage del archivo de error que contendrá errores encontrados durante la importación. El origen de datos externo se debe crear con la opción TYPE = BLOB_STORAGE. Para obtener más información, vea CREATE EXTERNAL DATA SOURCE (Transact-SQL).

MAXERRORS = maximum_errors

Especifica el número máximo de errores de sintaxis o filas no conformes, tal como se define en el archivo de formato, que puede producirse antes OPENROWSET de producir una excepción. Hasta MAXERRORS que se alcanza, OPENROWSET omite cada fila incorrecta, no la carga y cuenta la fila incorrecta como un error.

El valor predeterminado de maximum_errors es 10.

Nota:

MAX_ERRORS no se aplica a CHECK restricciones ni a la conversión de tipos de datos money y bigint .

Opciones de procesamiento de datos BULK

DATA_SOURCE

DATA_SOURCE es la ubicación externa creada con CREATE EXTERNAL DATA SOURCE.

FIRSTROW = first_row

Especifica el número de la primera fila que se va a cargar. El valor predeterminado es 1. Indica la primera fila del archivo de datos especificado. Los números de fila vienen determinados por el recuento de terminadores de fila. FIRSTROW está basado en 1.

LASTROW = last_row

Especifica el número de la última fila que va a cargarse. El valor predeterminado es 0. Indica la última fila del archivo de datos especificado.

ROWS_PER_BATCH = rows_per_batch

Especifica el número aproximado de filas de datos del archivo de datos. Este valor debe ser del mismo tipo que el número de filas real.

OPENROWSET siempre importa un archivo de datos como un solo lote. Con todo, si especifica rows_per_batch con un valor > 0, el procesador de consulta usará el valor de rows_per_batch como sugerencia para asignar recursos en el plan de consulta.

De forma predeterminada, ROWS_PER_BATCH es desconocido. Especificar ROWS_PER_BATCH = 0 es el mismo que omitir ROWS_PER_BATCH.

ORDER ( { column [ ASC | DESC ] } [ ,... n ] [ UNIQUE ] )

Sugerencia opcional que especifica la forma en que están ordenados los datos en el archivo. De forma predeterminada, la operación masiva presupone que los datos del archivo no están ordenados. El rendimiento puede mejorar si el optimizador de consultas puede aprovechar el orden de generar un plan de consulta más eficaz. En la lista siguiente se proporcionan ejemplos para cuando se especifica una ordenación puede ser beneficioso:

• La inserción de filas en una tabla que tiene un índice clúster, donde los datos del conjunto de filas están ordenados en la clave del índice clúster.
• La combinación del conjunto de filas con otra tabla, donde las columnas de ordenación y combinación coinciden.
• La agregación de los datos del conjunto de filas por las columnas de ordenación.
• Usar el conjunto de filas como una tabla de origen en la FROM cláusula de una consulta, donde coinciden las columnas de ordenación y combinación.

ÚNICO

Especifica que el archivo de datos no tiene entradas duplicadas.

Si las filas reales del archivo de datos no se ordenan según el orden especificado, o si se especifica la UNIQUE sugerencia y las claves duplicadas están presentes, se devuelve un error.

Los alias de columna son necesarios cuando ORDER se usa. La lista de alias de columna debe hacer referencia a la tabla derivada a la que accede la BULK cláusula . Los nombres de columna especificados en la ORDER cláusula hacen referencia a esta lista de alias de columna. Los tipos de valores grandes (varchar(max), nvarchar(max), varbinary(max)y xml) y los tipos de objetos grandes (LOB) (text, ntext e image) no se pueden especificar.

SINGLE_BLOB

Devuelve el contenido de data_file como un conjunto de filas de una sola columna y una sola fila de tipo varbinary(max) .

Importante

Se recomienda importar datos XML solo con la SINGLE_BLOB opción , en lugar de SINGLE_CLOB y SINGLE_NCLOB, porque solo SINGLE_BLOB admite todas las conversiones de codificación de Windows.

SINGLE_CLOB

Al leer data_file como ASCII, el contenido se devuelve como un conjunto de filas de tipo varchar(max) de una sola fila y una sola columna, por medio de la intercalación de la base de datos actual.

SINGLE_NCLOB

Al leer data_file como Unicode, devuelve el contenido como un conjunto de filas de una sola fila de tipo nvarchar(max), mediante la intercalación de la base de datos actual.

SELECT * FROM OPENROWSET(
    BULK N'C:\Text1.txt',
    SINGLE_NCLOB
) AS Document;

Opciones de formato de archivo de entrada BULK

CODEPAGE = { 'ACP' | 'OEM' | 'RAW' | 'code_page' }

Especifica la página de códigos de los datos incluidos en el archivo de datos. CODEPAGE solo es relevante si los datos contienen columnas char, varchar o text con valores de caracteres superiores a 127 o menos de 32.

Importante

CODEPAGE no es una opción compatible en Linux.

Nota:

Se recomienda especificar un nombre de intercalación para cada columna en un archivo de formato, excepto cuando quiera que la opción 65001 tenga prioridad sobre la especificación de la página de códigos o la intercalación.

Valor de CODEPAGE	Descripción
ACP	Convierte columnas de los tipos de datos char, varchar o text de la página de códigos ANSI/Microsoft Windows (ISO 1252) a la página de códigos de SQL Server.
OEM (valor predeterminado)	Convierte columnas de los tipos de datos char, varchar o text de la página de códigos OEM del sistema a la página de códigos de SQL Server.
RAW	No se realiza ninguna conversión entre páginas de códigos. Ésta es la opción más rápida.
code_page	Indica la página de códigos original en la que se codifican los datos de caracteres incluidos en el archivo de datos; por ejemplo, 850. Las versiones importantes anteriores a SQL Server 2016 (13.x) no admiten la página de códigos 65001 (codificación UTF-8).

FORMAT = { 'CSV' | 'PARQUET' | 'DELTA' }

A partir de SQL Server 2017 (14.x), este argumento especifica un archivo de valores separados por comas compatible con el estándar RFC 4180 .

A partir de SQL Server 2022 (16.x), se admiten los formatos Parquet y Delta.

SELECT *
FROM OPENROWSET(BULK N'D:\XChange\test-csv.csv',
    FORMATFILE = N'D:\XChange\test-csv.fmt',
    FIRSTROW=2,
    FORMAT='CSV') AS cars;

FORMATFILE = "format_file_path"

Especifica la ruta de acceso completa de un archivo de formato. SQL Server admite dos tipos de archivos de formato: XML y no XML.

Es necesario usar un archivo de formato para definir los tipos de columna del conjunto de resultados. La única excepción es cuando SINGLE_CLOBse especifica , SINGLE_BLOBo SINGLE_NCLOB ; en cuyo caso, el archivo de formato no es necesario.

Para obtener información sobre los archivos de formato, vea Usar un archivo de formato para importar datos de forma masiva (SQL Server).

A partir de SQL Server 2017 (14.x), el valor de format_file_path puede estar en Azure Blob Storage. Para obtener ejemplos, consulte Ejemplos de acceso masivo a los datos en Azure Blob Storage.

FIELDQUOTE = 'field_quote'

A partir de SQL Server 2017 (14.x), este argumento especifica un carácter que se usa como carácter de comilla en el archivo CSV. Si no se especifica, el carácter de comillas (") se usa como carácter de comilla tal como se define en el estándar RFC 4180 . Solo se puede especificar un solo carácter como valor para esta opción.

Observaciones

OPENROWSET se puede usar para acceder a datos remotos desde orígenes de datos OLE DB solo cuando la opción Registro DisallowAdhocAccess se establece 0 explícitamente en para el proveedor especificado y la opción de configuración avanzada Consultas distribuidas Ad Hoc está habilitada. Cuando no se establecen estas opciones, el comportamiento predeterminado no permite el acceso ad hoc.

Al acceder a orígenes de datos OLE DB remotos, la identidad de inicio de sesión de las conexiones de confianza no se delega automáticamente desde el servidor en el que el cliente está conectado al servidor que se está consultando. Debe configurarse la delegación de autenticación.

Los nombres de catálogo y esquema son necesarios si el proveedor de datos admite varios catálogos y esquemas en el origen de datos especificado. Los valores de catalog y schema se pueden omitir cuando el proveedor de datos no los admite. Si el proveedor solo admite nombres de esquema, se debe especificar un nombre de dos partes del formulario schema.object . Si el proveedor solo admite nombres de catálogo, se debe especificar un nombre de tres partes del formulario catalog.schema.object . Para más información, vea Convenciones de sintaxis de Transact-SQL.

Es necesario especificar nombres de tres partes para las consultas de paso a través que usen el proveedor OLE DB de SQL Server Native Client.

OPENROWSET no acepta variables para sus argumentos.

Las llamadas a OPENDATASOURCE, OPENQUERY o OPENROWSET en la cláusula FROM se evalúan por separado y de forma independiente de otras llamadas a estas funciones usadas como destino de la actualización, incluso si se han suministrado argumentos idénticos a las dos llamadas. En particular, las condiciones de filtro o combinación aplicadas en el resultado de una de esas llamadas no tienen ningún efecto en los resultados de la otra llamada.

Uso de OPENROWSET con la opción BULK

Las siguientes mejoras de Transact-SQL admiten la OPENROWSET(BULK...) función :

• Las cláusulas FROM que se usan con SELECT pueden llamar a OPENROWSET(BULK...) en lugar de indicar un nombre de tabla, con toda la funcionalidad de SELECT.

  OPENROWSET con la opción BULK requiere un nombre de correlación en la cláusula FROM, que también recibe el nombre de alias o variable de intervalo. Pueden especificarse alias de columna. Si no se especifica una lista de alias de columna, el archivo de formato debe tener nombres de columna. Al especificar alias de columnas se anulan los nombres de columnas en el archivo de formato:

  • FROM OPENROWSET(BULK...) AS table_alias
  • FROM OPENROWSET(BULK...) AS table_alias(column_alias,...n)

  Importante

  Si AS <table_alias> no se puede agregar, se producirá el error: Msg 491, Level 16, State 1, Line 20 Se debe especificar un nombre de correlación para el conjunto de filas masivo en la cláusula FROM.

• Una instrucción SELECT...FROM OPENROWSET(BULK...) consulta los datos directamente en el archivo, sin importar los datos a una tabla. Las instrucciones SELECT...FROM OPENROWSET(BULK...) también pueden mostrar los alias de las columnas masivas usando un archivo de formato para especificar los nombres de las columnas y también los tipos de datos.

• Usar OPENROWSET(BULK...) como tabla de origen en una instrucción INSERT o MERGE permite realizar una importación masiva desde un archivo de datos a una tabla de SQL Server. Para obtener más información, vea Usar BULK INSERT o OPENROWSET(BULK...) para importar datos a SQL Server.

• Cuando se usa la OPENROWSET BULK opción con una INSERT instrucción , la BULK cláusula admite sugerencias de tabla. Además de las sugerencias de tabla normales, como TABLOCK, la cláusula BULK puede aceptar las sugerencias de tablas especializadas siguientes: IGNORE_CONSTRAINTS (solo pasa por alto las restricciones CHECK y FOREIGN KEY), IGNORE_TRIGGERS, KEEPDEFAULTS y KEEPIDENTITY. Para obtener más información, vea Sugerencias de tabla (Transact-SQL).

  Para más información sobre cómo usar las instrucciones INSERT...SELECT * FROM OPENROWSET(BULK...), vea Importar y exportar datos de forma masiva (SQL Server). Para obtener más información sobre cuándo se incluyen en el registro de transacciones las operaciones de inserción de filas que se efectúan durante una importación en bloque, vea Requisitos previos para el registro mínimo durante la importación en bloque.

Nota:

Cuando se usa OPENROWSET, es importante comprender cómo ADMINISTRA SQL Server la suplantación. Para obtener información sobre las consideraciones de seguridad, vea Usar BULK INSERT o OPENROWSET(BULK...) para importar datos a SQL Server.

Importación masiva de datos SQLCHAR, SQLNCHAR o SQLBINARY

OPENROWSET(BULK...) supone que, si no se especifica, la longitud máxima de SQLCHARlos datos , SQLNCHARo SQLBINARY no supera los 8000 bytes. Si los datos que se importan están en un campo de datos LOB que contiene cualquier objeto varchar(max), nvarchar(max)o varbinary(max) que supere los 8000 bytes, debe usar un archivo de formato XML que defina la longitud máxima para el campo de datos. Para especificar la longitud máxima, edite el archivo de formato y declare el atributo MAX_LENGTH.

Nota:

Un archivo de formato generado automáticamente no especifica la longitud ni la longitud máxima de un campo LOB. Sin embargo, es posible editar un archivo de formato y especificar la longitud o la longitud máxima manualmente.

Exportación o importación masiva de documentos SQLXML

Para importar o exportar de forma masiva datos SQLXML, utilice uno de los tipos de datos siguientes en el archivo de formato.

Tipo de dato	Efecto
SQLCHAR o SQLVARYCHAR	Los datos se envían en la página de códigos del cliente o en la página de códigos implícita por la intercalación.
SQLNCHAR o SQLNVARCHAR	Los datos se envían como datos Unicode.
SQLBINARY o SQLVARYBIN	Los datos se envían sin realizar ninguna conversión.

Permisos

OPENROWSET los permisos se determinan mediante los permisos del nombre de usuario que se pasa al proveedor de datos. Para poder usar la opción BULK, se necesita el permiso ADMINISTER BULK OPERATIONS o ADMINISTER DATABASE BULK OPERATIONS.

Ejemplos

En esta sección se proporcionan ejemplos generales para demostrar cómo usar OPENROWSET BULK la sintaxis.

Un. Uso de OPENROWSET para datos de archivo BULK INSERT en una columna varbinary(max)

Solo se aplica a: SQL Server.

En el ejemplo siguiente se crea una tabla pequeña con fines de demostración e inserta datos de archivo de un archivo denominado Text1.txt ubicado en el C: directorio raíz en una columna varbinary(max).

CREATE TABLE myTable (
    FileName NVARCHAR(60),
    FileType NVARCHAR(60),
    Document VARBINARY(MAX)
);
GO

INSERT INTO myTable (
    FileName,
    FileType,
    Document
)
SELECT 'Text1.txt' AS FileName,
    '.txt' AS FileType,
    *
FROM OPENROWSET(
    BULK N'C:\Text1.txt',
    SINGLE_BLOB
) AS Document;
GO

B. Usar el proveedor BULK OPENROWSET con un archivo de formato para recuperar filas de un archivo de texto

Solo se aplica a: SQL Server.

En el ejemplo siguiente se utiliza un archivo de formato para recuperar filas de un archivo de texto delimitado por tabuladores, values.txt, que contiene los datos siguientes:

1     Data Item 1
2     Data Item 2
3     Data Item 3

El archivo de formato, values.fmt, describe las columnas en values.txt:

9.0
2
1  SQLCHAR  0  10 "\t"    1  ID           SQL_Latin1_General_Cp437_BIN
2  SQLCHAR  0  40 "\r\n"  2  Description  SQL_Latin1_General_Cp437_BIN

Esta consulta recupera los datos:

SELECT a.* FROM OPENROWSET(
    BULK 'C:\test\values.txt',
   FORMATFILE = 'C:\test\values.fmt'
) AS a;

C. Especificar un archivo de formato y una página de códigos

Solo se aplica a: SQL Server.

En el ejemplo siguiente se muestra cómo usar las opciones de archivo de formato y página de códigos al mismo tiempo.

INSERT INTO MyTable
SELECT a.* FROM OPENROWSET (
    BULK N'D:\data.csv',
    FORMATFILE = 'D:\format_no_collation.txt',
    CODEPAGE = '65001'
) AS a;

D. Acceso a datos desde un archivo CSV con un archivo de formato

Se aplica a: SQL Server 2017 (14.x) y versiones posteriores solo.

SELECT * FROM OPENROWSET(
    BULK N'D:\XChange\test-csv.csv',
    FORMATFILE = N'D:\XChange\test-csv.fmt',
    FIRSTROW = 2,
    FORMAT = 'CSV'
) AS cars;

E. Acceso a datos desde un archivo CSV sin un archivo de formato

Solo se aplica a: SQL Server.

SELECT * FROM OPENROWSET(
   BULK 'C:\Program Files\Microsoft SQL Server\MSSQL14.CTP1_1\MSSQL\DATA\inv-2017-01-19.csv',
   SINGLE_CLOB
) AS DATA;

SELECT *
FROM OPENROWSET('MSDASQL',
    'Driver={Microsoft Access Text Driver (*.txt, *.csv)}',
    'SELECT * FROM E:\Tlog\TerritoryData.csv'
);

Importante

El controlador ODBC debe ser de 64 bits. Abra la pestaña Controladores de la aplicación Conectar a un origen de datos ODBC (Asistente para importación y exportación de SQL Server) en Windows para comprobarlo. Hay 32 bits Microsoft Text Driver (*.txt, *.csv) que no funcionarán con una versión de 64 bits de sqlservr.exe.

F. Acceso a datos desde un archivo almacenado en Azure Blob Storage

Se aplica a: SQL Server 2017 (14.x) y versiones posteriores solo.

En SQL Server 2017 (14.x) y versiones posteriores, en el ejemplo siguiente se usa un origen de datos externo que apunta a un contenedor de una cuenta de almacenamiento de Azure y una credencial con ámbito de base de datos creada para una firma de acceso compartido.

SELECT * FROM OPENROWSET(
   BULK 'inv-2017-01-19.csv',
   DATA_SOURCE = 'MyAzureInvoices',
   SINGLE_CLOB
) AS DataFile;

Para obtener ejemplos completos OPENROWSET , incluida la configuración de las credenciales y el origen de datos externo, consulte Ejemplos de acceso masivo a los datos en Azure Blob Storage.

G. Importación en una tabla desde un archivo almacenado en Azure Blob Storage

En el ejemplo siguiente se muestra cómo usar el OPENROWSET comando para cargar datos desde un archivo csv en una ubicación de Azure Blob Storage en la que creó la clave SAS. La ubicación de Azure Blob Storage está configurada como origen de datos externo. Esto requiere credenciales con ámbito de base de datos mediante una firma de acceso compartido que se cifra con una clave maestra en la base de datos de usuario.

-- Optional: a MASTER KEY is not required if a DATABASE SCOPED CREDENTIAL is not required because the blob is configured for public (anonymous) access!
CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<password>';
GO

-- Optional: a DATABASE SCOPED CREDENTIAL is not required because the blob is configured for public (anonymous) access!
CREATE DATABASE SCOPED CREDENTIAL MyAzureBlobStorageCredential
    WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
    SECRET = '******srt=sco&sp=rwac&se=2017-02-01T00:55:34Z&st=2016-12-29T16:55:34Z***************';

-- Make sure that you don't have a leading ? in the SAS token, and that you
-- have at least read permission on the object that should be loaded srt=o&sp=r,
-- and that expiration period is valid (all dates are in UTC time)
CREATE EXTERNAL DATA SOURCE MyAzureBlobStorage
WITH (
    TYPE = BLOB_STORAGE,
    LOCATION = 'https://****************.blob.core.windows.net/curriculum',
    -- CREDENTIAL is not required if a blob is configured for public (anonymous) access!
    CREDENTIAL = MyAzureBlobStorageCredential
);

INSERT INTO achievements
WITH (TABLOCK) (
    id,
    description
)
SELECT * FROM OPENROWSET(
    BULK 'csv/achievements.csv',
    DATA_SOURCE = 'MyAzureBlobStorage',
    FORMAT = 'CSV',
    FORMATFILE = 'csv/achievements-c.xml',
    FORMATFILE_DATA_SOURCE = 'MyAzureBlobStorage'
) AS DataFile;

H. Uso de una identidad administrada para un origen externo

se aplica a: Instancia administrada de Azure SQL y Azure SQL Database

En el ejemplo siguiente se crea una credencial mediante una identidad administrada, se crea un origen externo y, después, se cargan datos de un archivo CSV hospedado en el origen externo.

En primer lugar, cree la credencial y especifique Blob Storage como origen externo:

CREATE DATABASE SCOPED CREDENTIAL sampletestcred
WITH IDENTITY = 'MANAGED IDENTITY';

CREATE EXTERNAL DATA SOURCE SampleSource
WITH (
    LOCATION = 'abs://****************.blob.core.windows.net/curriculum',
    CREDENTIAL = sampletestcred
);

Después, cargue datos del archivo CSV hospedado en Blob Storage:

SELECT * FROM OPENROWSET(
    BULK 'Test - Copy.csv',
    DATA_SOURCE = 'SampleSource',
    SINGLE_CLOB
) as test;

Yo. Uso de OPENROWSET para acceder a varios archivos Parquet mediante el almacenamiento de objetos compatible con S3

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

En el ejemplo siguiente se usa el acceso a varios archivos Parquet desde una ubicación diferente, todos almacenados en el almacenamiento de objetos compatible con S3:

CREATE DATABASE SCOPED CREDENTIAL s3_dsc
WITH IDENTITY = 'S3 Access Key',
SECRET = 'contosoadmin:contosopwd';
GO

CREATE EXTERNAL DATA SOURCE s3_eds
WITH
(
    LOCATION = 's3://10.199.40.235:9000/movies',
    CREDENTIAL = s3_dsc
);
GO

SELECT * FROM OPENROWSET(
    BULK (
        '/decades/1950s/*.parquet',
        '/decades/1960s/*.parquet',
        '/decades/1970s/*.parquet'
    ),
    FORMAT = 'PARQUET',
    DATA_SOURCE = 's3_eds'
) AS data;

J. Uso de OPENROWSET para acceder a varias tablas Delta desde Azure Data Lake Gen2

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

En este ejemplo, el contenedor de tabla de datos se denomina Contoso y se encuentra en una cuenta de almacenamiento de Azure Data Lake Gen2.

CREATE DATABASE SCOPED CREDENTIAL delta_storage_dsc
WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
SECRET = '<SAS Token>';

CREATE EXTERNAL DATA SOURCE Delta_ED
WITH (
    LOCATION = 'adls://<container>@<storage_account>.dfs.core.windows.net',
    CREDENTIAL = delta_storage_dsc
);

SELECT *
FROM OPENROWSET(
    BULK '/Contoso',
    FORMAT = 'DELTA',
    DATA_SOURCE = 'Delta_ED'
) AS result;

K. Uso de OPENROWSET para consultar el conjunto de datos público anónimo

En el ejemplo siguiente se usa el conjunto de datos abierto de registros de carreras de taxi amarillo de Nueva York disponibles públicamente.

Cree primero el origen de datos:

CREATE EXTERNAL DATA SOURCE NYCTaxiExternalDataSource
WITH (LOCATION = 'abs://nyctlc@azureopendatastorage.blob.core.windows.net');

Consulte todos los archivos con la extensión .parquet en carpetas que coincidan con el patrón de nombre:

SELECT TOP 10 *
FROM OPENROWSET(
 BULK 'yellow/puYear=*/puMonth=*/*.parquet',
 DATA_SOURCE = 'NYCTaxiExternalDataSource',
 FORMAT = 'parquet'
) AS filerows;

Más ejemplos

Para obtener más ejemplos que muestran el uso INSERT...SELECT * FROM OPENROWSET(BULK...)de , consulte los artículos siguientes:

• Ejemplos de importación y exportación en bloque de documentos XML (SQL Server)
• Mantenimiento de valores de identidad al importar datos en bloque (SQL Server)
• Mantenimiento de valores NULL o predeterminados durante la importación en bloque (SQL Server)
• Uso de un archivo de formato para la importación en bloque de datos (SQL Server)
• Uso del formato de caracteres para importar o exportar datos (SQL Server)
• Usar un archivo de formato para omitir una columna de tabla (SQL Server)
• Uso de un archivo de formato para omitir un campo de datos (SQL Server)
• Uso de un archivo de formato para asignar columnas de tabla a campos de un archivo de datos (SQL Server)
• Consulta de orígenes de datos mediante OPENROWSET en Instancia administrada de Azure SQL

Contenido relacionado

• DELETE (Transact-SQL)
• Cláusula FROM más JOIN, APPLY, PIVOT (Transact-SQL)
• Importar y exportar datos de forma masiva (SQL Server)
• INSERT (Transact-SQL)
• OPENDATASOURCE (Transact-SQL)
• OPENQUERY (Transact-SQL)
• SELECT (Transact-SQL)
• sp_serveroption (Transact-SQL)
• UPDATE (Transact-SQL)
• DONDE (Transact-SQL)