Fichiers de format XML (SQL Server)

  • Article

SQL Server 2012 fournit un schéma XML qui définit la syntaxe des fichiers de format XML à utiliser pour l'importation en bloc de données dans une table SQL Server. Les fichiers de format XML doivent respecter ce schéma, qui est défini en langage XSDL (XML Schema Definition Language). Les fichiers de format XML ne sont pris en charge que si les outils SQL Server sont installés conjointement avec SQL Server Native Client.

Vous pouvez utiliser un fichier de format XML avec une commande bcp, une instruction BULK INSERT ou une instruction INSERT ... SELECT * FROM OPENROWSET(BULK...). La commande bcp vous permet de générer automatiquement un fichier de format XML pour une table. Pour plus d'informations, consultez Utilitaire bcp.

[!REMARQUE]

Deux types de fichiers de format sont pris en charge pour l'exportation et l'importation en bloc : les fichiers de format non XML et les fichiers de format XML. Les fichiers de format XML offrent une solution souple et puissante aux fichiers de format non XML. Pour plus d'informations sur les fichiers de format non XML, consultez Fichiers de format non-XML (SQL Server).

Dans cette rubrique :

  • Avantages des fichiers de format XML

  • Structure des fichiers de format XML

  • Syntaxe de schéma pour les fichiers de format XML

  • Exemples de fichiers de format XML

  • Tâches associées

  • Contenu connexe

Avantages des fichiers de format XML

  • Les fichiers de format XML sont autodescriptifs, ce qui en facilite la lecture, la création et l'extension. Ils sont lisibles, ce qui permet de facilement comprendre la manière dont les données sont interprétées lors des opérations en bloc.

  • Les fichiers de format XML contiennent les types de données des colonnes cibles. L'encodage XML décrit clairement les types de données et les éléments de données du fichier de données ainsi que la correspondance entre les éléments de données et les colonnes de table.

    Ceci permet d'établir une séparation entre la manière dont les données sont représentées dans le fichier de données et le type de données associé à chaque champ du fichier. Par exemple, si un fichier de données contient une représentation en caractères des données, le type de colonne SQL correspondant est perdu.

  • Un format de fichier XML permet de charger un champ qui contient un seul type de données LOB à partir d'un fichier de données.

  • Un fichier de format XML peut être amélioré tout en demeurant compatible avec ses versions antérieures. En outre, la clarté de l'encodage XML facilite la création de plusieurs fichiers de format pour un fichier de données spécifique. Cela est utile si vous devez mapper tout ou partie des champs de données à des colonnes de différentes tables ou vues.

  • La syntaxe XML ne dépend pas de la direction dans laquelle s'effectue l'opération : elle est la même qu'il s'agisse d'une exportation ou d'une importation en bloc.

  • Vous pouvez utiliser les fichiers de format XML pour importer des données en bloc dans des tables ou dans des vues non partitionnées et pour exporter des données en bloc.

  • Pour la fonction OPENROWSET (BULK…), il n'est pas obligatoire de spécifier une table cible. En effet, cette fonction s'appuie sur le fichier de format XML pour lire les données d'un fichier de données.

    [!REMARQUE]

    Une table cible est nécessaire avec la commande bcp et l'instruction BULK INSERT, qui utilisent les colonnes de la table cible pour effectuer la conversion de type.

[Haut de la page]

Structure des fichiers de format XML

À l'image d'un fichier de format non-XML, un fichier de format XML définit le format et la structure des champs de données d'un fichier de données et mappe ces champs avec les colonnes d'une table cible spécifique.

