bcp_readfmt

Lit la définition du format du fichier de données à partir du fichier de format spécifié.

Syntaxe

  
RETCODE bcp_readfmt (  
HDBC   
hdbc  
,  
LPCTSTR   
szFormatFile  
);  
  

Arguments

hdbc
Handle de connexion ODBC compatible avec la copie en bloc.

szFormatFile
Chemin d'accès et nom du fichier contenant les valeurs de format du fichier de données.

Retours

SUCCEED ou FAIL.

Notes

Après bcp_readfmt avoir lu les valeurs de format, il effectue les appels appropriés à bcp_columns et bcp_colfmt. Vous n'avez nul besoin d'analyser un fichier de format et d'exécuter ces appels.

Pour rendre un fichier de format persistant, appelez bcp_writefmt. Les appels à peuvent référencer des bcp_readfmt formats enregistrés. Pour plus d'informations, consultez bcp_init.

L’utilitaire de copie en bloc (bcp) peut également enregistrer des formats de données définis par l’utilisateur dans des fichiers qui peuvent être référencés par bcp_readfmt. Pour plus d’informations sur l’utilitaire bcp et la structure des fichiers de format de données bcp, consultez Importation et exportation en bloc de données (SQL Server) .

La BCPDELAYREADFMT valeur du paramètre eOption de bcp_control modifie le comportement de bcp_readfmt.

Exemple

// 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_IN) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
if (bcp_readfmt(hdbc, _T("myFmtFile.fmt")) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
if (bcp_exec(hdbc, &nRowsProcessed) == SUCCEED)  
   {  
   cout << nRowsProcessed << " rows copied to SQL Server\n";  
   }  
  
// Carry on.  

Voir aussi

Bulk Copy Functions