bcp_init

Article
03/07/2017

Initialise l'opération de copie en bloc.

Syntaxe

  
RETCODE bcp_init (  
HDBC   
hdbc  
,  
LPCTSTR   
szTable  
,  
LPCTSTR   
szDataFile  
,  
LPCTSTR   
szErrorFile  
,  
INT   
eDirection  
);

Arguments

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

szTable
Nom de la table de base de données depuis ou vers laquelle s'effectue la copie. Ce nom peut aussi inclure le nom de la base de données ou le nom du propriétaire. Par exemple, pubs.gracie.titles, pubs.. titles, gracie.titles et titles sont tous des noms de table légaux.

Si eDirection est DB_OUT, szTable peut également être le nom d’une vue de base de données.

Si eDirection est DB_OUT et qu’une instruction SELECT est spécifiée à l’aide de bcp_control avant l’appel de bcp_exec , bcp_initszTable doit avoir la valeur NULL.

szDataFile
Nom du fichier utilisateur depuis ou vers lequel s'effectue la copie. Si les données sont copiées directement à partir de variables à l’aide de bcp_sendrow, définissez szDataFile sur NULL.

szErrorFile
Nom du fichier d'erreurs à remplir avec les messages de progression, les messages d'erreur et les copies des lignes qui, pour quelque raison que ce soit, n'ont pas pu être copiées d'un fichier utilisateur vers une table. Si null est passé en tant que szErrorFile, aucun fichier d’erreur n’est utilisé.

eDirection
Direction de la copie, DB_IN ou DB_OUT. DB_IN indique la copie de variables de programme ou d'un fichier utilisateur dans une table. DB_OUT indique la copie d'une table de base de données dans un fichier utilisateur. Vous devez spécifier un nom de fichier utilisateur avec DB_OUT.

Retours

SUCCEED ou FAIL.

Notes

Appelez bcp_init avant d’appeler toute autre fonction de copie en bloc. bcp_init effectue les initialisations nécessaires pour une copie en bloc des données entre la station de travail et SQL Server.

La fonction bcp_init doit être fournie avec un handle de connexion ODBC activé pour une utilisation avec les fonctions de copie en bloc. Pour activer le handle, utilisez SQLSetConnectAttr avec SQL_COPT_SS_BCP défini sur SQL_BCP_ON sur un handle de connexion alloué, mais pas connecté. La tentative d'assigner l'attribut sur un handle connecté provoque une erreur.

Lorsqu’un fichier de données est spécifié, bcp_init examine la structure de la source de base de données ou de la table cible, et non le fichier de données. bcp_init spécifie des valeurs de format de données pour le fichier de données en fonction de chaque colonne de la table de base de données, de la vue ou du jeu de résultats SELECT. Cette spécification inclut le type de données de chaque colonne, la présence ou l'absence d'un indicateur de longueur ou null et des chaînes d'octet de terminateur dans les données, et la largeur des types de données de longueur fixe. bcp_init définit ces valeurs comme suit :

Le type de données spécifié est le type de données de la colonne dans la table de base de données, la vue ou le jeu de résultats SELECT. Le type de données est énuméré par SQL Server types de données natifs spécifiés dans sqlncli.h. Les données elles-mêmes sont représentées dans leur forme informatique. Autrement dit, les données d’une colonne de type de données entier sont représentées par une séquence de quatre octets qui est de type endian grand ou petit en fonction de l’ordinateur qui a créé le fichier de données.
Si un type de données de base de données est de longueur fixe, les données du fichier de données sont également de longueur fixe. Les fonctions de copie en bloc qui traitent des données (par exemple, bcp_exec) analysent les lignes de données en s’attendant à ce que la longueur des données dans le fichier de données soit identique à la longueur des données spécifiées dans la table de base de données, la vue ou la liste de colonnes SELECT. Par exemple, les données d’une colonne de base de données définie comme char(13) doivent être représentées par 13 caractères pour chaque ligne de données du fichier. Les données de longueur fixe peuvent être préfixées avec un indicateur null si la colonne de base de données autorise les valeurs NULL.
Lorsque la séquence d'octet de terminateur est définie, la longueur de la séquence d'octet de terminateur est définie avec la valeur 0.
Lors de la copie vers SQL Server, le fichier de données doit contenir des données pour chaque colonne de la table de base de données. Lors de la copie à partir de SQL Server, les données de toutes les colonnes de la table de base de données, de la vue ou du jeu de résultats SELECT sont copiées dans le fichier de données.
Lors de la copie vers SQL Server, la position ordinale d’une colonne dans le fichier de données doit être identique à la position ordinale de la colonne dans la table de base de données. Lors de la copie à partir de SQL Server, bcp_exec place les données en fonction de la position ordinale de la colonne dans la table de base de données.
Si un type de données de base de données est de longueur variable (par exemple, varbinary(22)) ou si une colonne de base de données peut contenir des valeurs null, les données du fichier de données sont précédées d’un indicateur length/null. La largeur de l'indicateur varie selon le type de données et la version de la copie en bloc.

Pour modifier les valeurs de format de données spécifiées pour un fichier de données, appelez bcp_columns et bcp_colfmt.