Un fichier de format XML possède deux composants principaux, <RECORD> et <ROW> :

  • Le composant <RECORD> décrit les données telles qu'elles sont stockées dans le fichier de données.

    Chaque élément <RECORD> contient un jeu d'un ou plusieurs éléments <FIELD>. Ces éléments correspondent aux champs du fichier de données. La syntaxe de base est la suivante :

    <RECORD>

       <FIELD .../> [ ...n ]

    </RECORD>

    Chaque élément <FIELD> décrit le contenu d'un champ de données spécifique. Un champ ne peut être mappé qu'à une seule colonne de la table. Tous les champs ne doivent pas être mappés à des colonnes.

    Un champ d'un fichier de données peut être de longueur fixe/variable ou terminé par un caractère. Une valeur de champ peut être représentée par : un caractère (représentation sur un octet), un caractère large (représentation Unicode sur deux octets), un nom de fichier ou dans un format de base de données natif. Si une valeur de champ est représentée par un nom de fichier, celui-ci pointe vers le fichier qui contient la valeur d'une colonne BLOB de la table cible.

  • Le composant <ROW> décrit comment créer des lignes de données à partir d'un fichier de données lorsque les données du fichier sont importées dans une table SQL Server.

    Un élément <ROW> contient un ensemble d'éléments <COLUMN>. Ces éléments correspondent à des colonnes de table. La syntaxe de base est la suivante :

    <ROW>

       <COLUMN .../> [ ...n ]

    </ROW>

    Chaque élément <COLUMN> ne peut être mappé qu'à un seul champ du fichier de données. L'ordre des éléments de <COLUMN> dans l'élément <ROW> définit l'ordre dans lequel ils sont retournés par l'opération en bloc. Le fichier de format XML assigne à chaque élément <COLUMN> un nom local qui n'a aucune relation avec la colonne dans la table cible d'une opération d'importation en bloc.

[Haut de la page]

Syntaxe de schéma pour les fichiers de format XML

Cette section contient un récapitulatif des éléments et des attributs du schéma XML des fichiers de format XML. La syntaxe d'un fichier de format ne dépend pas de la direction dans laquelle s'effectue l'opération : elle est la même qu'il s'agisse d'une exportation ou d'une importation en bloc. Cette section examine également comment l'importation en bloc utilise les éléments <ROW> et <COLUMN>, et comment inclure la valeur xsi:type d'un élément dans un jeu de données.

Pour voir comment la syntaxe correspond aux fichiers de format XML réels, consultez Exemples de fichiers de format XML, plus loin dans cette rubrique.

[!REMARQUE]

Vous pouvez modifier un fichier de format de manière à effectuer une importation en bloc à partir d'un fichier de données dans lequel le nombre et/ou l'ordre des champs diffèrent du nombre et/ou de l'ordre des colonnes de données. Pour plus d'informations, consultez Fichiers de format pour l'importation ou l'exportation de données (SQL Server).

Dans cette section :

  • Syntaxe de base du schéma XML

  • Comment l'importation en bloc utilise-t-elle l'élément <ROW>

  • Comment l'importation en bloc utilise-t-elle l'élément <COLUMN>

  • Placement de la valeur xsi:type dans un ensemble de données

Syntaxe de base du schéma XML

Ces instructions de syntaxe illustrent uniquement les éléments (<BCPFORMAT>, <RECORD>, <FIELD>, <ROW> et <COLUMN>) et leurs attributs de base.

<BCPFORMAT ...>

   <RECORD>

      <FIELD ID = "fieldID" xsi:type = "fieldType" [...]

      />

   </RECORD>

   <ROW>

      <COLUMN SOURCE = "fieldID" NAME = "columnName" xsi:type = "columnType" [...]

      />

   </ROW>

</BCPFORMAT>

[!REMARQUE]

Les attributs supplémentaires qui sont associés à la valeur de xsi:type dans un élément <FIELD> ou <COLUMN> sont décrits ultérieurement dans cette rubrique.

Dans cette section :

  • Éléments du schéma

  • Attributs de l'élément <FIELD> (et valeurs Xsi:type de l'élément <FIELD>)

  • Attributs de l'élément <COLUMN> et (valeurs Xsi:type de l'élément <COLUMN>)

[Haut de la page]

Éléments du schéma

