Spécification des indicateurs de fin de champ et de fin de ligne

Caractères pris en charge en tant qu'indicateurs de fin

La commande bcp, l'instruction BULK INSERT et le fournisseur d'ensembles de lignes en bloc OPENROWSET prennent en charge un choix complet de caractères pouvant être utilisés en tant qu'indicateurs de fin de champ ou de fin de ligne et recherchent systématiquement la première occurrence de chacun de ces indicateurs. Le tableau ci-dessous répertorie les caractères pris en charge pour les terminateurs.

1 Seuls les caractères t, n, r, 0, et '\0' fonctionnent avec le caractère d'échappement Barre oblique inverse pour générer un caractère de contrôle.

2 Bien que le caractère de contrôle null (\0) ne soit pas visible à l'impression, il constitue bel et bien un caractère à part dans le fichier de données. En d'autres termes, utiliser ce caractère en tant qu'indicateur de fin de champ ou de fin de ligne ne revient pas à simplement omettre cet indicateur de fin.

Manipulation des indicateurs de fin de ligne

L'indicateur de fin de ligne peut être le même que celui employé en tant qu'indicateur du dernier champ. Cependant, un indicateur de fin de ligne distinct s'avère généralement plus utile. Par exemple, afin d'obtenir en sortie des tabulations, marquez la fin du dernier champ de chaque ligne par le caractère de saut de ligne (\n) et la fin de tous les autres champs par le caractère de tabulation (\t). Pour placer chaque enregistrement de données dans une ligne séparée dans le fichier de données, attribuez la combinaison de caractères \r\n à l'indicateur de fin de ligne.

Spécification d'indicateurs pour l'exportation en bloc

Si vous procédez à une exportation en bloc des données de type char ou nchar, mais que vous voulez utiliser un indicateur de fin autre que celui défini par défaut, vous devez alors indiquer ce dernier à la commande bcp. Vous pouvez le spécifier de l'une des façons suivantes :

• Grâce à un fichier de format précisant l'indicateur de fin pour chaque champ.

  [!REMARQUE]

  Pour plus d'informations sur l'utilisation des fichiers de format, consultez Fichiers de format pour l'importation ou l'exportation de données.

• Sans avoir recours à un fichier de format, les options suivantes sont aussi à votre disposition :

  • Par le biais du commutateur -t, afin de préciser l'indicateur de fin de ligne pour tous les champs à l'exception du dernier champ de la ligne et grâce au commutateur -r pour préciser un indicateur de fin de ligne.

  • En utilisant un commutateur pour préciser le format de caractère (-c ou -w) sans le commutateur -t, afin de définir l'indicateur de fin de champ sur le caractère de tabulation \t. Ceci revient à spécifier -t\t.

    [!REMARQUE]

    Si vous ajoutez le commutateur -n (correspondant aux données natives) ou -N (format natif Unicode), les indicateurs de fin ne sont alors pas insérés.

  • Si une commande bcp interactive contient l'option in ou out sans le commutateur du fichier de format (-f) ou celui du fichier de données (-n, -c, -w ou -N) mais que vous n'avez pas non plus précisé la longueur du préfixe et la longueur de champ, la commande vous invite alors à saisir l'indicateur de fin de champ de chaque champ, tout en vous proposant par défaut de ne pas en spécifier :

    Enter field terminator [none]:

    généralement, cette valeur par défaut convient. Dans le cas des champs de données de type char ou nchar, consultez cependant la sous-section « Instructions pour l'utilisation d'indicateurs de fin ». Pour un exemple de cette invite dans son contexte, consultez Spécification de formats de données pour la compatibilité à l'aide de bcp.

    [!REMARQUE]

    Après avoir indiqué de façon interactive tous les champs dans la commande bcp, cette dernière vous invite enfin à sauvegarder vos réponses dans un fichier de format autre que XML pour chacun des champs fournis. Pour plus d'informations sur les fichiers de format non XML, consultez Description des fichiers de format non XML.

Instructions pour l'utilisation d'indicateurs de fin

Exemple

bcp AdventureWorks.HumanResources.Department out C:\myDepartment-c-t.txt -c -t, -r \n -T

Spécification des terminateurs pour l'importation en bloc

Lorsque vous procédez à une importation en bloc de données de type char ou nchar, la commande prévue à cet effet doit reconnaître les indicateurs de fin utilisés dans le fichier de données. Voici comment les indicateurs de fin doivent être précisés selon la commande d'importation en bloc :

• bcp

  Spécifier des terminateurs pour une opération d'importation revient à utiliser la même syntaxe que pour une opération d'exportation. Pour plus d'informations, consultez la section « Spécification des terminateurs pour l'exportation en bloc », plus haut dans cette rubrique.

• BULK INSERT

  Les terminateurs peuvent être spécifiés pour chaque champ d'un fichier de format ou pour le fichier de données tout entier grâce aux qualificateurs répertoriés dans le tableau suivant.

  Qualificateur	Description
  FIELDTERMINATOR ='field_terminator'	Spécifie l'indicateur de fin de champ à utiliser pour les fichiers de données de type caractère et de type caractère Unicode. Par défaut, c'est le caractère de tabulation (\t).
  ROWTERMINATOR ='row_terminator'	Spécifie l'indicateur de fin de ligne à utiliser pour les fichiers de données de type caractère et de type caractère Unicode. Par défaut, il s'agit du caractère de saut de ligne (\n).

  Pour plus d'informations, consultez BULK INSERT (Transact-SQL).

• INSERT ... SELECT * FROM OPENROWSET(BULK...)

  Dans le cas du fournisseur de l'ensemble de lignes en bloc OPENROWSET, les indicateurs de fin ne peuvent être précisés que dans le fichier de format (requis sauf dans le cas de types de données incluses dans un objet volumineux). Si un fichier de données de type caractère utilise un indicateur de fin qui ne soit pas un indicateur par défaut, ce dernier doit alors être défini dans le fichier de format. Pour plus d'informations, consultez Création d'un fichier de format et Utilisation d'un fichier de format pour importer des données en bloc.

  Pour plus d'informations sur la clause OPENROWSET BULK, consultez OPENROWSET (Transact-SQL).

Exemples

USE AdventureWorks;
GO
DROP TABLE myDepartment;
CREATE TABLE myDepartment 
(DepartmentID smallint,
Name nvarchar(50),
GroupName nvarchar(50) NULL,
ModifiedDate datetime not NULL CONSTRAINT DF_AddressType_ModifiedDate DEFAULT (GETDATE())
);
GO

bcp AdventureWorks..myDepartment in C:\myDepartment-c-t.txt -c -t , -r \n -T

USE AdventureWorks;
GO
BULK INSERT myDepartment FROM 'C:\myDepartment-c-t.txt'
   WITH (
      DATAFILETYPE = 'char',
      FIELDTERMINATOR = ',',
      ROWTERMINATOR = '\n'
);
GO

Voir aussi

Référence

Concepts