bcp_exec
Exécute une copie en bloc complète des données entre une table de base de données et un fichier utilisateur.
Syntaxe
RETCODE bcp_exec (
HDBC hdbc,
LPDBINT pnRowsProcessed);
Arguments
hdbc
Handle de connexion ODBC compatible avec la copie en bloc.pnRowsProcessed
Pointeur vers un DBINT. La fonction bcp_exec remplit ce DBINT avec le nombre de lignes copiées avec succès. Si pnRowsProcessed a la valeur NULL, la fonction bcp_exec l'ignore.
Valeurs retournées
SUCCEED, SUCCEED_ASYNC ou FAIL. La fonction bcp_exec retourne SUCCEED si toutes les lignes sont copiées. bcp_exec retourne SUCCEED_ASYNC si une opération de copie en bloc asynchrone est toujours en attente. bcp_exec retourne FAIL en cas d'échec total ou si le nombre de lignes générant des erreurs atteint la valeur spécifiée pour BCPMAXERRS à l'aide de bcp_control. La valeur par défaut de BCPMAXERRS est 10. L'option BCPMAXERRS affecte uniquement les erreurs de syntaxe détectées par le fournisseur lorsqu'elle lit les données du fichier de données (et non les lignes transmises au serveur). Le serveur interrompt le lot dès qu'il détecte une erreur avec une ligne. Vérifiez le paramètre pnRowsProcessed correspondant au nombre de lignes copiées avec succès.
Notes
En fonction de la valeur du paramètre eDirection dans bcp_init, cette fonction copie les données d'un fichier utilisateur vers une table de base de données ou inversement.
Avant d'appeler bcp_exec, appelez bcp_init avec un nom de fichier utilisateur valide. L'échec de cette opération entraîne une erreur.
bcp_exec est la seule fonction de copie en bloc qui est susceptible d'être en attente pendant une durée prolongée. Il s'agit par conséquent de la seule fonction de copie en bloc qui prend en charge le mode asynchrone. Pour définir le mode asynchrone, utilisez SQLSetConnectAttr pour définir SQL_ATTR_ASYNC_ENABLE to SQL_ASYNC_ENABLE_ON avant d'appeler la fonction bcp_exec. Pour tester son exécution en bonne et due forme, appelez la méthode bcp_exec avec les mêmes paramètres. Si la copie en bloc n'a pas encore été exécutée, bcp_exec retourne SUCCEED_ASYNC. Il retourne également dans pnRowsProcessed un état du nombre de lignes envoyées au serveur. Les lignes envoyées au serveur sont validées uniquement une fois la fin du lot atteinte.
Pour plus d'informations sur toutes les nouvelles modifications majeures apportées à la copie en bloc dans SQL Server 2005, consultez Exécution d'opérations de copie en bloc (ODBC).
Exemple
L'exemple ci-après décrit comment utiliser la fonction bcp_exec:
// 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("pubs..authors"), _T("authors.sav"), NULL, DB_OUT)
== FAIL)
{
// Raise error and return.
return;
}
// Now, execute the bulk copy.
if (bcp_exec(dbproc, &nRowsProcessed) == FAIL)
{
if (nRowsProcessed == -1)
{
printf_s("No rows processed on bulk copy execution.\n");
}
else
{
printf_s("Incomplete bulk copy. Only %ld row%s copied.\n",
nRowsProcessed, (nRowsProcessed == 1) ? "": "s");
}
return;
}
printf_s("%ld rows processed.\n", nRowsProcessed);
// Carry on.