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.
Valeurs retournées
SUCCEED ou FAIL.
Notes
Après que bcp_readfmt a lu les valeurs de format, il effectue les appels appropriés de 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 de bcp_readfmt peuvent faire référence à des formats enregistrés. Pour plus d'informations, consultez bcp_init.
Autre solution, l'utilitaire de copie en bloc (bcp) peut enregistrer les formats de données définis par l'utilisateur dans les fichiers qui peuvent être référencés par bcp_readfmt. Pour plus d'informations sur l'utilitaire bcp et la structure de fichiers de format de données bcp, consultez Importation et exportation en bloc de données (SQL Server).
La valeur BCPDELAYREADFMT du paramètre eOption de bcp_control modifie le comportement de bcp_readfmt.
[!REMARQUE]
Le fichier de format a dû être produit par la version 4.2 ou version ultérieure de l'utilitaire bcp.
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.