Crear un archivo de formato (SQL Server)

Se aplica a: SQL Server (todas las versiones admitidas) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

En este artículo se describe cómo usar la utilidad bcp para crear un archivo de formato para una tabla determinada. El archivo de formato se basa en la opción de tipo de datos especificada ( -n, -c, -wo -N) y en los delimitadores de la vista o de la tabla.

Cuando se realiza una importación masiva de datos en una tabla de SQL Server o una exportación masiva de datos desde una tabla, se puede utilizar un archivo de formato para un sistema flexible de escribir archivos de datos que requiera poca o ninguna modificación para adaptarlos a otros formatos de datos o para leer archivos de datos de otros programas de software.

SQL Server admite dos tipos de archivos de formato: XML y no XML. El formato no XML es el formato original compatible con versiones anteriores de SQL Server.

Por lo general, los archivos de formato XML y no XML son intercambiables. Sin embargo, es recomendable utilizar la sintaxis XML para los nuevos archivos de formato porque proporciona varias ventajas con relación a los archivos de formato no XML.

Nota

La versión de la utilidad bcp (Bcp.exe) que se emplee para leer un archivo de formato debe ser la misma versión, o una versión posterior, a la que se use para crear el archivo de formato. Por ejemplo, bcp de SQL Server 2012 (11.x) puede leer un archivo de formato de la versión 10.0 generado por bcp de SQL Server 2008, pero bcp de SQL Server 2008 no puede leer un archivo de formato de la versión 11.0 generado por bcp de SQL Server 2012 (11.x).

Nota

Esta sintaxis, incluida la inserción masiva, no se admite en Azure Synapse Analytics. En Azure Synapse Analytics y otras integraciones de la plataforma de base de datos en la nube, realice el movimiento de datos a través de la instrucción COPY en Azure Data Factory o mediante instrucciones T-SQL como COPY INTO y PolyBase.

Crear un archivo de formato no XML

Para usar un comando bcp para crear un archivo de formato, especifique el argumento format y use nul en lugar de una ruta de acceso de archivo de datos. La opción de formato también requiere la opción -f , como : bcp _table_or_view_ format nul -f_format_file_name_.

Nota

Para distinguir un archivo de formato no XML, se recomienda usar .fmt como extensión de nombre de archivo, por ejemplo, MyTable.fmt.

Para obtener más información sobre la estructura y los campos de los archivos de formato no XML, vea Archivos de formato no XML (SQL Server).

Ejemplos

Esta sección contiene los ejemplos siguientes que muestran cómo usar comandos bcp para crear un archivo de formato no XML. Los ejemplos utilizan la tabla HumanResources.Department de la base de datos de ejemplo AdventureWorks2019 . La tabla HumanResources.Department tiene cuatro columnas: DepartmentID, Name, GroupNamey ModifiedDate.

A. Crear un archivo de formato no XML para datos nativos

En el ejemplo siguiente se crea un archivo de formato XML, Department-n.xml, para la tabla AdventureWorks2019 HumanResources.Department . El archivo de formato utiliza tipos de datos nativos. El contenido del archivo de formato generado se presenta después del comando.

El comando bcp contiene los calificadores siguientes.

Calificadores Descripción
formatnul-fformat_file Especifica el archivo de formato no XML.
-n Especifica tipos de datos nativos.
-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 poder iniciar sesión correctamente.

En el símbolo del sistema de Windows, escriba el siguiente comando bcp :

bcp AdventureWorks2012.HumanResources.Department format nul -T -n -f Department-n.fmt

El archivo de formato generado, Department-n.fmt, contiene la siguiente información:

12.0  
4  
1  SQLSMALLINT   0       2       ""   1     DepartmentID         ""  
2  SQLNCHAR      2       100     ""   2     Name                 SQL_Latin1_General_CP1_CI_AS  
3  SQLNCHAR      2       100     ""   3     GroupName            SQL_Latin1_General_CP1_CI_AS  
4  SQLDATETIME   0       8       ""   4     ModifiedDate         ""

Para obtener más información, vea Archivos de formato no XML (SQL Server).

B. Crear un archivo de formato no XML para datos de caracteres

En el ejemplo siguiente se crea un archivo de formato XML, Department.fmt, para la tabla AdventureWorks2019 HumanResources.Department . El archivo de formato usa formatos de datos de caracteres y un terminador de campo no predeterminado (,). El contenido del archivo de formato generado se presenta después del comando.

El comando bcp contiene los calificadores siguientes.

