Especificar terminadores de campo y de fila (SQL Server)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

En los campos de datos de caracteres, los caracteres de terminación opcionales permiten marcar el final de cada campo de un archivo de datos con un terminador de campo y el final de cada fila con un terminador de fila. Los caracteres de terminación son una forma de indicar a los programas que leen el archivo de datos dónde termina un campo o una fila y dónde comienza otro.

Importante

Cuando utilice el formato nativo o nativo Unicode, use prefijos de longitud en lugar de terminadores de campo. Los datos de formato nativo pueden entrar en conflicto con terminadores porque un archivo de datos de formato nativo se almacena en el formato de datos binario interno de Microsoft SQL Server.

Caracteres admitidos como terminadores

El comando bcp , la instrucción BULK INSERT y el proveedor de conjuntos de filas BULK OPENROWSET admiten una serie de caracteres como terminadores de campo o de fila y siempre buscan la primera instancia de cada terminador. La siguiente tabla enumera los caracteres admitidos como terminadores.

Carácter de terminación Indicado por
Tab \t

Terminador de campo predeterminado.
Carácter de nueva línea \n

Terminador de fila predeterminado.
Retorno de carro/avance de línea \r
Barra diagonal inversa* \|
Terminador NULL (terminador invisible)** \0
Cualquier carácter imprimible (los caracteres de control no se pueden imprimir, excepto los valores NULL, tabulaciones, caracteres de nueva línea y retornos de carro) (*, A, t, l, etc.)
Una cadena de hasta 10 caracteres imprimibles, incluidos algunos o todos los terminadores enumerados anteriormente (**\t**, end, !!!!!!!!!!, \t-\n, etc.)

*Solo pueden usarse los caracteres t, n, r, 0 y '\0' con el carácter de escape de barra diagonal inversa para crear un carácter de control.

**Aunque el carácter de control NULL (\0) no sea visible al imprimir, es un carácter distintivo en el archivo de datos. Esto significa que el uso del carácter de control NULL como terminador de campo o de fila es diferente a no tener ningún terminador de campo o de fila.

Importante

Si en los datos hay un carácter terminador, se interpreta como un terminador, no como datos, y se interpreta que los datos posteriores a ese carácter pertenecen al campo o registro siguiente. Por lo tanto, elija los terminadores con atención para asegurarse de que nunca aparezcan en los datos. Por ejemplo, un terminador de campo que funcione como suplente inferior no resultaría una buena opción para un terminador de campo si los datos contienen dicho suplente inferior.

Uso de terminadores de fila

El terminador de fila puede ser el mismo carácter que el terminador del último campo. Sin embargo, normalmente resulta útil un terminador de fila distinto. Por ejemplo, para generar un resultado en formato tabular, termine el último campo de cada fila con el carácter de nueva línea (\n) y todos los demás campos con el carácter de tabulación (\t). Para colocar cada registro de datos en su propia línea en el archivos de datos, especifique la combinación \r\n como terminador de fila.

Nota:

Cuando usa bcp en modo interactivo y especifica \n (nueva línea) como terminador de fila, bcp antepondrá automáticamente el carácter \r (retorno de carro) como prefijo, lo que genera un terminador de fila \r\n.

Especificación de terminadores para la exportación masiva