Les copies en bloc dans SQL Server peuvent être optimisées pour les tables qui ne contiennent pas d’index en définissant le modèle de récupération de base de données sur SIMPLE ou BULK_LOGGED. Pour plus d’informations, consultez Prérequis pour la journalisation minimale dans l’importation en bloc et ALTER DATABASE.

Si aucun fichier de données n’est utilisé, vous devez appeler bcp_bind pour spécifier le format et l’emplacement en mémoire de chaque colonne, puis copier les lignes de données dans le SQL Server à l’aide de bcp_sendrow.

Exemple

Cet exemple montre comment utiliser la fonction ODBC bcp_init avec un fichier de format.

Avant de compiler et d'exécuter le code C++, vous devez procéder comme suit :

Créez une source de données ODBC nommée Test. Vous pouvez associer cette source de données à toute base de données.
Exécutez le transact-SQL suivant sur la base de données :
```
CREATE TABLE BCPDate (cola int, colb datetime);  
```
Dans le répertoire dans lequel l'application sera exécutée, ajoutez un fichier nommé Bcpfmt.fmt, puis ajoutez le code suivant au fichier :
```
8.0  
2  
1SQLCHAR04"\t"1colaSQL_Latin1_General_Cp437_Bin  
2SQLCHAR08"\r\n"2colbSQL_Latin1_General_Cp437_Bin  
```
Dans le répertoire dans lequel l'application sera exécutée, ajoutez un fichier nommé Bcpodbc.bcp, puis ajoutez le code suivant au fichier :
```
1  
2  
```

Vous êtes à présent prêt à compiler et exécuter le code C++.

// compile with: odbc32.lib sqlncli11.lib  
#include <stdio.h>  
#include <windows.h>  
#include <sql.h>  
#include <sqlext.h>  
#include <odbcss.h>  
  
SQLHENV henv = SQL_NULL_HENV;  
HDBC hdbc1 = SQL_NULL_HDBC;   
  
void Cleanup() {  
   if (hdbc1 != SQL_NULL_HDBC) {  
      SQLDisconnect(hdbc1);  
      SQLFreeHandle(SQL_HANDLE_DBC, hdbc1);  
   }  
  
   if (henv != SQL_NULL_HENV)  
      SQLFreeHandle(SQL_HANDLE_ENV, henv);  
}  
  
int main() {  
   RETCODE retcode;  
   SDWORD cRows;  
  
   // Allocate the ODBC environment and save handle.  
   retcode = SQLAllocHandle (SQL_HANDLE_ENV, NULL, &henv);  
   if ( (retcode != SQL_SUCCESS_WITH_INFO) && (retcode != SQL_SUCCESS)) {  
      printf("SQLAllocHandle(Env) Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Notify ODBC that this is an ODBC 3.0 app.  
   retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER) SQL_OV_ODBC3, SQL_IS_INTEGER);  
   if ( (retcode != SQL_SUCCESS_WITH_INFO) && (retcode != SQL_SUCCESS)) {  
      printf("SQLSetEnvAttr(ODBC version) Failed\n\n");  
      Cleanup();  
      return(9);      
   }  
  
   // Allocate ODBC connection handle, set BCP mode, and connect.  
   retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc1);  
   if ( (retcode != SQL_SUCCESS_WITH_INFO) && (retcode != SQL_SUCCESS)) {  
      printf("SQLAllocHandle(hdbc1) Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   retcode = SQLSetConnectAttr(hdbc1, SQL_COPT_SS_BCP, (void *)SQL_BCP_ON, SQL_IS_INTEGER);  
   if ( (retcode != SQL_SUCCESS_WITH_INFO) && (retcode != SQL_SUCCESS)) {  
      printf("SQLSetConnectAttr(hdbc1) Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Sample uses Integrated Security. Create SQL Server DSN using Windows NT authentication.  
   retcode = SQLConnect(hdbc1, (UCHAR*)"Test", SQL_NTS, (UCHAR*)"", SQL_NTS, (UCHAR*)"", SQL_NTS);  
   if ( (retcode != SQL_SUCCESS) && (retcode != SQL_SUCCESS_WITH_INFO) ) {  
      printf("SQLConnect() Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Initialize the bulk copy.  
   retcode = bcp_init(hdbc1, "BCPDate", "BCPODBC.bcp", NULL, DB_IN);  
   if ( (retcode != SUCCEED) ) {  
      printf("bcp_init(hdbc1) Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Read the format file.  
   retcode = bcp_readfmt(hdbc1, "BCPFMT.fmt");  
   if ( (retcode != SUCCEED) ) {  
      printf("bcp_readfmt(hdbc1) Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   // Execute the bulk copy.  
   retcode = bcp_exec(hdbc1, &cRows);  
   if ( (retcode != SUCCEED) ) {  
      printf("bcp_exec(hdbc1) Failed\n\n");  
      Cleanup();  
      return(9);  
   }  
  
   printf("Number of rows bulk copied in = %d.\n", cRows);  
  
   // Cleanup  
   SQLDisconnect(hdbc1);  
   SQLFreeHandle(SQL_HANDLE_DBC, hdbc1);  
   SQLFreeHandle(SQL_HANDLE_ENV, henv);  
}

Voir aussi

Bulk Copy Functions

Partager via