Impostazione dei caratteri di terminazione del campo e della riga (SQL Server)

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Analytics Platform System (PDW)

Per i campi dati di tipo carattere è facoltativamente possibile contrassegnare la fine di ogni campo di un file di dati con un carattere di terminazione del campo a e la fine di ogni riga con un carattere di terminazione della riga. I caratteri di terminazione costituiscono un mezzo per indicare ai programmi che leggono il file di dati dove termina un campo o una riga e dove inizia un altro campo o un'altra riga.

Caratteri di terminazione supportati

Il comando bcp , l'istruzione BULK INSERT e il provider bulk per set di righe OPENROWSET supportano una vasta gamma di caratteri di terminazione del campo o della riga e cercano sempre la prima istanza di ogni carattere di terminazione. Nella tabella seguente sono inclusi i caratteri di terminazione supportati.

*Per generare un carattere di controllo, è possibile utilizzare solo i caratteri t, n, r, 0 e '\0' in associazione al carattere di escape barra rovesciata.

**Anche se il carattere di controllo Null (\0) non è visibile quando viene stampato, è un carattere distinto del file di dati. Pertanto, l'utilizzo di un carattere di controllo Null come carattere di terminazione è diverso dall'assenza di qualsiasi carattere di terminazione del campo o della riga.

Utilizzo di caratteri di terminazione della riga

Il carattere di terminazione della riga può essere identico al carattere di terminazione dell'ultimo campo. In genere, tuttavia, è consigliabile utilizzare un carattere di terminazione della riga distinto. Per generare un output in formato tabulare, ad esempio, è possibile terminare l'ultimo campo di ogni riga con il carattere di nuova riga (\n) e tutti gli altri campi con il carattere di tabulazione (\t). Per posizionare ogni record di dati nella riga corrispondente del file di dati, specificare la combinazione \r\n come carattere di terminazione della riga.

Impostazione dei caratteri di terminazione per l'esportazione in massa

Se si esegue l'esportazione bulk di dati char o nchar e si vuole usare un carattere di terminazione non predefinito, è necessario specificare tale carattere nel comando bcp . È possibile specificare i caratteri di terminazione in uno dei modi seguenti:

• Con un file di formato che specifica il carattere di terminazione per ogni singolo campo.

  Nota

  Per informazioni su come usare i file di formato, vedere File di formato per l'importazione o l'esportazione di dati (SQL Server).

• Senza un file di formato, mediante le alternative seguenti:

  • Uso dell'opzione -t per specificare il carattere di terminazione del campo per tutti i campi, ad eccezione dell'ultimo campo della riga, e dell'opzione -r per specificare un carattere di terminazione della riga.

  • Uso di un'opzione per il formato carattere (-c o -w) senza l'opzione -t , che imposta il carattere di terminazione del campo sul carattere di tabulazione, \t. Questa impostazione è equivalente all'uso di -t\t.

    Nota

    Se si specifica l'opzione -n per i dati nativi o l'opzione -N per i dati nativi Unicode, i caratteri di terminazione non vengono inseriti.

  • Se un comando bcp interattivo include l'opzione in o out senza l'opzione per il file di formato (-f) o per un formato dei dati (-n, -c, -wo -N) e si è scelto di non specificare la lunghezza del prefisso e del campo, il comando richiede di specificare il carattere di terminazione di ogni campo. L'impostazione predefinita none non prevede alcun carattere di terminazione:

    Enter field terminator [none]:

    In genere, l'impostazione predefinita rappresenta una scelta appropriata. Tuttavia, per i campi dati char o nchar, vedere la sottosezione seguente, "Linee guida per l'utilizzo dei caratteri di terminazione". Per un esempio contestualizzato di questa richiesta, vedere Impostazione dei formati di dati per la compatibilità mediante bcp (SQL Server).

    Nota

    Dopo l'impostazione interattiva di tutti i campi in un comando bcp, viene richiesto di salvare le risposte relative a ogni campo in un file di formato non XML. Per altre informazioni sui file di formato non XML, vedere File di formato non XML (SQL Server).

Linee guida per l'utilizzo dei caratteri di terminazione

In alcuni casi, un carattere di terminazione può essere utile per un campo dati char o nchar . Ad esempio:

• Per una colonna di dati che contiene un valore null in un file di dati da importare in un programma che non riconosce le informazioni sulla lunghezza del prefisso.

  Qualsiasi colonna di dati che contiene un valore null è considerata a lunghezza variabile. In assenza di lunghezze dei prefissi, un carattere di terminazione è necessario per identificare la fine di un campo null, in modo da garantire la corretta interpretazione dei dati.

• Per una colonna a lunghezza fissa lunga il cui spazio è utilizzato solo parzialmente da molte righe.

  In questa situazione, la definizione di un carattere di terminazione può ridurre lo spazio di archiviazione, facendo sì che il campo venga considerato un campo a lunghezza variabile.

Impostazione di \n come carattere di terminazione di riga per l'esportazione in massa

Quando si specifica \n come carattere di terminazione di riga per l'esportazione bulk o si usa in modo implicito il terminatore di riga predefinito, bcp restituisce una combinazione di ritorno a capo-avanzamento riga (CRLF) come carattere di terminazione di riga. Se si vuole usare solo un carattere di avanzamento riga (LF) come terminazione di riga, come avviene in genere nei computer Unix e Linux, usare la notazione esadecimale per specificare il carattere di terminazione di riga LF. Ad esempio:

