Opérations de copie en bloc uniques (ADO.NET)
L'approche la plus simple de l'exécution d'une opération de copie en bloc SQL Server consiste à exécuter une opération unique sur une base de données. Par défaut, une opération de copie en bloc s'effectue comme une opération isolée : l'opération de copie se produit de façon non traitée, sans possibilité de restauration.
.gif "Remarque") Remarque |
|---|
Si vous devez restaurer tout ou partie de la copie en bloc en cas d'erreur, vous pouvez soit utiliser une transaction SqlBulkCopy managée, soit effectuer une opération de copie en bloc à l'intérieur d'une transaction existante.SqlBulkCopy fonctionne également avec System.Transactions si la connexion est inscrite (implicitement ou explicitement) dans une transaction System.Transactions. Pour plus d'informations, voir Transaction et opérations de copie en bloc (ADO.NET). |
Les étapes générales pour l'exécution d'une opération de copie en bloc sont les suivantes :
Connectez-vous au serveur source et obtenez les données à copier. Les données peuvent également provenir d'autres sources si elles peuvent être extraites d'un objet IDataReader ou DataTable.
Connectez-vous au serveur de destination (à moins que vous souhaitiez que SqlBulkCopy établisse une connexion à votre place).
Créez un objet SqlBulkCopy en définissant toutes les propriétés nécessaires.
Définissez la propriété DestinationTableName pour indiquer la table cible pour l'opération d'insertion en bloc.
Appelez l'une des méthodes WriteToServer.
À titre facultatif, mettez à jour les propriétés et appelez de nouveau la méthode WriteToServer si nécessaire.
Appelez Close ou enveloppez les opérations de copie en bloc dans une instruction Using.
.gif "Remarque Attention") Attention |
|---|
Il est recommandé que les types de données des colonnes source et cible correspondent.Si les types de données ne correspondent pas, SqlBulkCopy tente de convertir chaque valeur source vers le type de données cible en utilisant les règles employées par Value.Les conversions peuvent affecter les performances et générer des erreurs inattendues.Par exemple, un type de données Double peut généralement être converti en un type de données Decimal, mais pas toujours. |
Exemple
L'application console suivante montre comment charger des données à l'aide de la classe SqlBulkCopy. Dans cet exemple, SqlDataReader est utilisé pour copier des données de la table Production.Product dans la base de données AdventureWorks SQL Server 2005 vers une table semblable dans la même base de données.
| Important |
|---|
Cet exemple ne s'exécutera pas à moins que vous ayez créé les tables de travail comme décrit dans la rubrique Configuration de l'exemple de copie en bloc (ADO.NET).Ce code est fourni uniquement pour illustrer la syntaxe de l'utilisation de SqlBulkCopy.Si les tables sources et de destination se trouvent dans la même instance SQL Server, il est plus facile et plus rapide d'utiliser une instruction Transact-SQL INSERT … SELECT pour copier les données. |
Imports System.Data.SqlClient
Module Module1
Sub Main()
Dim connectionString As String = GetConnectionString()
' Open a connection to the AdventureWorks database.
Using sourceConnection As SqlConnection = _
New SqlConnection(connectionString)
sourceConnection.Open()
' Perform an initial count on the destination table.
Dim commandRowCount As New SqlCommand( _
"SELECT COUNT(*) FROM dbo.BulkCopyDemoMatchingColumns;", _
sourceConnection)
Dim countStart As Long = _
System.Convert.ToInt32(commandRowCount.ExecuteScalar())
Console.WriteLine("Starting row count = {0}", countStart)
' Get data from the source table as a SqlDataReader.
Dim commandSourceData As SqlCommand = New SqlCommand( _
"SELECT ProductID, Name, ProductNumber " & _
"FROM Production.Product;", sourceConnection)
Dim reader As SqlDataReader = commandSourceData.ExecuteReader
' Open the destination connection. In the real world you would
' not use SqlBulkCopy to move data from one table to the other
' in the same database. This is for demonstration purposes only.
Using destinationConnection As SqlConnection = _
New SqlConnection(connectionString)
destinationConnection.Open()
' Set up the bulk copy object.
' The column positions in the source data reader
' match the column positions in the destination table,
' so there is no need to map columns.
Using bulkCopy As SqlBulkCopy = _
New SqlBulkCopy(destinationConnection)
bulkCopy.DestinationTableName = _
"dbo.BulkCopyDemoMatchingColumns"
Try
' Write from the source to the destination.
bulkCopy.WriteToServer(reader)
Catch ex As Exception
Console.WriteLine(ex.Message)
Finally
' Close the SqlDataReader. The SqlBulkCopy
' object is automatically closed at the end
' of the Using block.
reader.Close()
End Try
End Using
' Perform a final count on the destination table
' to see how many rows were added.
Dim countEnd As Long = _
System.Convert.ToInt32(commandRowCount.ExecuteScalar())
Console.WriteLine("Ending row count = {0}", countEnd)
Console.WriteLine("{0} rows were added.", countEnd - countStart)
Console.WriteLine("Press Enter to finish.")
Console.ReadLine()
End Using
End Using
End Sub
Private Function GetConnectionString() As String
' To avoid storing the sourceConnection string in your code,
' you can retrieve it from a configuration file.
Return "Data Source=(local);" & _
"Integrated Security=true;" & _
"Initial Catalog=AdventureWorks;"
End Function
End Module
using System.Data.SqlClient;
class Program
{
static void Main()
{
string connectionString = GetConnectionString();
// Open a sourceConnection to the AdventureWorks database.
using (SqlConnection sourceConnection =
new SqlConnection(connectionString))
{
sourceConnection.Open();
// Perform an initial count on the destination table.
SqlCommand commandRowCount = new SqlCommand(
"SELECT COUNT(*) FROM " +
"dbo.BulkCopyDemoMatchingColumns;",
sourceConnection);
long countStart = System.Convert.ToInt32(
commandRowCount.ExecuteScalar());
Console.WriteLine("Starting row count = {0}", countStart);
// Get data from the source table as a SqlDataReader.
SqlCommand commandSourceData = new SqlCommand(
"SELECT ProductID, Name, " +
"ProductNumber " +
"FROM Production.Product;", sourceConnection);
SqlDataReader reader =
commandSourceData.ExecuteReader();
// Open the destination connection. In the real world you would
// not use SqlBulkCopy to move data from one table to the other
// in the same database. This is for demonstration purposes only.
using (SqlConnection destinationConnection =
new SqlConnection(connectionString))
{
destinationConnection.Open();
// Set up the bulk copy object.
// Note that the column positions in the source
// data reader match the column positions in
// the destination table so there is no need to
// map columns.
using (SqlBulkCopy bulkCopy =
new SqlBulkCopy(destinationConnection))
{
bulkCopy.DestinationTableName =
"dbo.BulkCopyDemoMatchingColumns";
try
{
// Write from the source to the destination.
bulkCopy.WriteToServer(reader);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
finally
{
// Close the SqlDataReader. The SqlBulkCopy
// object is automatically closed at the end
// of the using block.
reader.Close();
}
}
// Perform a final count on the destination
// table to see how many rows were added.
long countEnd = System.Convert.ToInt32(
commandRowCount.ExecuteScalar());
Console.WriteLine("Ending row count = {0}", countEnd);
Console.WriteLine("{0} rows were added.", countEnd - countStart);
Console.WriteLine("Press Enter to finish.");
Console.ReadLine();
}
}
}
private static string GetConnectionString()
// To avoid storing the sourceConnection string in your code,
// you can retrieve it from a configuration file.
{
return "Data Source=(local); " +
" Integrated Security=true;" +
"Initial Catalog=AdventureWorks;";
}
}
Exécution d'une opération de copie en bloc à l'aide de Transact-SQL et de la classe Command
Lorsque vous utilisez .NET Framework version 1.1 ou une version antérieure (qui ne prend pas en charge la classe SqlBulkCopy), vous pouvez également exécuter l'instruction Transact-SQL BULK INSERT à l'aide de l'objet SqlCommand. Notez que l'utilisation de cette technique est totalement indépendante de l'utilisation de la fonctionnalité de copie en bloc du fournisseur de données .NET Framework pour SQL Server.
L'exemple suivant illustre la manière d'utiliser la méthode ExecuteNonQuery pour exécuter l'instruction BULK INSERT.
| Remarque |
|---|
Le chemin d'accès au fichier de la source de données est relatif par rapport au serveur.Le processus serveur doit avoir accès à ce chemin d'accès pour que l'opération de copie en bloc réussisse. |
Using connection As SqlConnection = New SqlConnection(connectionString)
Dim queryString As String = _
"BULK INSERT Northwind.dbo.[Order Details] FROM " & _
"'f:\mydata\data.tbl' WITH (FORMATFILE='f:\mydata\data.fmt' )"
connection.Open()
SqlCommand command = New SqlCommand(queryString, connection);
command.ExecuteNonQuery()
End Using
using (SqlConnection connection = New SqlConnection(connectionString))
{
string queryString = "BULK INSERT Northwind.dbo.[Order Details] " +
"FROM 'f:\mydata\data.tbl' " +
"WITH ( FORMATFILE='f:\mydata\data.fmt' )";
connection.Open();
SqlCommand command = new SqlCommand(queryString, connection);
command.ExecuteNonQuery();
}