Sintassi dello schema per file di formato XML

Sintassi di base dello schema XML

Nelle istruzioni seguenti sono riportati solo gli elementi (<BCPFORMAT>, <RECORD>, <FIELD>, <ROW> e <COLUMN>) e i relativi attributi di base.

<BCPFORMAT ...>

   <RECORD>

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

      />

   </RECORD>

   <ROW>

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

      />

   </ROW>

</BCPFORMAT>

Descrizione degli elementi dello schema

Attributi dell'elemento <FIELD>

Attributi dell'elemento <COLUMN>

In questa sezione sono illustrati gli attributi dell'elemento <COLUMN>, riepilogati nella sintassi dello schema seguente:

<COLUMN

   SOURCE = "fieldID"

   NAME = "columnName"

   xsi:type = "columnType"

   [ LENGTH = "n" ]

   [ PRECISION = "n" ]

   [ SCALE = "value" ]

   [ NULLABLE = { "YES"

"NO" } ]

/>

Per l'associazione di un campo a una colonna nella tabella di destinazione vengono utilizzati gli attributi seguenti:

Attributo COLUMN	Descrizione	Facoltativo / Obbligatorio
SOURCE ="fieldID"	Specifica l'ID del campo da associare alla colonna. <COLUMN SOURCE="fieldID"/> esegue il mapping a <FIELD ID="fieldID"/>	Obbligatorio
NAME = "columnName"	Specifica il nome della colonna del set di righe rappresentato dal file di formato. Viene utilizzato per identificare la colonna nel set dei risultati e non corrisponde necessariamente al nome di colonna utilizzato nella tabella di destinazione.	Obbligatorio
xsi:type ="ColumnType"	Costrutto XML, utilizzato in modo simile a un attributo, che identifica il tipo di dati dell'istanza dell'elemento. Il valore di ColumnType determina gli attributi opzionali, riportati di seguito, necessari in un'istanza specifica. Nota Nella tabella seguente sono elencati i possibili valori di ColumnType nonché i relativi attributi associati.	Facoltativo
LENGTH ="n"	Definisce la lunghezza per un'istanza di un tipo di dati a lunghezza fissa. Viene utilizzato solo quanto il valore xsi:type corrisponde a un tipo di dati string. Il valore di n deve essere un numero intero positivo.	Facoltativo (disponibile solo se il valore xsi:type corrisponde a un tipo di dati string)
PRECISION ="n"	Indica il numero di cifre in un numero. Il numero 123,45, ad esempio, ha una precisione di 5. Il valore deve essere un numero intero positivo.	Facoltativo (disponibile solo se il valore xsi:type corrisponde a un tipo di dati numerico variabile)
SCALE ="int"	Indica il numero di cifre a destra della virgola decimale in un numero. Il numero 123,45, ad esempio, ha una scala di 2. Il valore deve essere un numero intero.	Facoltativo (disponibile solo se il valore xsi:type corrisponde a un tipo di dati numerico variabile)
NULLABLE = { "YES" "NO" }	Indica se una colonna supporta o meno valori NULL. Questo attributo è completamente indipendente da FIELDS. Se, tuttavia, una colonna non ammette valori NULL e il valore del campo è NULL, ovvero non è stato specificato alcun valore, verrà restituito un errore di run-time. L'attributo NULLABLE viene utilizzato solo se si esegue un'istruzione SELECT FROM OPENROWSET (BULK...) semplice.	Facoltativo (disponibile per qualsiasi tipo di dati)

Valori Xsi:type dell'elemento <COLUMN>

Il valore xsi:type è un costrutto XML, utilizzato in modo simile a un attributo, che identifica il tipo di dati di un'istanza di un elemento. Per informazioni sull'utilizzo di questo valore, vedere "Inserimento del valore xsi:type in un set di dati", più avanti in questa sezione.

L'elemento <COLUMN> supporta i tipi di dati SQL nativi, come descritto di seguito:

Categoria del tipo	Tipi di dati di <COLUMN>	Attributi XML obbligatori per il tipo di dati	Attributi XML facoltativi per il tipo di dati
Fisso	SQLBIT, SQLTINYINT, SQLSMALLINT, SQLINT, SQLBIGINT, SQLFLT4, SQLFLT8, SQLDATETIME, SQLDATETIM4, SQLDATETIM8, SQLMONEY, SQLMONEY4, SQLVARIANT e SQLUNIQUEID	Nessuno.	NULLABLE
Numero variabile	SQLDECIMAL e SQLNUMERIC	Nessuno.	NULLABLE, PRECISION, SCALE
LOB	SQLIMAGE, CharLOB, SQLTEXT e SQLUDT	Nessuno.	NULLABLE
Character LOB	SQLNTEXT	Nessuno.	NULLABLE
Stringa binaria	SQLBINARY e SQLVARYBIN	Nessuno.	NULLABLE, LENGTH
Stringa di caratteri	SQLCHAR, SQLVARYCHAR, SQLNCHAR e SQLNVARCHAR	Nessuno.	NULLABLE, LENGTH

Importante

Per eseguire l'esportazione o l'importazione bulk dei dati SQLXML, utilizzare uno dei tipi di dati seguenti nel file di formato: SQLCHAR o SQLVARYCHAR (i dati vengono inviati nella tabella codici del client o nella tabella codici implicita nelle regole di confronto), SQLNCHAR o SQLNVARCHAR (i dati vengono inviati come Unicode) oppure SQLBINARY o SQLVARYBIN (i dati vengono inviati senza conversione).

Per ulteriori informazioni sui tipi di dati di SQL Server, vedere Tipi di dati (Transact-SQL).

Utilizzo dell'elemento &lt;ROW&gt; nell'importazione bulk

L'elemento <ROW> viene ignorato in alcuni contesti. L'elemento <ROW> può influire su un'operazione di importazione bulk a seconda della modalità con cui viene eseguita tale operazione:

• Comando bcp

  Quando i dati vengono caricati in una tabella di destinazione, bcp ignora il componente <ROW> e carica i dati sulla base dei tipi di colonna della tabella di destinazione.

• Istruzioni Transact-SQL (provider di set di righe con lettura bulk BULK INSERT e OPENROWSET)

  Durante l'importazione bulk di dati in una tabella, nelle istruzioni Transact-SQL viene utilizzato il componente <ROW> per generare il set di righe di input. Le istruzioni Transact-SQL eseguono inoltre conversioni appropriate dei tipi sulla base dei tipi di colonna specificati in <ROW> e della colonna corrispondente nella tabella di destinazione. Se i tipi di colonna specificati nel file di formato e quelli della tabella di destinazione non corrispondono, verrà eseguita un'ulteriore conversione dei tipi. Tale ulteriore conversione può comportare alcune discrepanze, ovvero mancanze di precisione, nel comportamento del provider di set di righe con lettura bulk di BULK INSERT o OPENROWSET rispetto a quanto ottenuto con il comando bcp.

  Le informazioni presenti nell'elemento <ROW> consentono di costruire una riga senza richiedere ulteriori informazioni. È quindi possibile generare un set di righe tramite un'istruzione SELECT (SELECT * FROM OPENROWSET(BULK datafile FORMATFILE=xmlformatfile).

  [!NOTA]

  La clausola OPENROWSET BULK comporta la specifica di un file di formato. Si noti che la conversione da un tipo di dati del campo al tipo di dati di una colonna è disponibile solo tramite un file di formato XML.

Utilizzo dell'elemento &lt;COLUMN&gt; nell'importazione bulk

Per consentire l'importazione bulk di dati in una tabella, gli elementi <COLUMN> di un file di formato associano un campo del file di dati alle colonne della tabella specificando:

• La posizione di ogni campo all'interno di una riga del file di dati.

• Il tipo di colonna utilizzata per la conversione del tipo di dati del campo nel tipo di dati della colonna desiderato.

In caso di mancata associazione delle colonne a un campo, quest'ultimo non verrà copiato nella riga o nelle righe generate. Questo comportamento consente a un file di dati di generare righe con diverse colonne e in diverse tabelle.

Analogamente, per consentire l'esportazione bulk di dati da una tabella, ogni <COLUMN> del file di formato associa la colonna della riga della tabella di input al campo corrispondente del file di dati di output.

Inserimento del valore xsi:type in un set di dati

Quando per la convalida di un documento XML si utilizza il linguaggio XML Schema Definition (XSD), il valore xsi:type non viene inserito nel set di dati. Per inserire le informazioni relativi al valore xsi:type nel set di dati, è tuttavia possibile caricare il file di formato XML in un documento XML, ad esempio myDoc, come illustrato nel frammento di codice seguente:

...;
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");
}

Vedere anche

Riferimento

Concetti