Calificadores Descripción
formatnul-fformat_file Especifica un archivo de formato no XML.
-c Especifica los datos de caracteres.
-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 poder iniciar sesión correctamente.

En el símbolo del sistema de Windows, escriba el siguiente comando bcp :

bcp AdventureWorks2012.HumanResources.Department format nul -c -f Department-c.fmt -T

El archivo de formato generado, Department-c.fmt, contiene la siguiente información:

12.0  
4  
1  SQLCHAR       0       7       "\t"     1     DepartmentID            ""  
2  SQLCHAR       0       100     "\t"     2     Name                    SQL_Latin1_General_CP1_CI_AS  
3  SQLCHAR       0       100     "\t"     3     GroupName               SQL_Latin1_General_CP1_CI_AS  
4  SQLCHAR       0       24      "\r\n"   4     ModifiedDate            ""

Para obtener más información, vea Archivos de formato no XML (SQL Server).

C. Crear un archivo de formato no XML para datos nativos Unicode

Para crear un archivo de formato no XML para datos nativos Unicode para la tabla HumanResources.Department, utilice el comando siguiente:

bcp AdventureWorks2012.HumanResources.Department format nul -T -N -f Department-n.fmt

Para obtener más información sobre cómo usar datos nativos Unicode, vea Usar el formato nativo Unicode para importar o exportar datos (SQL Server).

D. Crear un archivo de formato no XML para datos de caracteres Unicode

Para crear un archivo de formato no XML para datos de caracteres Unicode para la tabla HumanResources.Department que usa terminadores predeterminados, use el comando siguiente:

bcp AdventureWorks2012.HumanResources.Department format nul -T -w -f Department-w.fmt

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

F. Usar un archivo de formato con la opción de página de códigos

Si crea un archivo de formato con el comando bcp, es decir, con bcp format, la información sobre la intercalación o la página de código se escribirá en dicho archivo de formato.

El siguiente archivo de formato de ejemplo para una tabla con 5 columnas incluye la intercalación.

13.0  
5  
1  SQLCHAR         0       0       "**\t**"         1     c_0          Cyrillic_General_CS_AS  
2  SQLCHAR         0       0       "**\t**"         2     c_1          Cyrillic_General_CS_AS  
3  SQLCHAR         0       3000    "**\t**"         3     c_2          Cyrillic_General_CS_AS  
4  SQLCHAR         0       5       "**\t**"         4     c_3          ""  
5  SQLCHAR         0       41      "!!!\r\r\n"      5     c_4          ""

Si intenta importar datos a SQL Server mediante bcp in -c -C65001 -f format_file ..." o "BULK INSERT/OPENROWSET ... FORMATFILE='format_file' CODEPAGE=65001 ...", la información sobre la intercalación o página de códigos tendrá prioridad sobre la opción 65001.

Por lo tanto, si genera un archivo de formato, debe eliminar manualmente la información de intercalación del archivo de formato generado antes de comenzar a importar datos en SQL Server.

El siguiente es un ejemplo del archivo de formato sin la información de intercalación.

13.0  
5  
1  SQLCHAR         0       0       "**\t**"         1     c_0              ""  
2  SQLCHAR         0       0       "**\t**"         2     c_1              ""  
3  SQLCHAR         0       3000    "**\t**"         3     c_2              ""  
4  SQLCHAR         0       5       "**\t**"         4     c_3              ""  
5  SQLCHAR         0       41      "!!!\r\r\n"      5     c_4              ""

Crear un archivo de formato XML

Si quiere usar un comando BCP para crear un archivo de formato, especifique el argumento format y use null en lugar de una ruta de acceso de archivo de datos. La opción format siempre requiere la opción -f y para crear un archivo de formato XML, también debe especificar la opción -x , como bcp _table_or_view_ format nul -f _format_file_name_ -x

Nota

Para distinguir un archivo de formato XML, se recomienda utilizar .xml como extensión de archivo, por ejemplo, miTabla.xml.

Para obtener más información sobre la estructura y los campos de los archivos de formato XML, vea Archivos de formato XML (SQL Server).

Ejemplos

Esta sección contiene los ejemplos siguientes que muestran cómo usar comandos bcp para crear un archivo de formato XML. Los ejemplos utilizan la tabla HumanResources.Department de la base de datos de ejemplo AdventureWorks2019 . La tabla HumanResources.Department tiene cuatro columnas: DepartmentID, Name, GroupNamey ModifiedDate.

Nota