Cuando realiza una exportación masiva de datos char o nchar y quiere usar un terminador no predeterminado, deberá especificar el terminador en el comando bcp . Los terminadores se pueden especificar de cualquiera de las siguientes maneras:

  • Con un archivo de formato que especifica el terminador campo a campo.

    Nota:

    Para obtener más información sobre cómo usar archivos de formato, vea Archivos de formato para importar o exportar datos (SQL Server).

  • Sin un archivo de formato, existen las alternativas siguientes:

    • Usar el modificador -t para especificar el terminador de campo en todos los campos, excepto el último campo de la fila, y usar el modificador -r para especificar un terminador de fila.

    • Usar un modificador de formato de caracteres (-c o -w) sin el modificador -t , lo que establece el carácter de tabulación, \t, como terminador de campo. Esto equivale a especificar -t\t.

      Nota:

      Si se especifica el modificador -n (datos nativos) o -N (nativos Unicode), no se insertan los terminadores.

    • Si un comando bcp interactivo contiene la opción in o out sin el modificador de archivo de formato (-f) ni un modificador de formato de datos (-n, -c, -wo -N), y ha decidido no especificar la longitud de prefijo ni la longitud de campo, el comando solicita el terminador de cada campo, con el valor predeterminado "none":

      Enter field terminator [none]:

      Generalmente, el valor predeterminado es una opción apropiada. Sin embargo, para los campos de datos char o nchar, consulte la subsección siguiente, "Directrices para usar terminadores". Para ver un ejemplo que muestra este mensaje en contexto, consulteEspecificar formatos de datos para compatibilidad al usar bcp (SQL Server).

      Nota:

      Después de que se especifiquen de forma interactiva todos los campos de un comando bcp, el comando solicita que guarde sus respuestas para cada campo en un archivo que no tenga el formato XML. Para obtener más información sobre los archivos de formato no XML, vea Archivos de formato no XML (SQL Server).

Directrices para utilizar terminadores

En algunas situaciones, un terminador resulta útil para un campo de datos char o nchar . Por ejemplo:

  • En el caso de una columna de datos que contiene un valor NULL de un archivo de datos que se va a importar a un programa que no entiende la información sobre la longitud de prefijo.

    Cualquier columna de datos que contenga un valor NULL se considera de longitud variable. En ausencia de longitudes de prefijo, se necesita un terminador para identificar el final de un campo NULL, lo que garantiza la correcta interpretación de los datos.

  • En el caso de una columna de longitud fija larga cuyo espacio solo se utiliza parcialmente en numerosas filas.

    En este caso, si se especifica un terminador, se puede minimizar el espacio de almacenamiento, lo que permitiría que el campo fuera tratado como un campo de longitud variable.

Especificación de \n como terminador de fila para la exportación masiva

Al especificar \n como terminador de fila para la exportación masiva o usar de forma implícita el terminador de fila predeterminado, bcp da lugar a una combinación de retorno de carro y avance de línea (CRLF) como terminador de fila. Si desea generar un solo carácter de avance de línea (LF) como terminador de fila (como suele ocurrir en los equipos Unix y Linux), use la notación hexadecimal para especificar el terminador de fila de LF. Por ejemplo:

bcp -r '0x0A'

Ejemplos

En este ejemplo se exportan de forma masiva los datos de la tabla AdventureWorks.HumanResources.Department al archivo de datos Department-c-t.txt usando el formato de caracteres, con una coma como terminador de campo y el carácter de nueva línea (\n) como terminador de fila.

El comando bcp contiene los siguientes modificadores.

Switch Descripción
-c Especifica que los campos de datos se cargarán como datos de caracteres.
-t, Especifica una coma (,) como terminador de campo.
-r \n Especifica el terminador de fila como un carácter de nueva línea. Terminador de fila predeterminado, por lo que especificarlo es opcional.
-T Especifica que la utilidad bcp se conecta a SQL Server con una conexión de confianza utilizando la seguridad integrada. Si no se especifica -T , es necesario especificar -U y -P para iniciar sesión correctamente.

Para obtener más información, consulte bcp Utility.

En el símbolo del sistema de Microsoft Windows, especifique:

bcp AdventureWorks.HumanResources.Department out C:\myDepartment-c-t.txt -c -t, -r \n -T

Esto crea Department-c-t.txt, que contiene 16 registros con cuatro campos cada uno. Los campos se separan mediante una coma.

Especificación de terminadores para la importación masiva