Cette section résume l'objet de chaque élément que le schéma XML définit pour les fichiers de format XML. Les attributs sont décrits dans des sections séparées plus loin dans cette rubrique.

  • <BCPFORMAT>
    Élément format-file qui définit la structure d'enregistrement d'un fichier de données spécifique et sa correspondance aux colonnes d'une ligne dans la table.

  • <RECORD .../>
    Définit un élément complexe contenant un ou plusieurs éléments <FIELD>. L'ordre dans lequel les champs sont déclarés dans le fichier de format est celui dans lequel ces champs apparaissent dans le fichier de données.

  • <FIELD .../>
    Définit un champ dans le fichier de données, qui contient des données.

    Les attributs de cet élément sont décrits dans la section Attributs de l'élément <FIELD>, plus loin dans cette rubrique.

  • <ROW .../>
    Définit un élément complexe contenant un ou plusieurs éléments <COLUMN>. L'ordre des éléments <COLUMN> est indépendant de l'ordre des éléments <FIELD> dans une définition RECORD. L'ordre des éléments <COLUMN> dans un fichier de format détermine plutôt l'ordre des colonnes de l'ensemble de lignes résultant. Les champs de données sont chargés dans l'ordre de déclaration des éléments <COLUMN> correspondants dans l'élément <COLUMN>.

    Pour plus d'informations, consultez Comment l'importation en bloc utilise-t-elle l'élément <ROW>, plus loin dans cette rubrique.

  • <COLUMN>
    Définit une colonne en tant qu'élément (<COLUMN>). Chaque élément <COLUMN> correspond à un élément <FIELD> (dont l'ID est spécifié dans l'attribut SOURCE de l'élément <COLUMN>).

    Les attributs de cet élément sont décrits dans la section Attributs de l'élément <COLUMN>, plus loin dans cette rubrique. Pour plus d'informations, consultez Comment l'importation en bloc utilise-t-elle l'élément <COLUMN>, plus loin dans cette rubrique.

  • </BCPFORMAT>
    Requis pour terminer le fichier de format.

[Haut de la page]

Attributs de l'élément <FIELD>

Cette section décrit les attributs de l'élément <FIELD>, qui sont résumés dans la syntaxe de schéma suivante :

<FIELD

   ID = "fieldID"

   xsi**:**type = "fieldType"

   [ LENGTH = "n" ]

   [ PREFIX_LENGTH = "p" ]

   [ MAX_LENGTH = "m" ]

   [ COLLATION = "collationName" ]

   [ TERMINATOR = "terminator" ]

/>

Chaque élément <FIELD> est indépendant des autres. Un champ est décrit en termes des attributs suivants :

Attribut FIELD

Description

Facultatif /

Obligatoire

ID = "fieldID"

Spécifie le nom logique du champ dans le fichier de données. L'ID d'un champ est la clé utilisée pour y faire référence.

L'élément <FIELD ID="fieldID"/> est mappé avec <COLUMN SOURCE="fieldID"/>

Obligatoire

xsi:type = "fieldType"

Il s'agit d'une construction XML (utilisée comme un attribut) qui identifie le type de l'instance de l'élément. La valeur de fieldType détermine de quels attributs facultatifs (ci-dessous) vous avez besoin dans une instance donnée.

Obligatoire (selon le type de données)

LENGTH = "n"

Cet attribut définit la longueur pour une instance d'un type de données à longueur fixe.

Cette valeur de n doit être un entier positif.

Facultatif sauf s'il est requis par la valeur xsi:type

PREFIX_LENGTH = "p"

Cet attribut définit la longueur de préfixe pour une représentation de données binaires. La valeur PREFIX_LENGTH, p, doit correspondre à l'une des valeurs suivantes : 1, 2, 4 ou 8.

Facultatif sauf s'il est requis par la valeur xsi:type

MAX_LENGTH = "m"

Cet attribut est le nombre maximal d'octets pouvant être stockés dans un champ donné. Sans table cible, la longueur maximale de la colonne est inconnue. L'attribut MAX_LENGTH limite la longueur maximale d'une colonne de caractères en sortie, limitant ainsi le stockage alloué pour la valeur de la colonne. Ceci est particulièrement pratique lors de l'utilisation de l'option BULK de la fonction OPENROWSET dans une clause SELECT FROM.

Cette valeur de m doit être un entier positif. Par défaut, la longueur maximale est de 8 000 caractères pour une colonne char et de 4 000 caractères pour une colonne nchar.

Facultatif

COLLATION = "collationName"

COLLATION est uniquement autorisé pour les champs caractères. Pour afficher la liste des noms de classements SQL, consultez Nom du classement SQL Server (Transact-SQL).

Facultatif

TERMINATOR = "terminator"

Cet attribut spécifie la marque de fin d'un champ de données. La marque de fin peut être n'importe quel caractère. La marque de fin doit être un caractère unique ne faisant pas partie des données.