Adventure Works Cycles es una compañía ficticia que se utiliza para mostrar situaciones y conceptos de bases de datos.

A. Crear un archivo de formato XML para los datos de caracteres

En el ejemplo siguiente se crea un archivo de formato XML, Department.xml, para la tabla AdventureWorks2019HumanResources.Department . El archivo de formato usa formatos de datos de caracteres y un terminador de campo no predeterminado (,). El contenido del archivo de formato generado se presenta después del comando.

El comando bcp contiene los calificadores siguientes.

Calificadores Descripción
formatnul-fformat_file-x Especifica el archivo de formato XML.
-c Especifica los datos de caracteres.
-t, Especifica una coma ( , ) como terminador de campo.

Nota: Si el archivo de datos usa el terminador de campo predeterminado (\t), no es necesario el modificador -t.
-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 poder iniciar sesión correctamente.

En el símbolo del sistema de Windows, escriba el siguiente comando bcp :

bcp AdventureWorks2012.HumanResources.Department format nul -c -x -f Department-c.xml -t, -T

El archivo de formato generado, Department-c.xml, contiene los elementos XML siguientes:

<?xml version="1.0"?>  
<BCPFORMAT xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
<RECORD>  
  <FIELD ID="1" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="7"/>  
  <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>  
  <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>  
  <FIELD ID="4" xsi:type="CharTerm" TERMINATOR="\r\n" MAX_LENGTH="24"/>  
</RECORD>  
<ROW>  
  <COLUMN SOURCE="1" NAME="DepartmentID" xsi:type="SQLSMALLINT"/>  
  <COLUMN SOURCE="2" NAME="Name" xsi:type="SQLNVARCHAR"/>  
  <COLUMN SOURCE="3" NAME="GroupName" xsi:type="SQLNVARCHAR"/>  
  <COLUMN SOURCE="4" NAME="ModifiedDate" xsi:type="SQLDATETIME"/>  
</ROW>  
</BCPFORMAT>

Para obtener más información sobre la sintaxis de este archivo de formato, vea Archivos de formato XML (SQL Server). Para obtener más información sobre los datos de caracteres, vea Usar el formato de caracteres para importar o exportar datos (SQL Server).

B. Creación de un archivo de formato XML para datos nativos

En el ejemplo siguiente se crea un archivo de formato XML, Department-n.xml, para la tabla HumanResources.Department . El archivo de formato utiliza tipos de datos nativos. El contenido del archivo de formato generado se presenta después del comando.

El comando bcp contiene los calificadores siguientes.

Calificadores Descripción
formatnul-fformat_file-x Especifica el archivo de formato XML.
-n Especifica tipos de datos nativos.
-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 poder iniciar sesión correctamente.

En el símbolo del sistema de Windows, escriba el siguiente comando bcp :

bcp AdventureWorks2012.HumanResources.Department format nul -x -f Department-n.xml -n -T

El archivo de formato generado, Department-n.xml, contiene los elementos XML siguientes:

<?xml version="1.0"?>  
<BCPFORMAT xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
<RECORD>  
  <FIELD ID="1" xsi:type="NativeFixed" LENGTH="2"/>  
  <FIELD ID="2" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>  
  <FIELD ID="3" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>  
  <FIELD ID="4" xsi:type="NativeFixed" LENGTH="8"/>  
</RECORD>  
<ROW>  
  <COLUMN SOURCE="1" NAME="DepartmentID" xsi:type="SQLSMALLINT"/>  
  <COLUMN SOURCE="2" NAME="Name" xsi:type="SQLNVARCHAR"/>  
  <COLUMN SOURCE="3" NAME="GroupName" xsi:type="SQLNVARCHAR"/>  
  <COLUMN SOURCE="4" NAME="ModifiedDate" xsi:type="SQLDATETIME"/>  
</ROW>  
</BCPFORMAT>

Para obtener más información sobre la sintaxis de este archivo de formato, vea Archivos de formato XML (SQL Server). Para obtener más información sobre cómo usar datos nativos, vea Usar el formato nativo para importar o exportar datos (SQL Server).

Asignar campos de datos a columnas de tabla

Al igual que cuando se crea mediante bcp, un archivo de formato describe todas las columnas de tabla en orden. Puede modificar un archivo de formato para reorganizar u omitir filas de la tabla. Esto permite personalizar un archivo de formato en un archivo de datos cuyos campos no se asignan directamente a las columnas de la tabla. Para obtener más información, vea los temas siguientes:

Pasos siguientes