Cuando realice una importación de datos en bloque char o nchar , el comando de importación en bloque debe reconocer los terminadores que se usan en el archivo de datos. La forma de especificar los terminadores depende del comando de importación masiva, tal como se indica a continuación:

  • bcp

    La especificación de terminadores para una operación de importación utiliza la misma sintaxis que para una operación de exportación. Para obtener más información, vea "Especificar terminadores para la exportación masiva" anteriormente en este tema.

  • BULK INSERT

    Los terminadores se pueden especificar para campos individuales en un archivo de formato o para todo el archivo de datos mediante los calificadores que figuran en la siguiente tabla:

    Calificador: Descripción
    FIELDTERMINATOR ="terminador_de_campo" Especifica el terminador de campo que se utilizará para los archivos de caracteres y de caracteres Unicode.

    El valor predeterminado es \t (carácter de tabulación).
    ROWTERMINATOR ="terminador_de_fila" Especifica el terminador de fila que se utilizará para los archivos de caracteres y de caracteres Unicode.

    El valor predeterminado es \n (carácter de nueva línea).

    Para obtener más información, vea BULK INSERT (Transact-SQL).

  • INSERT ... SELECT * FROM OPENROWSET(BULK...)

    Para el proveedor de conjuntos de filas BULK OPENROWSET, los terminadores solo se pueden especificar en el archivo de formato (necesario excepto para tipos de datos de objetos grandes). Si un archivo de caracteres utiliza un terminador no predeterminado, debe definirse en el archivo de formato. Para obtener más información, vea Crear un archivo de formato (SQL Server) y Usar un archivo de formato para importar datos en bloque (SQL Server).

    Para obtener más información sobre la cláusula OPENROWSET BULK, vea OPENROWSET (Transact-SQL).

Especificación de \n como terminador de fila para la importación masiva

Al especificar \n como terminador de fila para la importación masiva o usar de forma implícita el terminador de fila predeterminado, bcp y la instrucción BULK INSERT esperan una combinación de retorno de carro y avance de línea (CRLF) como terminador de fila. Si su archivo de origen usa un solo carácter de avance de línea (LF) como terminador de fila (como suele ocurrir en los archivos generados en los equipos Unix y Linux), use la notación hexadecimal para especificar el terminador de fila de LF. Por ejemplo, en una instrucción BULK INSERT:

 ROWTERMINATOR = '0x0A'

Ejemplos

En los ejemplos de esta sección se importan de forma masiva caracteres del archivo de datos Department-c-t.txt creado en el ejemplo anterior en la tabla myDepartment de la base de datos de ejemplo AdventureWorks2022 . Antes de poder ejecutar los ejemplos, debe crear esta tabla. Para crear esta tabla en el esquema dbo, en el Editor de consultas de SQL Server Management Studio, ejecute el siguiente código:

USE AdventureWorks2022;
GO
DROP TABLE myDepartment;
CREATE TABLE myDepartment
(DepartmentID smallint,
Name nvarchar(50),
GroupName nvarchar(50) NULL,
ModifiedDate datetime not NULL CONSTRAINT DF_AddressType_ModifiedDate DEFAULT (GETDATE())
);
GO

A Uso de bcp para especificar terminadores interactivamente

En el ejemplo siguiente se importa de forma masiva el archivo de datos Department-c-t.txt mediante un comando bcp . Este comando utiliza los mismos modificadores de comando que el comando de exportación masiva. Para obtener más información, vea "Especificar terminadores para la exportación masiva" anteriormente en este tema.

En el símbolo del sistema de Windows, especifique:

bcp AdventureWorks2022..myDepartment in C:\myDepartment-c-t.txt -c -t , -r \n -T

B. Uso de BULK INSERT para especificar terminadores interactivamente

En el ejemplo siguiente se importa de forma masiva el archivo de datos Department-c-t.txt mediante una instrucción BULK INSERT que utiliza los calificadores que figuran en la siguiente tabla:

Opción Atributo
DATAFILETYPE ='char' Especifica que los campos de datos se cargarán como datos de caracteres.
FIELDTERMINATOR =',' Especifica una coma (,) como terminador de campo.
ROWTERMINATOR ='\n' Especifica el terminador de fila como un carácter de nueva línea.

Ejecute el código siguiente en el Editor de consultas de SQL Server Management Studio:

USE AdventureWorks2022;
GO
BULK INSERT myDepartment FROM 'C:\myDepartment-c-t.txt'
     WITH (
     DATAFILETYPE = 'char',
     FIELDTERMINATOR = ',',
     ROWTERMINATOR = '\n'
);
GO

Pasos siguientes