Especificar terminadores de campo y de fila

Para 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 los terminadores, ya que 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.

1 Sólo pueden utilizarse 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.

2 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.

Usar 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] Si utiliza 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 de \r\n.

Especificar terminadores para la exportación masiva

Cuando realice una exportación masiva de datos char o nchar y desee utilizar un terminador no predeterminado, deberá especificar el terminador para 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 información acerca de cómo utilizar archivos de formato, vea Archivos de formato para importar o exportar datos.

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

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

  • Utilizar 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, -w o -N), y ha decidido no especificar la longitud de prefijo ni la longitud de campo, el comando solicita el terminador de cada campo, con un valor predeterminado de ninguno:
    Enter field terminator [none]:
    Generalmente, el valor predeterminado es una opción apropiada. Sin embargo, para los campos de datos char o nchar, vea la siguiente subsección, "Directrices para utilizar terminadores". Para ver un ejemplo que muestre esta solicitud en contexto, vea Especificar formatos de datos por razones de compatibilidad mediante bcp.

    [!NOTA] Después de especificar de forma interactiva todos los campos de un comando bcp, el comando solicita sus respuestas para cada campo en un archivo con formato no de XML. Para obtener más información acerca de los archivos con formato no XML, vea Descripción de los archivos de formato no XML.

Directrices para utilizar terminadores

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

Ejemplos

En este ejemplo se exportan de forma masiva los datos de la tabla HumanResources.Department de AdventureWorks al archivo de datos Department-c-t.txt , utilizando el formato de caracteres, con una coma como terminador de campo y el carácter de nueva línea (\n) como terminador de fila. Para obtener más información acerca de esta tabla, vea Tabla Department (AdventureWorks).

El comando bcp contiene los siguientes modificadores:

Para obtener más información, vea bcp (utilidad).

En el símbolo del sistema de Microsoft Windows escriba:

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

Esto crea Department-c-t.txt, que contiene 16 registros con cuatro campos cada uno. Los campos se separan por el carácter de tabulación.

Especificar terminadores para la importación masiva

Cuando realice una importación masiva de datos char o nchar, el comando de importación masiva debe reconocer los terminadores que se utilizan 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 ='field_terminator'	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 ='row_terminator'	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 masivos OPENROWSET, los terminadores sólo 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 y Usar un archivo de formato para importar datos de forma masiva.
  Para obtener más información acerca de la cláusula OPENROWSET BULK, vea OPENROWSET (Transact-SQL).

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 AdventureWorks. 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 AdventureWorks;
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. Usar 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 escriba:

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

B. Usar 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:

En el Editor de consultas de SQL Server Management Studio, ejecute el siguiente código:

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

Vea también

Conceptos

Especificar la longitud de campo mediante bcp
Especificar longitud de prefijo en archivos de datos
Especificar el tipo de almacenamiento en archivo mediante bcp
Almacenamiento de datos en formato de caracteres

Otros recursos

bcp (utilidad)
BULK INSERT (Transact-SQL)
OPENROWSET (Transact-SQL)
RowDelimiter Property

Ayuda e información

Obtener ayuda sobre SQL Server 2005