Par défaut, la marque de fin de champ est le caractère tabulation (représenté par \t). Pour représenter une marque de paragraphe, utilisez \r\n.

Utilisé uniquement avec un xsi:type de données caractères, qui nécessite cet attribut

[Haut de la page]

Valeurs Xsi:type de l'élément <FIELD>

La valeur xsi:type est une construction XML (utilisée comme un attribut) qui identifie le type de données d'une instance d'un élément. Pour plus d'informations sur l'utilisation de cette valeur, consultez « Placement de la valeur xsi:type dans un ensemble de données », plus loin dans cette section.

La valeur xsi:type de l'élément <FIELD> prend en charge les types de données suivants.

Valeurs xsi:type <FIELD>

Attribut(s) XML requis

pour le type de données

Attribut(s) XML facultatif(s)

pour le type de données

NativeFixed

LENGTH

Aucun.

NativePrefix

PREFIX_LENGTH

MAX_LENGTH

CharFixed

LENGTH

COLLATION

NCharFixed

LENGTH

COLLATION

CharPrefix

PREFIX_LENGTH

MAX_LENGTH, COLLATION

NCharPrefix

PREFIX_LENGTH

MAX_LENGTH, COLLATION

CharTerm

TERMINATOR

MAX_LENGTH, COLLATION

NCharTerm

TERMINATOR

MAX_LENGTH, COLLATION

Pour plus d'informations sur les types de données Microsoft SQL Server, consultez Types de données (Transact-SQL).

[Haut de la page]

Attributs de l'élément <COLUMN>

Cette section décrit les attributs de l'élément <COLUMN>, qui sont résumés dans la syntaxe de schéma suivante :

<COLUMN

   SOURCE = "fieldID"

   NAME = "columnName"

   xsi:type = "columnType"

   [ LENGTH = "n" ]

   [ PRECISION = "n" ]

   [ SCALE = "value" ]

   [ NULLABLE = { "YES"

"NO" } ]

/>

Un champ est mappé à une colonne dans la table cible à l'aide des attributs suivants :

Attribut COLUMN

Description

Facultatif /

Obligatoire

SOURCE = "fieldID"

Spécifie l'ID du champ mappé à la colonne.

L'élément <COLUMN SOURCE="fieldID"/> est mappé avec <FIELD ID="fieldID"/>

Obligatoire

NAME = "columnName"

Spécifie le nom de la colonne dans l'ensemble de lignes représenté par le fichier de format. Ce nom de colonne est utilisé pour identifier la colonne dans le jeu de résultats, et il ne doit pas nécessairement correspondre au nom de colonne utilisé dans la table cible.

Obligatoire

xsi:type = "ColumnType"

Il s'agit d'une construction XML (utilisée comme un attribut) qui identifie le type de données de l'instance de l'élément. La valeur de ColumnType détermine de quels attributs facultatifs (ci-dessous) vous avez besoin dans une instance donnée.

[!REMARQUE]

Les valeurs possibles de ColumnType et leurs attributs associés sont répertoriés dans le tableau suivant.

Facultatif

LENGTH = "n"

Définit la longueur d'une instance d'un type de données à longueur fixe. LENGTH est utilisé uniquement lorsque xsi:type est un type de données string.

Cette valeur de n doit être un entier positif.

Facultatif (disponible uniquement si xsi:type est un type de données string)

PRECISION = "n"

Nombre de chiffres qui composent un nombre. Par exemple, le nombre 123,45 a une précision de 5.

Cette valeur doit être un entier positif.

Facultatif (disponible uniquement si xsi:type est un type de données variable-number)

SCALE = "int"

Indique le nombre de chiffres à droite du point décimal (notre virgule) dans un nombre. Par exemple, le nombre 123,45 a une précision de 2.

La valeur doit être un entier.

Facultatif (disponible uniquement si xsi:type est un type de données variable-number)

NULLABLE = { "YES"

"NO" }

Indique si une colonne peut prendre des valeurs NULL. Cet attribut est complètement indépendant de FIELDS. Cependant, si une colonne n'est pas NULLABLE et si le champ spécifie NULL (en ne spécifiant pas de valeur), une erreur d'exécution en résulte.

L'attribut NULLABLE est utilisé uniquement si vous effectuez une instruction SELECT FROM OPENROWSET(BULK...) ordinaire.

