bcp (utilidad)

La utilidad bcp copia datos de forma masiva entre una instancia de Microsoft SQL Server y un archivo de datos en un formato especificado por el usuario. La utilidad bcp se puede usar para importar un número elevado de filas nuevas en tablas de SQL Server o para exportar datos de tablas a archivos de datos. Excepto cuando se usa con la opción queryout, la utilidad no requiere ningún conocimiento de Transact-SQL. Para importar datos en una tabla, debe usar un archivo de formato creado para esa tabla o comprender la estructura de la tabla y los tipos de datos que son válidos para sus columnas.

Para conocer las convenciones de sintaxis que se usan para la sintaxis bcp, vea Convenciones de sintaxis de Transact-SQL (Transact-SQL).

Nota:

Si usa bcp para hacer una copia de seguridad de los datos, cree un archivo de formato para registrar el formato de datos. Los archivos de datos debcp no incluyen ningún esquema ni información de formato, de modo que si se quita una tabla o vista, y no tiene un archivo de formato, es posible que no pueda importar los datos.

Sintaxis

  
   bcp [database_name.] schema.{table_name | view_name | "query" {indata_file | outdata_file | queryoutdata_file | format nul}  
  
[-apacket_size]  
[-bbatch_size]  
[-c]  
[-C { ACP | OEM | RAW | code_page } ]  
[-ddatabase_name]  
[-eerr_file]  
[-E]  
[-fformat_file]  
[-Ffirst_row]  
[-h"hint [,...n]"]   
[-iinput_file]  
[-k]  
[-Kapplication_intent]  
[-Llast_row]  
[-mmax_errors]  
[-n]  
[-N]  
[-ooutput_file]  
[-Ppassword]  
[-q]  
[-rrow_term]  
[-R]  
[-S [server_name[\instance_name]]  
[-tfield_term]  
[-T]  
[-Ulogin_id]  
[-v]  
[-V (80 | 90 | 100 | 110)]  
[-w]  
[-x]  
/?  

Argumentos

data_file
Es la ruta completa del archivo de datos. Cuando se importan datos de forma masiva a SQL Server, el archivo de datos contiene los datos que se van a copiar en la tabla o vista especificada. Cuando se realiza una exportación de datos de forma masiva desde SQL Server, el archivo de datos contiene los datos copiados desde la tabla o desde la vista. La ruta de acceso puede contener de 1 a 255 caracteres. El archivo de datos puede contener 2⁶³ - 1 filas, como máximo.

database_name
Es el nombre de la base de datos en la que reside la tabla o vista especificada. Si no se especifica, es la base de datos predeterminada para el usuario.

También puede especificar explícitamente el nombre de la base de datos con d-.

in data_file | outdata_file | queryoutdata_file | format nul
Especifica la dirección de la copia masiva, de la siguiente manera:

• in copia desde un archivo en la vista o la tabla de la base de datos.

• out copia desde la tabla o la vista de la base de datos a un archivo. Si se especifica un archivo ya existente, este se sobrescribe. Al extraer datos, tenga en cuenta que la utilidad bcp representa una cadena vacía como nula y una cadena nula como vacía.

• queryout copia desde una consulta y debe especificarse solo cuando se copian datos de forma masiva desde una consulta.

• format crea un archivo de formato basado en la opción especificada (-n, -c, -wo -N) y los delimitadores de tabla o vista. Cuando se copian datos en bloque, el comando bcp puede hacer referencia a un archivo de formato, lo que evita tener que especificar de nuevo la información de formato interactivamente. La opción format necesita la opción -f ; la creación de un archivo de formato XML también requiere la opción -x . Para obtener más información, vea Crear un archivo de formato (SQL Server). Hay que especificar nul como el valor (format nul).

owner
Es el nombre del propietario de la tabla o vista. owner es opcional si el usuario que realiza la operación es propietario de la tabla o vista especificada. Si no se especifica el propietario y el usuario que realiza la operación no posee la tabla o vista especificadas, SQL Server devuelve un mensaje de error y se cancela la operación.

" query "
Es una consulta transact-SQL que devuelve un conjunto de resultados. Si la consulta devuelve múltiples conjuntos de resultados, solo se copiará el primero en el archivo de datos; los conjuntos de resultados siguientes se omitirán. Utilice comillas dobles para la consulta y comillas simples en los elementos que incruste en la consulta. queryout también se debe especificar cuando se copian datos desde una consulta.

La consulta puede hacer referencia a un procedimiento almacenado siempre que todas las tablas a las que se haga referencia dentro del procedimiento almacenado existan antes de ejecutar la instrucción bcp. Por ejemplo, si el procedimiento almacenado genera una tabla temporal, se produce un error en la instrucción bcp porque la tabla temporal solamente está disponible en tiempo de ejecución y no cuando se ejecuta la instrucción. En este caso, considere la posibilidad de insertar los resultados del procedimiento almacenado en una tabla y, después, usar bcp para copiar los datos de la tabla en un archivo de datos.

table_name
Es el nombre de la tabla de destino cuando se importan datos a SQL Server (in) y la tabla de origen cuando se exportan datos de SQL Server (out).

view_name
Es el nombre de la vista de destino cuando se copian datos en SQL Server (in) y la vista de origen cuando se copian datos de SQL Server (out). Solamente pueden usarse como vistas de destino aquellas vistas en las que todas las columnas hacen referencia a la misma tabla. Para obtener más información sobre las restricciones para copiar datos en vistas, vea INSERT (Transact-SQL).

-a packet_size
Especifica el número de bytes por paquete de red enviados y recibidos por el servidor. Se puede establecer una opción de configuración de servidor mediante SQL Server Management Studio (o el procedimiento almacenado del sistema sp_configure ). No obstante, la opción de configuración de servidor puede sustituirse individualmente mediante esta opción. packet_size puede oscilar entre 4096 y 65 535; el valor predeterminado es 4096.

Un tamaño mayor de los paquetes puede mejorar el rendimiento de las operaciones de copia masiva. Si se pide un tamaño de paquete mayor, pero no puede concederse, se usa el valor predeterminado. Las estadísticas de rendimiento generadas por la utilidad bcp muestran el tamaño del paquete usado.

-b batch_size
Especifica el número de filas por lote de datos importados. Cada lote se importa y registra como una transacción aparte que importa el lote entero antes de confirmarse. De forma predeterminada, todas las filas del archivo de datos se importan en un solo lote. Para distribuir las filas en varios lotes, especifique un valor de batch_size inferior al número de filas del archivo de datos. Si se produce un error en la transacción de un lote, solamente se revierten las inserciones del lote actual. Los lotes importados por transacciones confirmadas no se ven afectados por los errores posteriores.

No use esta opción junto con la opción **-h"**ROWS_PER_BATCH =bb".

-c
Realiza la operación con un tipo de datos de caracteres. Esta opción no solicita cada campo; usa char como tipo de almacenamiento, sin prefijos y con \t (carácter de tabulación) como separador de campo y \r\n (carácter de nueva línea) como terminador de fila. -c no es compatible con -w.

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

-C { ACP | OEM | RAW | code_page }
Especifica la página de códigos de los datos incluidos en el archivo de datos. code_page solo es relevante si los datos contienen charcolumnas , varcharo text con valores de caracteres mayores que 127 o menores que 32.

Nota:

Se recomienda especificar un nombre de intercalación para cada columna de un archivo de formato.

Valor de página de códigos	Descripción
ACP	ANSI/Microsoft Windows (ISO 1252).
OEM	Página de códigos predeterminada, utilizada por el cliente. Esta es la página de códigos que se usa de forma predeterminada si no se especifica -C .
RAW	No se realiza ninguna conversión entre páginas de códigos. Se trata de la opción más rápida porque no se producen conversiones.
code_page	Número específico de una página de códigos, por ejemplo, 850. ** Importante ** SQL Server no admite la página de códigos 65001 (codificación UTF-8).

-ddatabase_name
Especifica la base de datos a la que conectarse. De forma predeterminada, bcp.exe se conecta a la base de datos predeterminada del usuario. Si -dse especifica database_name y un nombre de tres partes (database_name.schema.table, pasado como primer parámetro a bcp.exe), se producirá un error porque no se puede especificar el nombre de la base de datos dos veces. Si database_name comienza con un guión (-) o una barra diagonal (/), no agregue un espacio entre -d y el nombre de la base de datos.

-e err_file
Especifica la ruta de acceso completa de un archivo de error que se usa para almacenar las filas que la utilidad bcp no puede transferir del archivo a la base de datos. Los mensajes de error del comando bcp van a la estación de trabajo del usuario. Si no se usa esta opción, no se creará el archivo de errores.

Si err_file comienza con un guión (-) o una barra diagonal (/), no incluya un espacio entre -e y el valor de err_file .

-E
Especifica que se usará el valor o valores de identidad del archivo de datos importado para la columna de identidad. Si no se especifica -E , se omiten los valores de identidad de esta columna en el archivo de datos que se importa y SQL Server asigna automáticamente valores únicos basados en los valores de inicialización y de incremento especificados durante la creación de la tabla.

Si el archivo de datos no contiene valores para la columna de identidad de la tabla o la vista, use un archivo de formato para especificar que se debe omitir la columna de identidad de la tabla o la vista al importar los datos; SQL Server asigna automáticamente valores únicos para la columna. Para obtener más información, vea DBCC CHECKIDENT (Transact-SQL).

La opción -E tiene un requisito de permisos especial. Para más información, consulte la sección "Comentarios" que aparece más adelante en este tema.

-f format_file
Especifica la ruta de acceso completa de un archivo de formato. El significado de esta opción depende del entorno en el que se utiliza, como se indica a continuación:

• Si se usa -f con la opción format , se crea el archivo format_file especificado para la tabla o la vista especificada. Para crear un archivo de formato XML, especifique también la opción -x . Para obtener más información, vea Crear un archivo de formato (SQL Server).

• Si se usa con las opciones in u out , -f requiere un archivo de formato existente.

  Nota

  El uso de un archivo de formato con la opción in o out es opcional. En ausencia de la opción -f , si no se especifica -n, -c, -wo -N , los símbolos del sistema solicitan información de formato y le permiten guardar las respuestas en un archivo de formato (cuyo nombre de archivo predeterminado es Bcp.fmt).

Si format_file comienza por un guión (-) o una barra diagonal (/), no incluya un espacio entre -f y el valor de format_file .

-F first_row
Especifica el número de la primera fila que se exportará desde una tabla o que se importará desde un archivo de datos. Este parámetro requiere un valor superior a (>) 0 pero inferior a (<) o igual que (=) el número total de filas. En ausencia de este parámetro, el valor predeterminado es la primera fila del archivo.

first_row puede ser un valor entero positivo hasta 2^63-1. -Ffirst_row es de base 1.

-h" hint[ ,... n] "
Especifica las sugerencias que deben usarse durante una importación de datos masiva en una tabla o en una vista.

ORDER**(column[ASC | DESC] [,...n])**
Indica el criterio de ordenación de los datos en el archivo de datos. El rendimiento de la importación masiva mejora si los datos importados se ordenan según el índice clúster de la tabla, si lo hay. Si el archivo de datos se ordena siguiendo otro criterio que no sea el orden de una clave de índice clúster, o si no hay ningún índice clúster en la tabla, la cláusula ORDER se pasa por alto. Los nombres de columna facilitados deben ser nombres válidos en la tabla de destino. De forma predeterminada, bcp supone que el archivo de datos no está ordenado. En las importaciones masivas optimizadas, SQL Server también valida que los datos importados estén ordenados.

ROWS_PER_BATCH =bb
Número de filas de datos por lote (como bb). Se usa cuando no se especifica -b , por lo que el archivo de datos completo se envía al servidor en una sola transacción. El servidor optimiza la carga masiva según el valor bb. De forma predeterminada, el valor de ROWS_PER_BATCH es desconocido.

= KILOBYTES_PER_BATCH cc
Número aproximado de kilobytes (KB) de datos por lote (igual que cc). De forma predeterminada, el valor de KILOBYTES_PER_BATCH es desconocido.

TABLOCK
Especifica que se adquiera un bloqueo de tabla de actualización masiva para la duración de la operación de carga masiva; de lo contrario, se adquiere un bloqueo de fila. Esta sugerencia mejora notablemente el rendimiento, dado que, al mantenerse el bloqueo durante la operación de copia masiva, se reduce la contención en la tabla por bloqueo. Varios clientes pueden cargar una tabla simultáneamente si esta no tiene índices y se especifica TABLOCK . De forma predeterminada, el comportamiento del bloqueo viene determinado por la opción de tabla table lock on bulk load.

CHECK_CONSTRAINTS
Especifica que deben comprobarse todas las restricciones de la tabla o vista de destino durante la operación de importación masiva. Sin la sugerencia CHECK_CONSTRAINTS, se omiten las restricciones CHECK y FOREIGN KEY y, después de la operación, la restricción sobre la tabla se marca como de no confianza.

Nota:

Las restricciones UNIQUE, PRIMARY KEY y NOT NULL se aplican siempre.

En algún momento deberá comprobar las restricciones de toda la tabla. Si la tabla no estaba vacía antes de la operación de importación masiva, el costo de revalidar la restricción puede exceder el costo de aplicar restricciones CHECK a los datos incrementales. Por lo tanto, se recomienda que se habilite normalmente la comprobación de restricciones durante una importación incremental masiva.

Una situación en la que quizá desee que las restricciones estén deshabilitadas (comportamiento predeterminado) es si los datos de entrada contienen filas que infringen las restricciones. Con las restricciones CHECK deshabilitadas, puede importar los datos y después usar instrucciones de Transact-SQL para quitar los datos que no son válidos.

Nota:

bcp valida y comprueba ahora los datos, y ello podría dar lugar a errores en los scripts si se ejecutan con datos no válidos de un archivo.

Nota:

El modificador -m max_errors no se aplica a la comprobación de restricciones.

FIRE_TRIGGERS
Cuando se especifica con el argumento in , se ejecutarán todos los desencadenadores de inserción definidos en la tabla de destino durante la operación de copia masiva. Si no se especifica FIRE_TRIGGERS, no se ejecutará ningún desencadenador. FIRE_TRIGGERS se ignora para los argumentos out, queryouty format .

-i input_file
Especifica el nombre de un archivo de respuesta, que contiene las respuestas a las preguntas del símbolo del sistema para cada campo de datos cuando se realiza una copia masiva mediante el modo interactivo (-n, -c, -wo -N no especificado).

Si input_file comienza por un guión (-) o una barra diagonal (/), no incluya un espacio entre -i y el valor de input_file .

-k
Especifica que las columnas vacías deben conservar un valor NULL durante la operación, en vez de tener valores predeterminados para las columnas insertadas. Para obtener más información, vea Mantener valores NULL o usar valores predeterminados durante la importación en bloque (SQL Server).

-K application_intent
Declara el tipo de carga de trabajo de la aplicación al conectarse a un servidor. El único valor que es posible es ReadOnly. Si no se especifica -K, la utilidad bcp no admitirá la conectividad con una réplica secundaria en el grupo de disponibilidad AlwaysOn. Para obtener más información, vea Secundarias activas: réplicas secundarias legibles (grupos de disponibilidad AlwaysOn).

-L last_row
Especifica el número de la última fila que se exportará desde una tabla o que se importará desde un archivo de datos. Este parámetro requiere un valor superior a (>) 0 pero inferior a (<) o igual al (=) el número de la última fila. En ausencia de este parámetro, el valor predeterminado es la última fila del archivo.

last_row puede ser un valor entero positivo hasta 2^63-1.

-m max_errors
Especifica el número máximo de errores de sintaxis que pueden producirse antes de que se cancele la operación de bcp . Un error de sintaxis implica un error de conversión de datos en el tipo de datos de destino. El total de max_errors excluye cualquier error que pueda detectarse solamente en el servidor, como las infracciones de restricciones.

Una fila que no puede copiarse con la utilidad bcp se omite y se cuenta como un error. Si no se incluye esta opción, el valor predeterminado es 10.

Nota:

La opción -m tampoco se aplica a la conversión de los tipos de money datos o bigint .

-n
Realiza la operación de copia masiva con los tipos de datos nativos (base de datos) de los datos. Esta opción no efectúa una petición para cada campo, sino que usa los valores nativos.

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

-N
Realiza la operación de copia masiva con los tipos de datos nativos (de la base de datos) para datos que no sean de caracteres y con datos Unicode para los datos de caracteres. Esta opción es una alternativa de mayor rendimiento que la opción -w y tiene como objeto la transferencia de datos de una instancia de SQL Server a otra mediante un archivo de datos. No realiza una petición para cada campo. Utilice esta opción cuando vaya a transferir datos que contengan caracteres extendidos ANSI y desee aprovechar el rendimiento del modo nativo.

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

Si exporta y, a continuación, importa datos en el mismo esquema de tabla mediante bcp.exe con -N, es posible que vea una advertencia de truncamiento si hay una columna de caracteres no Unicode de longitud fija (por ejemplo, char(10)).

La advertencia puede omitirse. Una manera de resolver esta advertencia es usar -n en lugar de -N.

-o output_file
Especifica el nombre de un archivo que recibe la salida redirigida desde el símbolo del sistema.

Si output_file comienza por un guión (-) o una barra diagonal (/), no incluya un espacio entre -o y el valor de output_file .

-P password
Especifica la contraseña para el identificador de inicio de sesión . Si no se usa esta opción, el comando bcp solicitará una contraseña. Si se usa esta opción al final del símbolo del sistema sin especificar ninguna contraseña, bcp usa la contraseña predeterminada (NULL).

Importante

No utilice una contraseña en blanco. Utilice una contraseña segura.

Para enmascarar la contraseña, no especifique la opción -P junto con la opción -U . En su lugar, después de especificar bcp junto con la opción -U y otros modificadores (sin especificar -P), pulse ENTRAR y el comando le solicitará una contraseña. Este método garantiza que la contraseña se enmascare al especificarla.

Si password comienza por un guión (-) o una barra diagonal (/), no incluya un espacio entre -P y el valor de password .

-q
Ejecuta la instrucción SET QUOTED_IDENTIFIERS ON en la conexión entre la utilidad bcp y una instancia de SQL Server. Use esta opción para especificar una base de datos, un propietario, una tabla o un nombre de vista que contenga un espacio o una comilla simple. Englobe la totalidad del nombre de tres partes de la vista o tabla entre comillas (" ").

Para especificar un nombre de base de datos que contenga un espacio o una comilla simple, debe usar la opción -q.

-q no se aplica a los valores que se pasan a -d.

Para más información, consulte la sección Comentariosque aparece más adelante en este tema.

-r row_term
Especifica el terminador de la fila. El valor predeterminado es \n (carácter de nueva línea). Use este parámetro para sustituir el terminador de fila predeterminado. Para obtener más información, vea Especificar terminadores de campo y de fila (SQL Server).

Si especifica el terminador de fila en notación hexadecimal en un comando bcp.exe, el valor se truncará en 0x00. Por ejemplo, si especifica 0x410041, se usará 0x41.

Si row_term comienza por un guión (-) o una barra diagonal (/), no incluya un espacio entre -r y el valor de row_term .

-R
Especifica que se realice la copia masiva de datos de moneda, fecha y hora en SQL Server con el formato regional definido para la configuración regional del equipo cliente. De forma predeterminada, la configuración regional se omite.

-S server_name[ \instance_name]
Especifica la instancia de SQL Server a la que hay que conectarse. Si no se especifica ningún servidor, la utilidad bcp se conecta a la instancia predeterminada de SQL Server en el equipo local. Esta opción es necesaria cuando se ejecuta un comando bcp desde un equipo remoto de la red o desde una instancia local con nombre. Para establecer una conexión con la instancia predeterminada de SQL Server en un servidor, especifique únicamente server_name. Para conectar con una instancia con nombre de SQL Server, especifique server_name*\*instance_name.

-tfield_term
Especifica el terminador del campo. El valor predeterminado es \t (carácter de tabulación). Use este parámetro para invalidar el terminador de campo predeterminado. Para obtener más información, vea Especificar terminadores de campo y de fila (SQL Server).

Si especifica el terminador de campo en notación hexadecimal en un comando bcp.exe, el valor se truncará en 0x00. Por ejemplo, si especifica 0x410041, se usará 0x41.

Si field_term comienza con un guión (-) o una barra diagonal (/), no incluya un espacio entre -t y el valor de field_term .

-T
Especifica que la utilidad bcp se conecta a SQL Server con una conexión de confianza utilizando la seguridad integrada. No es necesario usar las credenciales de seguridad del usuario de la red, login_idy password . Si no se especifica -T , es necesario especificar -U y -P para iniciar sesión correctamente.

-U login_id
Especifica el identificador de inicio de sesión para conectar con SQL Server.

Importante

Si la utilidad bcp se conecta a SQL Server mediante una conexión de confianza que usa seguridad integrada, use la opción -T (conexión de confianza) en lugar de la combinación user name y password .

-v
Informa del número de versión y los derechos de autor de la utilidad bcp .

-V (80 | 90 | 100| 110)
Realiza la operación de copia masiva con tipos de datos de versiones anteriores de SQL Server. Esta opción no realiza una petición para cada campo, sino que utiliza los valores predeterminados.

80 = SQL Server 2000

90 = SQL Server 2005

100 = SQL Server 2008 y SQL Server 2008 R2

110 = SQL Server 2012

Por ejemplo, para generar datos para tipos no admitidos por SQL Server 2000, pero se introdujeron en versiones posteriores de SQL Server, use la opción -V80.

Para obtener más información, vea Importar datos con formato nativo y de caracteres de versiones anteriores de SQL Server.

-w
Realiza la operación de copia masiva con caracteres Unicode. Esta opción no solicita cada campo; usa nchar como tipo de almacenamiento, sin prefijos, \t (carácter de tabulación) como separador de campo y \n (carácter de nueva línea) como terminador de fila. -w no es compatible con -c.

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

-x
Si se usa con las opciones format y -fformat_file, genera un archivo de formato basado en XML en lugar del archivo de formato predeterminado que no es XML. -x no funciona cuando se importan o exportan datos. Genera un error si se usa sin format ni -fformat_file.

Comentarios

El cliente bcp 12.0 se instala al instalar las herramientas de MicrosoftSQL Server 2014. Si las herramientas se instalan para SQL Server 2014 y una versión anterior de SQL Server, en función del valor de la variable de entorno PATH, es posible que use el cliente bcp anterior en lugar del cliente bcp 12.0. Esta variable de entorno define el conjunto de directorios que Windows usa para buscar archivos ejecutables. Para saber qué versión está usando, ejecute el comando bcp /v en el símbolo del sistema de Windows. Para obtener información acerca del establecimiento de la ruta de comandos en la variable de entorno PATH, vea la Ayuda de Windows.

Los archivos con formato XML solamente se admiten cuando se instalan herramientas de SQL Server con SQL Server Native Client.

Para obtener más información sobre dónde encontrar o cómo ejecutar la utilidad bcp y sobre las convenciones de sintaxis de las utilidades del símbolo del sistema, vea Referencia de la utilidad del símbolo del sistema (motor de base de datos).

Para obtener información sobre cómo preparar datos para operaciones de importación o exportación masivas, vea Preparar los datos para exportar o importar 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.

Compatibilidad de los archivos de datos nativos

En SQL Server 2014, la utilidad bcp admite archivos de datos nativos compatibles con SQL Server 2000, SQL Server 2005, SQL Server 2008, SQL Server 2008 R2 y SQL Server 2012.

Columnas calculadas y columnas de marca de tiempo

Los valores del archivo de datos que se importan para las columnas calculadas o timestamp se omiten y SQL Server asigna automáticamente valores. Si el archivo de datos no contiene valores para las columnas calculadas o timestamp de la tabla, use un archivo de formato para especificar que se deben omitir las columnas o timestamp calculadas de la tabla al importar datos; SQL Server asigna automáticamente valores para la columna.

Las columnas calculadas y timestamp se copian masivamente de SQL Server a un archivo de datos como de costumbre.

Especificar identificadores que incluyen espacios o comillas

SQL Server pueden incluir caracteres tales como espacios insertados y comillas. Tales identificadores deben tratarse de la siguiente manera:

• Cuando especifique un identificador o nombre de archivo que incluya un espacio o comillas en el símbolo del sistema, coloque el identificador entre comillas dobles (" ").

  Por ejemplo, el siguiente comando bcp out crea un archivo de datos denominado Currency Types.dat:

  bcp AdventureWorks2012.Sales.Currency out "Currency Types.dat" -T -c  
  

• Para especificar un nombre de base de datos que contenga un espacio o comillas, debe usar la opción -q.

• Para los nombres de vista, tabla o propietario que contienen espacios insertados o comillas, puede hacer lo siguiente:

  • Especificar la opción -q, o bien

  • Incluir el nombre de vista, tabla o propietario entre corchetes ([]) dentro de las comillas.

Validación de datos

bcp valida y comprueba ahora los datos, y ello podría dar lugar a errores en los scripts si se ejecutan con datos no válidos de un archivo. Por ejemplo, bcp ahora comprueba que:

• La representación nativa de los tipos de datos float o real es válida.

• Los datos Unicode tienen una longitud de bytes uniforme.

Es posible que los formularios de datos no válidos que podían importarse de forma masiva en versiones anteriores de SQL Server no se carguen ahora, mientras que, en anteriores versiones, el error no se producía hasta que un cliente intentaba tener acceso a datos no válidos. La validación agregada evita sorpresas cuando se consultan los datos después de una carga masiva.

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 datos	Efecto
SQLCHAR o SQLVARYCHAR	Los datos se envían a la página de códigos del cliente o a la página de códigos implícita por la intercalación. Tiene el mismo efecto que especificar el modificador -c sin indicar un archivo de formato.
SQLNCHAR o SQLNVARCHAR	Los datos se envían como datos Unicode. Tiene el mismo efecto que especificar el modificador -w sin indicar un archivo de formato.
SQLBINARY o SQLVARYBIN	Los datos se envían sin realizar ninguna conversión.

Permisos

Una operación bcpout requiere permisos SELECT en la tabla de origen.

Una operación bcpinrequiere como mínimo permisos SELECT/INSERT en la tabla de destino. Además, se requiere el permiso ALTER TABLE si cualquiera de las siguientes afirmaciones es verdadera:

• Existen restricciones y la sugerencia CHECK_CONSTRAINTS no se ha especificado.

  Nota

  La deshabilitación de restricciones es el comportamiento predeterminado. Para habilitar las restricciones de forma explícita, use la opción -h con la sugerencia CHECK_CONSTRAINTS.

• Existen desencadenadores y la sugerencia FIRE_TRIGGER no se ha especificado.

  Nota

  De forma predeterminada, los desencadenadores no se activan. Para activarlos de forma explícita, use la opción -h con la sugerencia FIRE_TRIGGERS.

• La opción -E se usa para importar valores de identidad de un archivo de datos.

Nota:

Requerir el permiso ALTER TABLE en la tabla de destino era nuevo en SQL Server 2005. Este nuevo requisito podría hacer que los scripts de bcp que no exigen las comprobaciones de restricciones y desencadenadores devuelvan un error si la cuenta de usuario no tiene los permisos de tabla ALTER para la tabla de destino.

Prácticas recomendadas para el modo de carácter (-c) y el modo nativo (-n)

Esta sección contiene recomendaciones para el modo de carácter (-c) y el modo nativo (-n).

• (Administrador o usuario) Cuando sea posible, utilice el formato nativo (-n) para evitar problemas de separador. Utilice el formato nativo para exportar e importar utilizando SQL Server. Exporte datos de SQL Server utilizando la opción -c o -w si los datos se van a importar a una base de datos que no es deSQL Server .

• (Administrador) Compruebe los datos al utilizar BCP OUT. Por ejemplo, cuando se utiliza BCP OUT, BCP IN y luego BCP OUT, compruebe que los datos se han exportado correctamente y que los valores de terminador no se utilizan como parte de algún valor de datos. Considere la posibilidad de reemplazar los terminadores predeterminados (utilizando las opciones -t y -r) por valores hexadecimales aleatorios para evitar conflictos entre los valores de terminador y los valores de datos.

• (Usuario) Utilice un terminador largo y único (cualquier secuencia de bytes o caracteres) para minimizar la posibilidad de conflicto con el valor de cadena real. Esto se puede realizar utilizando las opciones -t y -r.

Ejemplos

En esta sección se incluyen los ejemplos siguientes:

• A Copiar filas de tablas en un archivo de datos (con una conexión de confianza)

• B. Copiar filas de tablas en un archivo de datos (con autenticación de modo mixto)

• C. Copiar datos de un archivo en una tabla

• D. Copiar una columna específica en un archivo de datos

• E. Copiar una fila específica en un archivo de datos

• F. Copiar datos de una consulta en un archivo de datos

• G. Crear un archivo de formato no XML

• H. Crear un archivo de formato XML

• I. Usar un archivo de formato para importar de forma masiva con bcp

A Copiar filas de tablas en un archivo de datos (con una conexión de confianza)

En el siguiente ejemplo se ilustra la opción out de la tabla AdventureWorks2012.Sales.Currency . En este ejemplo se crea un archivo de datos con el nombre Currency.dat y se usa el formato de caracteres para copiar los datos de la tabla en ese archivo. En el ejemplo se supone que usa la autenticación de Windows y que existe una conexión de confianza con la instancia del servidor en la que se ejecuta el comando bcp .

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

bcp AdventureWorks2012.Sales.Currency out Currency.dat -T -c  

B. Copiar filas de tablas en un archivo de datos (con autenticación de modo mixto)

En el siguiente ejemplo se ilustra la opción out de la tabla AdventureWorks2012.Sales.Currency . En este ejemplo se crea un archivo de datos con el nombre Currency.dat y se usa el formato de caracteres para copiar los datos de la tabla en ese archivo.

En el ejemplo se da por hecho que usa la autenticación de modo mixto; hay que usar el modificador -U para especificar su identificador de inicio de sesión. Además, a menos que se esté conectando a la instancia predeterminada de SQL Server en el equipo local, use el modificador -S para especificar el nombre del sistema y, opcionalmente, un nombre de instancia.

bcp AdventureWorks2012.Sales.Currency out Currency.dat -c -U<login_id> -S<server_name\instance_name>  

El sistema le solicitará la contraseña.

C. Copiar datos de un archivo en una tabla

En el siguiente ejemplo se ilustra la opción in y se usa el archivo creado en el ejemplo anterior (Currency.dat). No obstante, en primer lugar, este ejemplo crea una copia vacía de la tabla de AdventureWorks2012 Sales.Currency, Sales.Currency2, en la que se copian los datos. En el ejemplo se supone que usa la autenticación de Windows y que existe una conexión de confianza con la instancia del servidor en la que se ejecuta el comando bcp .

Para crear la tabla vacía, en el Editor de consultas, escriba el siguiente comando:

USE AdventureWorks2012;  
GO  
SELECT * INTO AdventureWorks2012.Sales.Currency2   
FROM AdventureWorks2012.Sales.Currency WHERE 1=2;  

Para realizar una copia masiva de los datos de caracteres en la nueva tabla, es decir, para importar los datos, escriba el siguiente comando en un símbolo del sistema:

bcp AdventureWorks2012.Sales.Currency2 in Currency.dat -T -c  

Para comprobar que el comando se ha ejecutado correctamente, muestre el contenido en el Editor de consultas y escriba:

USE AdventureWorks2012;  
GO  
SELECT * FROM Sales.Currency2  

D. Copiar una columna específica en un archivo de datos

Para copiar una columna específica, puede usar la opción queryout . El siguiente ejemplo copia únicamente la columna Name de la tabla Sales.Currency en un archivo de datos. En el ejemplo se supone que usa la autenticación de Windows y que existe una conexión de confianza con la instancia del servidor en la que se ejecuta el comando bcp .

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

bcp "SELECT Name FROM AdventureWorks.Sales.Currency" queryout Currency.Name.dat -T -c  

E. Copiar una fila específica en un archivo de datos

Para copiar una fila específica, puede usar la opción queryout . En el siguiente ejemplo se copia únicamente la fila relativa al contacto denominado Jarrod Rana desde la tabla AdventureWorks2012.Person.Person en un archivo de datos (Jarrod Rana.dat). En el ejemplo se da por hecho que usa la autenticación de Windows y que existe una conexión de confianza con la instancia de servidor en la que se ejecuta el comando bcp.

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

bcp "SELECT * FROM AdventureWorks2012.Person.Person WHERE FirstName='Jarrod' AND LastName='Rana' "  queryout "Jarrod Rana.dat" -T -c  

F. Copiar datos de una consulta en un archivo de datos

Para copiar el conjunto de resultados de una instrucción Transact-SQL en un archivo de datos, use la opción queryout . El siguiente ejemplo copia los nombres de la tabla de AdventureWorks2012.Person.Person , ordenados por el apellido y después por el nombre, en el archivo de datos Contacts.txt . En el ejemplo se supone que usa la autenticación de Windows y que existe una conexión de confianza con la instancia del servidor en la que se ejecuta el comando bcp .

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

bcp "SELECT FirstName, LastName FROM AdventureWorks2012.Person.Person ORDER BY LastName, Firstname" queryout Contacts.txt -c -T  

G. Crear un archivo de formato no XML

En el ejemplo siguiente se crea un archivo de formato no XML, Currency.fmt, para la Sales.Currency tabla de la base de datos AdventureWorks2012 . En el ejemplo se supone que usa la autenticación de Windows y que existe una conexión de confianza con la instancia del servidor en la que se ejecuta el comando bcp .

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

bcp AdventureWorks2012.Sales.Currency format nul -T -c  -f Currency.fmt  

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

H. Crear un archivo de formato XML

En el ejemplo siguiente se crea un archivo de formato XML denominado Currency.xml para la Sales.Currency tabla de la base de datos AdventureWorks2012 . En el ejemplo se supone que usa la autenticación de Windows y que existe una conexión de confianza con la instancia del servidor en la que se ejecuta el comando bcp .

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

bcp AdventureWorks2012.Sales.Currency format nul -T -c -x -f Currency.xml  

Nota:

Para usar el modificador -x , debe contar con un cliente bcp 9.0. Para obtener información acerca de cómo usar el cliente bcp 9.0, consulte la sección "Comentarios".

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

I. Usar un archivo de formato para importar de forma masiva con bcp

Para usar un archivo de formato creado anteriormente al importar datos a una instancia de SQL Server, use el modificador -f con la opción in . Por ejemplo, el siguiente comando copia de forma masiva el contenido de un archivo de datos, Currency.dat, en una copia de la tabla Sales.Currency (Sales.Currency2) mediante el archivo de formato creado anteriormente (Currency.xml). En el ejemplo se supone que usa la autenticación de Windows y que existe una conexión de confianza con la instancia del servidor en la que se ejecuta el comando bcp .

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

bcp AdventureWorks2012.Sales.Currency2 in Currency.dat -T -f Currency.xml  

Nota:

Los archivos de formato son útiles cuando los campos del archivo de datos son diferentes a los de las columnas de la tabla; por ejemplo, en su numeración, orden o tipos de datos. Para obtener más información, vea Archivos de formato para importar o exportar datos (SQL Server).

Otros ejemplos

Los siguientes temas incluyen ejemplos de uso de bcp:

• Crear un archivo de formato (SQL Server)

• Ejemplos de importación y exportación de forma masiva documentos XML (SQL Server)

• Mantener valores de identidad al importar datos de forma masiva (SQL Server)

• Mantener valores NULL o usar valores predeterminados durante la importación masiva (SQL Server)

• Especificar terminadores de campo y de fila (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)

• Uso del formato nativo para importar o exportar datos (SQL Server)

• Uso del formato de caracteres Unicode para importar o exportar datos (SQL Server)

• Usar el formato nativo Unicode para importar o exportar datos (SQL Server)

Consulte también

Preparar los datos para exportar o importar de forma masiva (SQL Server)
BULK INSERT (Transact-SQL)
OPENROWSET (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)
sp_configure (Transact-SQL)
sp_tableoption (Transact-SQL)
Archivos de formato para importar o exportar datos (SQL Server)