bcp -r '0x0A'

Esempi

In questo esempio viene eseguita l'esportazione bulk dei dati dalla tabella AdventureWorks.HumanResources.Department al file di dati Department-c-t.txt usando il formato carattere con la virgola come carattere di terminazione del campo e il carattere di nuova riga (\n) come terminazione di riga.

Per il comando bcp sono disponibili le opzioni seguenti.

Per altre informazioni, vedere bcp Utility.

Al prompt dei comandi di Microsoft Windows immettere:

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

In questo modo viene creato il file di dati Department-c-t.txtcontenente 16 record, ognuno con quattro campi. I campi sono separati da una virgola.

Impostazione dei caratteri di terminazione per l'importazione in blocco

Quando si esegue l'importazione bulk di dati char o nchar , il relativo comando deve riconoscere i caratteri di terminazione usati nel file di dati. L'impostazione dei caratteri di terminazione varia in base al comando per l'importazione bulk, come illustrato di seguito:

• bcp

  Per impostare i caratteri di terminazione per un'operazione di importazione, è possibile utilizzare la stessa sintassi utilizzata per un'operazione di esportazione. Per ulteriori informazioni, vedere "Impostazione dei caratteri di terminazione per l'esportazione bulk", più indietro in questo argomento.

• BULK INSERT

  È possibile specificare i caratteri di terminazione per i singoli campi di un file di formato o per l'intero file di dati utilizzando i qualificatori illustrati nella tabella seguente:

  Qualifier	Descrizione
  FIELDTERMINATOR ='field_terminator'	Specifica il carattere di terminazione del campo da utilizzare per i file di dati di tipo carattere e carattere Unicode. Il valore predefinito è il carattere di tabulazione (\t).
  ROWTERMINATOR ='row_terminator'	Specifica il carattere di terminazione della riga da utilizzare per i file di dati di tipo carattere e carattere Unicode. Il valore predefinito è \n (carattere di nuova riga).

  Per altre informazioni, vedere BULK INSERT (Transact-SQL).

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

  Per il provider di set di righe con lettura bulk OPENROWSET, è possibile specificare i caratteri di terminazione solo nel file di formato, ad eccezione dei tipi di dati contenenti oggetti di grandi dimensioni. Se un file di dati di tipo carattere utilizza un carattere di terminazione non predefinito, è necessario definire tale carattere nel file di formato. Per altre informazioni, vedere Creazione di un file di formato (SQL Server) e Utilizzo di un file di formato per l'importazione bulk dei dati (SQL Server).

  Per altre informazioni sulla clausola OPENROWSET BULK, vedere OPENROWSET (Transact-SQL).

Impostazione di \n come carattere di terminazione di riga per l'importazione in blocco

Quando si specifica \n come carattere di terminazione di riga per l'importazione bulk o si usa in modo implicito il terminatore di riga predefinito, bcp e l'istruzione BULK INSERT si aspettano una combinazione di ritorno a capo-avanzamento riga (CRLF) come carattere di terminazione di riga. Se il file di origine usa solo un carattere di avanzamento riga (LF) come terminazione di riga, come avviene in genere nei file generati in computer Unix e Linux, usare la notazione esadecimale per specificare il carattere di terminazione di riga LF. Ad esempio, in un'istruzione BULK INSERT:

 ROWTERMINATOR = '0x0A'

Esempi

Negli esempi di questa sezione viene eseguita l'importazione bulk di dati di tipo carattere dal file dei dati Department-c-t.txt creato nell'esempio precedente nella tabella myDepartment del database di esempio AdventureWorks2022 . Prima di eseguire le procedure illustrate negli esempi, è necessario creare la tabella. Per crearla in base allo schema dbo, nell'editor di query di SQL Server Management Studio eseguire il codice seguente:

USE AdventureWorks2022;
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

R. Utilizzo del comando bcp per l'impostazione interattiva dei caratteri di terminazione

Nell'esempio seguente viene eseguita l'importazione bulk del file di dati Department-c-t.txt utilizzando un comando bcp . Per questo comando sono disponibili le stesse opzioni del comando di esportazione bulk. Per ulteriori informazioni, vedere "Impostazione dei caratteri di terminazione per l'esportazione bulk", più indietro in questo argomento.

Al prompt dei comandi di Windows digitare:

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

B. Utilizzo dell'istruzione BULK INSERT per l'impostazione interattiva dei caratteri di terminazione

Nell'esempio seguente viene eseguita l'importazione bulk del file di dati Department-c-t.txt utilizzando un'istruzione BULK INSERT con i qualificatori illustrati nella tabella seguente:

Nell'editor di query di SQL Server Management Studio, eseguire il codice seguente:

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

Passaggi successivi

• Utilità bcp
• BULK INSERT (Transact-SQL)
• OPENROWSET (Transact-SQL)
• Specifica della lunghezza di campo tramite bcp (SQL Server)
• Specifica della lunghezza del prefisso nei file di dati tramite bcp (SQL Server)
• Specifica del tipo di archiviazione di file tramite bcp (SQL Server)