Facultatif (disponible pour n'importe quel type de données)

[Haut de la page]

Valeurs Xsi:type de l'élément <COLUMN>

La valeur xsi:type est une construction XML (utilisée comme un attribut) qui identifie le type de données d'une instance d'un élément. Pour plus d'informations sur l'utilisation de cette valeur, consultez « Placement de la valeur xsi:type dans un ensemble de données », plus loin dans cette section.

L'élément <COLUMN> prend en charge les types de données SQL natifs :

Catégorie de type

Types de données <COLUMN>

Attribut(s) XML requis

pour le type de données

Attribut(s) XML facultatif(s)

pour le type de données

Fixe

SQLBIT, SQLTINYINT, SQLSMALLINT, SQLINT, SQLBIGINT, SQLFLT4, SQLFLT8, SQLDATETIME, SQLDATETIM4, SQLDATETIM8, SQLMONEY, SQLMONEY4, SQLVARIANT et SQLUNIQUEID

Aucun.

NULLABLE

Nombre variable

SQLDECIMAL et SQLNUMERIC

Aucun.

NULLABLE, PRECISION, SCALE

LOB

SQLIMAGE, CharLOB, SQLTEXT et SQLUDT

Aucun.

NULLABLE

LOB caractère

SQLNTEXT

Aucun.

NULLABLE

Chaîne binaire

SQLBINARY et SQLVARYBIN

Aucun.

NULLABLE, LENGTH

Chaîne de caractères

SQLCHAR, SQLVARYCHAR, SQLNCHAR et SQLNVARCHAR

Aucun.

NULLABLE, LENGTH

Important

Pour exporter ou importer en bloc des données SQLXML, utilisez l'un des types de données ci-dessous dans votre fichier de format : SQLCHAR ou SQLVARYCHAR (les données sont envoyées dans la page de codes du client ou dans la page de codes inhérente au classement) ; SQLNCHAR ou SQLNVARCHAR (les données sont envoyées au format Unicode) ; SQLBINARY ou SQLVARYBIN (les données sont envoyées sans être converties).

Pour plus d'informations sur les types de données SQL Server, consultez Types de données (Transact-SQL).

[Haut de la page]

Comment l'importation en bloc utilise-t-elle l'élément <ROW>

L'élément <ROW> est ignoré dans certains contextes. L'éventuelle incidence d'un élément <ROW> sur une opération d'importation en bloc dépend du mode d'exécution de l'opération :

  • Commande bcp

    Lorsque des données sont chargées dans une table cible, bcp ignore le composant <ROW>. bcp charge plutôt les données en fonction des types de colonnes de la table cible.

  • Instructions Transact-SQL (fournisseur d'ensembles de lignes BULK INSERT et OPENROWSET)

    Lors de l'importation de données en bloc dans une table, les instructions Transact-SQL utilisent le composant <ROW> pour générer l'ensemble de lignes d'entrée. En outre, les instructions Transact-SQL effectuent les conversions de type appropriées en fonction des types de colonnes spécifiés sous <ROW> et de la colonne correspondante dans la table cible. Si une discordance existe entre les types de colonnes spécifiés dans le fichier de format et dans la table cible, une conversion de type supplémentaire intervient. Cette conversion de type supplémentaire peut entraîner certaines différences (c'est-à-dire, une perte de précision) dans le comportement du fournisseur d'ensembles de lignes en bloc BULK INSERT ou OPENROWSET en comparaison avec bcp.

    Les informations de l'élément <ROW> permettent de construire une ligne sans nécessiter d'informations supplémentaires. Pour cette raison, vous pouvez générer un ensemble de lignes en utilisant l'instruction SELECT (SELECT * FROM OPENROWSET(BULK datafile FORMATFILE=xmlformatfile).

    [!REMARQUE]

    La clause OPENROWSET BULK nécessite un fichier de format (notez que la conversion du type de données du champ au type de données d'une colonne n'est possible qu'avec un fichier de format XML).

[Haut de la page]

Comment l'importation en bloc utilise-t-elle l'élément <COLUMN>

Pour l'importation de données en bloc dans une table, les éléments<COLUMN> dans un fichier de format mappent un champ de fichier de données à des colonnes de table en spécifiant :

  • La position de chaque champ dans une ligne du fichier de données.

  • Le type de colonne, qui est utilisé pour convertir le type de données du champ au type de données de la colonne souhaitée.

Si aucune colonne n'est mappée à un champ, le champ n'est pas copié dans la ou les lignes générées. Ce comportement permet à un fichier de données de générer des lignes avec différentes colonnes (dans différentes tables).

De même, pour l'exportation de données en bloc à partir d'une table, chaque élément <COLUMN> du fichier de format mappe la colonne de ligne de la table d'entrée à son champ correspondant du fichier de données de sortie.

[Haut de la page]

Placement de la valeur xsi:type dans un ensemble de données

Lorsqu'un document XML est validé à travers le langage XSD (XML Schema Definition), la valeur xsi:type n'est pas placée dans l'ensemble de données. Cependant, vous pouvez placer les informations xsi:type dans l'ensemble de données en chargeant le fichier de format XML dans un document XML (par exemple, myDoc), tel qu'illustré dans l'extrait de code suivant :

...;
myDoc.LoadXml(xmlFormat);
XmlNodeList ColumnList = myDoc.GetElementsByTagName("COLUMN");
for(int i=0;i<ColumnList.Count;i++)
{
   Console.Write("COLUMN: xsi:type=" +ColumnList[i].Attributes["type",
      "http://www.w3.org/2001/XMLSchema-instance"].Value+"\n");
}

[Haut de la page]

Exemples de fichiers de format XML

Cette section contient des informations sur l'utilisation de fichiers de format XML dans différents cas de figure, avec un exemple Adventure Works.

[!REMARQUE]

Dans les fichiers de données illustrés dans les exemples ci-dessous, <tab> indique un caractère de tabulation et <return>, un retour chariot.

Ces exemples illustrent les aspects essentiels de l'utilisation de fichiers de format XML :

  • Classement de champs de données caractères dans le même ordre que les colonnes d'une table

  • Classement de champs de données et de colonnes d'une table dans un ordre différent

  • Omission d'un champ de données

  • Mappage de différents types de champs sur des colonnes

  • Mappage de données XML sur une table

  • Importation de champs à longueur fixe ou à largeur fixe

  • Autre exemple

[!REMARQUE]

Pour plus d'informations sur la création de fichiers de format, consultez Créer un fichier de format (SQL Server).

A.Classement de champs de données caractères dans le même ordre que les colonnes d'une table

L'exemple suivant illustre un fichier de format XML décrivant un fichier de données qui contient trois champs de données caractères. Le fichier de format mappe le fichier de données sur une table contenant trois colonnes. Les champs de données correspondent un-à-un aux colonnes de la table.

Table (ligne) : Person (Age int, FirstName varchar(20), LastName varchar(30))

Fichier de données (enregistrement) : Age<tab>Firstname<tab>Lastname<retour>

Le fichier de format XML suivant lit les données du fichier de données et les écrit dans la table.

Dans l'élément <RECORD>, le fichier de format représente les valeurs de données de chacun des trois champs au format caractère. Pour chaque champ, l'attribut TERMINATOR indique le terminateur qui suit la valeur de données.

Les champs de données correspondent un-à-un aux colonnes de la table. Dans l'élément <ROW>, le fichier de format mappe la colonne Age au premier champ, la colonne FirstName au deuxième et la colonne LastName au troisième.

<?xml version="1.0"?>
<BCPFORMAT 
xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <RECORD>
    <FIELD ID="1" xsi:type="CharTerm" TERMINATOR="\t" 
      MAX_LENGTH="12"/> 
    <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="\t" 
      MAX_LENGTH="20" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
    <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="\r\n" 
      MAX_LENGTH="30" 
      COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  </RECORD>
  <ROW>
    <COLUMN SOURCE="1" NAME="age" xsi:type="SQLINT"/>
    <COLUMN SOURCE="2" NAME="firstname" xsi:type="SQLVARYCHAR"/>
    <COLUMN SOURCE="3" NAME="lastname" xsi:type="SQLVARYCHAR"/>
  </ROW>
</BCPFORMAT>

[!REMARQUE]

Pour un exemple AdventureWorks2012 équivalent, consultez Créer un fichier de format (SQL Server).

[Haut de la page]

B.Classement de champs de données et de colonnes d'une table dans un ordre différent

L'exemple suivant illustre un fichier de format XML décrivant un fichier de données qui contient trois champs de données caractères. Le fichier de format mappe le fichier de données sur une table contenant trois colonnes classées dans un ordre différent de celui des champs du fichier de données.

Table (ligne) : Person (Age int, FirstName varchar(20), LastName varchar(30))

Fichier de données (enregistrement) : Age<tab>Lastname<tab>Firstname<retour>

Dans l'élément <RECORD>, le fichier de format représente les valeurs de données de chacun des trois champs au format caractère.

Dans l'élément <ROW>, le fichier de format mappe la colonne Age au premier champ, la colonne FirstName au troisième et la colonne LastName au second.

<?xml version="1.0"?>
<BCPFORMAT 
xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <RECORD>
    <FIELD ID="1" xsi:type="CharTerm" TERMINATOR="\t" 
      MAX_LENGTH="12"/>
    <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="\t" MAX_LENGTH="20" 
      COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
    <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="\r\n" 
      MAX_LENGTH="30" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  </RECORD>
  <ROW>
    <COLUMN SOURCE="1" NAME="age" xsi:type="SQLINT"/>
    <COLUMN SOURCE="3" NAME="firstname" xsi:type="SQLVARYCHAR"/>
    <COLUMN SOURCE="2" NAME="lastname" xsi:type="SQLVARYCHAR"/>
  </ROW>
</BCPFORMAT>

[!REMARQUE]

Pour un exemple AdventureWorks2012 équivalent, consultez Utiliser un fichier de format pour mapper les colonnes d'une table aux champs d'un fichier de données (SQL Server).

[Haut de la page]

C.Omission d'un champ de données

L'exemple suivant illustre un fichier de format XML décrivant un fichier de données qui contient quatre champs de données caractères. Le fichier de format mappe le fichier de données sur une table contenant trois colonnes. Le deuxième champ de données ne correspond à aucune colonne de la table.

Table (ligne) : Person (Age int, FirstName varchar(20), LastName varchar(30))

Fichier de données (enregistrement) : Age<tab>employeeID<tab>Firstname<tab>Lastname<retour>

Dans l'élément <RECORD>, le fichier de format représente les valeurs de données de chacun des quatre champs au format caractère. Pour chaque champ, l'attribut TERMINATOR indique le terminateur qui suit la valeur de données.

Dans l'élément <ROW>, le fichier de format mappe la colonne Age au premier champ, la colonne FirstName au troisième et la colonne LastName au quatrième.

<?xml version="1.0"?>

<BCPFORMAT 
xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <RECORD>
    <FIELD ID="1" xsi:type="CharTerm" TERMINATOR="\t" 
      MAX_LENGTH="12"/>
    <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="\t" 
      MAX_LENGTH="10" 
      COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
    <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="\t" 
      MAX_LENGTH="20" 
      COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
    <FIELD ID="4" xsi:type="CharTerm" TERMINATOR="\r\n" 
      MAX_LENGTH="30" 
      COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  </RECORD>
  <ROW>
    <COLUMN SOURCE="1" NAME="age" xsi:type="SQLINT"/>
    <COLUMN SOURCE="3" NAME="firstname" xsi:type="SQLVARYCHAR"/>
    <COLUMN SOURCE="4" NAME="lastname" xsi:type="SQLVARYCHAR"/>
  </ROW>
</BCPFORMAT>

[!REMARQUE]

Pour un exemple AdventureWorks2012 équivalent, consultez Utiliser un fichier de format pour ignorer un champ de données (SQL Server).

[Haut de la page]

D.Mappage de <FIELD> xsi:type sur <COLUMN> xsi:type

L'exemple suivant illustre différents types de champs et leurs mappages sur des colonnes.

<?xml version = "1.0"?>
<BCPFORMAT
xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <RECORD>
      <FIELD xsi:type="CharTerm" ID="C1" TERMINATOR="\t" 
            MAX_LENGTH="4"/>
      <FIELD xsi:type="CharFixed" ID="C2" LENGTH="10" 
         COLLATION="SQL_LATIN1_GENERAL_CP1_CI_AS"/>
      <FIELD xsi:type="CharPrefix" ID="C3" PREFIX_LENGTH="2" 
         MAX_LENGTH="32" COLLATION="SQL_LATIN1_GENERAL_CP1_CI_AS"/>
      <FIELD xsi:type="NCharTerm" ID="C4" TERMINATOR="\t" 
         MAX_LENGTH="4"/>
      <FIELD xsi:type="NCharFixed" ID="C5" LENGTH="10" 
         COLLATION="SQL_LATIN1_GENERAL_CP1_CI_AS"/>
      <FIELD xsi:type="NCharPrefix" ID="C6" PREFIX_LENGTH="2" 
         MAX_LENGTH="32" COLLATION="SQL_LATIN1_GENERAL_CP1_CI_AS"/>
      <FIELD xsi:type="NativeFixed" ID="C7" LENGTH="4"/>
   </RECORD>
   <ROW>
      <COLUMN SOURCE="C1" NAME="Age" xsi:type="SQLTINYINT"/>
      <COLUMN SOURCE="C2" NAME="FirstName" xsi:type="SQLVARYCHAR" 
      LENGTH="16" NULLABLE="NO"/>
      <COLUMN SOURCE="C3" NAME="LastName" />
      <COLUMN SOURCE="C4" NAME="Salary" xsi:type="SQLMONEY"/>
      <COLUMN SOURCE="C5" NAME="Picture" xsi:type="SQLIMAGE"/>
      <COLUMN SOURCE="C6" NAME="Bio" xsi:type="SQLTEXT"/>
      <COLUMN SOURCE="C7" NAME="Interest"xsi:type="SQLDECIMAL" 
      PRECISION="5" SCALE="3"/>
   </ROW>
</BCPFORMAT>

[Haut de la page]

E.Mappage de données XML sur une table

Dans l'exemple ci-dessous, une table (t_xml) vide à deux colonnes est créée : sa première colonne est mappée sur le type de données int et la seconde, sur le type de données xml.

CREATE TABLE t_xml (c1 int, c2 xml)

Le fichier de format XML suivant charge un fichier de données dans la table t_xml.

<?xml version="1.0"?>
<BCPFORMAT xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <RECORD>
  <FIELD ID="1" xsi:type="NativePrefix" PREFIX_LENGTH="1"/>
  <FIELD ID="2" xsi:type="NCharPrefix" PREFIX_LENGTH="8"/>
 </RECORD>
 <ROW>
  <COLUMN SOURCE="1" NAME="c1" xsi:type="SQLINT"/>
  <COLUMN SOURCE="2" NAME="c2" xsi:type="SQLNCHAR"/>
 </ROW>
</BCPFORMAT>

[Haut de la page]

F.Importation de champs à longueur fixe ou à largeur fixe

L'exemple suivant décrit des champs fixes de 10 ou 6 caractères chacun. Le fichier de format représente ces longueurs-largeurs de champ sous la forme de LENGTH="10" et LENGTH="6", respectivement. Chaque ligne des fichiers de donnée se termine par une combinaison retour chariot/saut de ligne, {CR}{LF}, représentée par le fichier de format sous la forme TERMINATOR="\r\n".

<?xml version="1.0"?>
<BCPFORMAT
       xmlns="https://schemas.microsoft.com/sqlserver/2004/bulkload/format"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <RECORD>
    <FIELD ID="1" xsi:type="CharFixed" LENGTH="10"/>
    <FIELD ID="2" xsi:type="CharFixed" LENGTH="6"/>
    <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="\r\n"
  </RECORD>
  <ROW>
    <COLUMN SOURCE="1" NAME="C1" xsi:type="SQLINT" />
    <COLUMN SOURCE="2" NAME="C2" xsi:type="SQLINT" />
  </ROW>
</BCPFORMAT>

[Haut de la page]

Autres exemples

Les rubriques suivantes contiennent des exemples supplémentaires de fichiers de format non XML et de fichiers de format XML :

[Haut de la page]

Tâches associées

[Haut de la page]

Contenu connexe

Aucun.

Voir aussi

Référence

Types de données (Transact-SQL)

Concepts

Importation et exportation en bloc de données (SQL Server)

Fichiers de format non-XML (SQL Server)

Fichiers de format pour l'importation ou l'exportation de données (SQL Server)