Usare il formato carattere per importare o esportare dati (SQL Server)

Articolo
2025-03-05

si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Analytics Platform System (PDW)Warehouse in Microsoft Fabric

È consigliabile adottare il formato carattere per l'esportazione in blocco in un file di testo da utilizzare in un altro programma o per l'importazione in blocco da un file di testo generato da un altro programma.

Il formato carattere utilizza il formato dati di tipo carattere per tutte le colonne. L'archiviazione in formato carattere risulta utile quando i dati vengono utilizzati in altri programmi, ad esempio in un foglio di calcolo, o quando è necessario copiare in un'istanza di SQL Server i dati di database di altri fornitori, ad esempio Oracle.

Nota

Quando si esegue il trasferimento in blocco dei dati tra le istanze di Microsoft SQL Server e il file di dati contiene caratteri Unicode ma nessun carattere esteso o DBCS, usare il formato carattere Unicode. Per altre informazioni, vedere Usare il formato carattere Unicode per importare o esportare dati (SQL Server).

Considerazioni sull'uso del formato carattere

Quando si usa il formato carattere, prendere in considerazione:

Per impostazione predefinita, l'utilità bcp separa i campi di dati di tipo carattere con il carattere di tabulazione e termina i record con il carattere di nuova riga. Per informazioni su come specificare caratteri di terminazione alternativi, vedere Impostazione dei caratteri di terminazione del campo e della riga (SQL Server).

Per impostazione predefinita, prima dell'esportazione o dell'importazione bulk di dati in modalità carattere, vengono eseguite le conversioni seguenti:

Direzione dell'operazione di massa	Conversione
Esportazione	I dati vengono convertiti in rappresentazione dei caratteri. Se richiesto esplicitamente, i dati sono convertiti nella pagina codice richiesta per le colonne carattere. Se non è stata specificata alcuna tabella codici, i dati di tipo carattere vengono convertiti in base alla tabella codici OEM del computer client.
Importazione	Converte i dati di tipo carattere in rappresentazione nativa, se necessario, e converte i dati di tipo carattere dalla tabella codici del client alla tabella codici di una o più colonne di destinazione.

Per impedire eventuali perdite di caratteri estesi durante la conversione, utilizzare il formato di carattere Unicode o specificare una tabella codici.
I dati sql_variant archiviati in un file di formato carattere risultano privi di metadati. Ogni valore viene convertito nel formato char in base alle regole di conversione dei dati implicita. I dati importati in colonne sql_variant risultano di tipo char. I dati importati in colonne con tipo di dati diverso da sql_variantvengono convertiti dal tipo di dati char tramite una conversione implicita. Per altre informazioni sulla conversione dei dati, vedere Conversione dei tipi di dati (motore di database).
L'utilità bcp esporta i valori money in file di dati in formato carattere con quattro cifre dopo il punto decimale e senza simboli di raggruppamento delle cifre, quali i separatori delle migliaia. Ad esempio, una colonna money contenente il valore 1,234,567.123456 viene esportata in blocco in un file di dati come stringa di caratteri 1234567.1235.

Opzioni di comando per il formato carattere

È possibile importare dati in formato carattere in una tabella usando bcp, BULK INSERT (Transact-SQL)o OPENROWSET (Transact-SQL). Per un comando bcp o l'istruzione BULK INSERT (Transact-SQL), è possibile specificare il formato dei dati nell'istruzione. Per un'istruzione OPENROWSET (Transact-SQL), è necessario specificare il formato dei dati in un file di formato.

Il formato carattere è supportato dalle opzioni di comando seguenti:

Comando	Opzione	Descrizione
`bcp`	`-c`	Fa in modo che l'utilità bcp utilizzi dati di tipo carattere.\*
`BULK INSERT`	`DATAFILETYPE ='char'`	Utilizzare il formato carattere durante l'importazione in massa dei dati.
`OPENROWSET`	N/D	Deve usare un file di formato

* Per caricare i dati di tipo carattere (-c) in un formato compatibile con le versioni precedenti dei client SQL Server, usare l'opzione -V. Per altre informazioni, vedere Importare dati in formato nativo e carattere da versioni precedenti di SQL Server.

Nota

In alternativa, è possibile definire la formattazione di ogni singolo campo in un file di formato. Per altre informazioni, vedere File di formato per importare o esportare dati (SQL Server).

Condizioni di test di esempio

Gli esempi in questo articolo sono basati sulla tabella e sul file di formato seguenti.

Tabella di esempio

Lo script seguente crea un database di test, una tabella denominata myChar e popola la tabella con alcuni valori iniziali. Eseguire l'istruzione Transact-SQL seguente in Microsoft SQL Server Management Studio (SSMS):

CREATE DATABASE TestDatabase;
GO

USE TestDatabase;
CREATE TABLE dbo.myChar ( 
   PersonID smallint NOT NULL,
   FirstName varchar(25) NOT NULL,
   LastName varchar(30) NOT NULL,
   BirthDate date,
   AnnualSalary money
   );

-- Populate table
INSERT TestDatabase.dbo.myChar
VALUES 
(1, 'Anthony', 'Grosse', '1980-02-23', 65000.00),
(2, 'Alica', 'Fatnowna', '1963-11-14', 45000.00),
(3, 'Stella', 'Rossenhain', '1992-03-02', 120000.00);

-- Review Data
SELECT * FROM TestDatabase.dbo.myChar;

File di formato non XML di esempio

SQL Server supporta due tipi di file di formato, ovvero non XML e XML. Il formato non XML è il formato originale supportato dalle versioni precedenti di SQL Server. Per altre informazioni, vedere file di formato non XML (SQL Server). Il comando seguente usa l'utilità bcp per generare un file di formato non xml, myChar.fmt, in base allo schema di myChar. Per usare un comando bcp per creare un file di formato, specificare l'argomento FORMAT e usare nul anziché un percorso di file di dati. L'opzione di formattazione richiede anche l'opzione -f. Inoltre, per questo esempio, il qualificatore c viene usato per specificare i dati di caratteri e T viene usato per specificare una connessione attendibile usando la sicurezza integrata.

Al prompt dei comandi immettere il comando seguente:

bcp TestDatabase.dbo.myChar format nul -f D:\BCP\myChar.fmt -T -c 

REM Review file
Notepad D:\BCP\myChar.fmt

Importante

Verificare che il file di formato non XML termini con un ritorno a capo/avanzamento riga. In caso contrario, è possibile che venga visualizzato il messaggio di errore seguente:

SQLState = S1000, NativeError = 0
Error = [Microsoft][ODBC Driver 13 for SQL Server]I/O error while reading BCP format file

Esempi

Negli esempi seguenti vengono usati i file di database e di formato creati in precedenza in questo articolo.

Usare bcp e il formato dei caratteri per esportare i dati

-c interruttore e OUT comando.

Il file di dati creato in questo esempio verrà usato in tutti gli esempi successivi.

Al prompt dei comandi immettere il comando seguente:

bcp TestDatabase.dbo.myChar OUT D:\BCP\myChar.bcp -T -c

REM Review results
NOTEPAD D:\BCP\myChar.bcp

Usare bcp e il formato carattere per importare dati senza un file di formato

Opzione -c e comando IN. Al prompt dei comandi immettere il comando seguente:

REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myChar;"

REM Import data
bcp TestDatabase.dbo.myChar IN D:\BCP\myChar.bcp -T -c

REM Review results
SQLCMD -Q "SELECT * FROM TestDatabase.dbo.myChar;"

Usare bcp e il formato carattere per importare dati con un file di formato non XML

Gli interruttori -c e -f e il comando IN. Al prompt dei comandi immettere il comando seguente:

REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myChar;"

REM Import data
bcp TestDatabase.dbo.myChar IN D:\BCP\myChar.bcp -f D:\BCP\myChar.fmt -T

REM Review results
SQLCMD -Q "SELECT * FROM TestDatabase.dbo.myChar;"

Usare BULK INSERT e il formato carattere senza un file di formato

Argomento DATAFILETYPE. Eseguire l'istruzione Transact-SQL seguente in Microsoft SQL Server Management Studio (SSMS):

TRUNCATE TABLE TestDatabase.dbo.myChar; -- for testing
BULK INSERT TestDatabase.dbo.myChar
    FROM 'D:\BCP\myChar.bcp'
    WITH (
        DATAFILETYPE = 'Char'
        );

-- review results
SELECT * FROM TestDatabase.dbo.myChar;

Usare BULK INSERT e il formato carattere con un file di formato non XML

Questo è un esempio dell'argomento FORMATFILE. Eseguire l'istruzione Transact-SQL seguente in Microsoft SQL Server Management Studio (SSMS):

TRUNCATE TABLE TestDatabase.dbo.myChar; -- for testing
BULK INSERT TestDatabase.dbo.myChar
   FROM 'D:\BCP\myChar.bcp'
   WITH (
        FORMATFILE = 'D:\BCP\myChar.fmt'
        );

-- review results
SELECT * FROM TestDatabase.dbo.myChar;

Usare OPENROWSET e il formato di carattere con un file di formato non XML

Esempio dell'argomento FORMATFILE. Eseguire l'istruzione Transact-SQL seguente in Microsoft SQL Server Management Studio (SSMS):

TRUNCATE TABLE TestDatabase.dbo.myChar;  -- for testing
INSERT INTO TestDatabase.dbo.myChar
    SELECT *
    FROM OPENROWSET (
        BULK 'D:\BCP\myChar.bcp', 
        FORMATFILE = 'D:\BCP\myChar.fmt'  
        ) AS t1;

-- review results
SELECT * FROM TestDatabase.dbo.myChar;

Per utilizzare i formati dati per l'importazione o l'esportazione in blocco:

Condividi tramite