bcp_writefmt

Se aplica a: SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)

Crea un archivo de formato que contiene una descripción del formato del archivo de datos de la copia masiva actual.

Sintaxis

  
RETCODE bcp_writefmt (  
        HDBC hdbc,  
        LPCTSTR szFormatFile);  

Argumentos

hdbc
Es el identificador de la conexión ODBC habilitada para la copia masiva.

szFormatFile
Es la ruta de acceso y nombre del archivo de usuario para recibir valores de formato para el archivo de datos.

Devoluciones

SUCCEED o FAIL.

Comentarios

El archivo de formato especifica el formato de los datos de un archivo de datos creado mediante copia masiva. Las llamadas a bcp_columns y bcp_colfmt definen el formato del archivo de datos. bcp_writefmt guarda esta definición en el archivo al que se hace referencia en szFormatFile. Para obtener más información, vea bcp_init.

Para obtener más información sobre la estructura de los archivos de formato de datos bcp, vea Importar y exportar datos masivos mediante la utilidad bcp (SQL Server) .

Para cargar un archivo de formato guardado, use bcp_readfmt.

Nota:

El archivo de formato generado por bcp_writefmt solo es compatible con versiones de la utilidad bcp distribuidas con la versión 7.0 y posteriores de SQL Server.

Ejemplo

// Variables like henv not specified.  
HDBC      hdbc;  
DBINT      nRowsProcessed;  
  
// Application initiation, get an ODBC environment handle, allocate the  
// hdbc, and so on.  
...   
  
// Enable bulk copy prior to connecting on allocated hdbc.  
SQLSetConnectAttr(hdbc, SQL_COPT_SS_BCP, (SQLPOINTER) SQL_BCP_ON,  
   SQL_IS_INTEGER);  
  
// Connect to the data source, return on error.  
if (!SQL_SUCCEEDED(SQLConnect(hdbc, _T("myDSN"), SQL_NTS,  
   _T("myUser"), SQL_NTS, _T("myPwd"), SQL_NTS)))  
   {  
   // Raise error and return.  
   return;  
   }  
  
// Initialize bulk copy.   
if (bcp_init(hdbc, _T("myTable"), _T("myData.csv"),  
   _T("myErrors"),    DB_OUT) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
if (bcp_columns(hdbc, 3) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
bcp_colfmt(hdbc, 1, SQLCHARACTER, 0, SQL_VARLEN_DATA, '\t', 1, 1);  
bcp_colfmt(hdbc, 2, SQLCHARACTER, 0, SQL_VARLEN_DATA, '\t', 1, 2);  
bcp_colfmt(hdbc, 3, SQLCHARACTER, 0, SQL_VARLEN_DATA, '\t', 1, 3);  
  
if (bcp_writefmt(hdbc, _T("myFmtFile.fmt")) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
if (bcp_exec(hdbc, &nRowsProcessed) == SUCCEED)  
   {  
   printf_s("%ld rows copied from SQL Server\n", nRowsProcessed);  
   }  
  
// Carry on.  

Consulte también

Funciones de copia masiva