Crear un archivo de formato (SQL Server)

 

Se aplica a: SQL Server 2016

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.

System_CAPS_ICON_note.jpg 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, SQL Server 2012bcp puede leer un formato de archivo de la versión 10.0, generado por SQL Server 2008bcp, pero SQL Server 2008bcp no puede leer un formato de archivo de la versión 11.0, generado por SQL Server 2012bcp.

En este tema se describe cómo utilizar 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, -w o -N) y en los delimitadores de la vista o de la tabla.

Si quiere 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 format también requiere la opción -f, como:

bcp table_or_view format nul -fformat_file_name

System_CAPS_ICON_note.jpg Nota


Para distinguir un archivo de formato no XML, se recomienda utilizar .fmt como extensión del nombre de archivo, por ejemplo, miTabla.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 siguientes ejemplos que muestran cómo se usan los comandos de bcp para crear un archivo de formato no XML:

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

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

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

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

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

Los ejemplos utilizan la tabla HumanResources.Department de la base de datos de ejemplo AdventureWorks2012 . 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 AdventureWorks2012HumanResources.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.

CalificadoresDescripción
formatnul-f format_fileEspecifica el archivo de formato no XML.
-nEspecifica tipos de datos nativos.
-TEspecifica 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 AdventureWorks2012HumanResources.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.

CalificadoresDescripción
formatnul-f format_fileEspecifica un archivo de formato no XML.
-cEspecifica los datos de caracteres.
-TEspecifica 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, por medio de “bcp format …” ), la información sobre la intercalación o página de códigos se escribirá en el 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 en SQL Server con bcp in –c –C65001 –f format_file …” o “BULK INSERT/OPENROWSETFORMATFILE='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              ""  

Si quiere 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 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

System_CAPS_ICON_note.jpg 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 XML, archivos de formato (SQL Server).

Ejemplos

Esta sección contiene los siguientes ejemplos, en los que se muestran cómo se usan los comandos bcp para crear un archivo de formato XML:

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

  • B. Crear un archivo de formato XML para datos nativos

Los ejemplos utilizan la tabla HumanResources.Department de la base de datos de ejemplo AdventureWorks2012 . La tabla HumanResources.Department tiene cuatro columnas: DepartmentID, Name, GroupNamey ModifiedDate.

System_CAPS_ICON_note.jpg 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 datos de caracteres

En el ejemplo siguiente se crea un archivo de formato XML, Department.xml, para la tabla AdventureWorks2012HumanResources.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.

CalificadoresDescripción
formatnul-f format_file -xEspecifica el archivo de formato XML.
-cEspecifica 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.
-TEspecifica 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="http://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 XML, archivos de formato (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. Crear 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.

CalificadoresDescripción
formatnul-f format_file -xEspecifica el archivo de formato XML.
-nEspecifica tipos de datos nativos.
-TEspecifica 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="http://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 XML, archivos de formato (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).

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, consulte los temas siguientes:

bcp (utilidad)
Usar un archivo de formato para asignar columnas de tabla a campos de un archivo de datos (SQL Server)
Usar un archivo de formato para omitir una columna de tabla (SQL Server)
Usar un archivo de formato para omitir un campo de datos (SQL Server)
Archivos de formato no XML (SQL Server)
XML, archivos de formato (SQL Server)

Adiciones de comunidad

AGREGAR
Mostrar: