Condividi tramite

strumento bcp

  • Articolo

Si applica a:SQL Serverdatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)database SQL in Microsoft Fabric

L'utilità del programma di copia bulk (bcp) esegue operazioni di copia bulk di dati tra un'istanza di Microsoft SQL Server e un file di dati in un formato specificato dall'utente.

Per utilizzare gli strumenti bcp su Linux, vedere Installare gli strumenti da riga di comando sqlcmd e bcp di SQL Server in Linux. Per informazioni dettagliate sull'uso di bcp con Azure Synapse Analytics, vedere Caricare dati con bcp.

L'utilità bcp può essere usata per importare un numero elevato di nuove righe nelle tabelle di SQL Server o per esportare dati dalle tabelle in file di dati. Ad eccezione del caso in cui venga usata conqueryout l'opzione, l'utilità non richiede alcuna conoscenza di Transact-SQL. Per importare dati in una tabella, è necessario utilizzare un file di formato creato per tale tabella oppure comprendere la struttura della tabella e i tipi di dati validi per le relative colonne.

Nota

Se si esegue il backup dei dati con bcp , creare un file di formato per registrare il formato dei dati. I file di dati dibcpnon includono alcuna informazione sullo schema o sul formato. Di conseguenza, se si elimina una tabella o una vista e non è disponibile un file di formato, può non essere possibile importare i dati.

Per informazioni sulle convenzioni adottate per la sintassi bcp, vedere Convenzioni della sintassi Transact-SQL.

Per bcp in Linux e macOS, vedere Considerazioni per bcp in Linux e macOS.

Scaricare l’ultima versione dell’utilità bcp

Gli strumenti da riga di comando dipendono dalla disponibilità generale, ma vengono rilasciati con il pacchetto di installazione per SQL Server 2019 (15.x) e versioni successive.

Informazioni sulla versione

  • Numero di versione: 15.0.4298.1
  • Numero di build: 15.0.4298.1
  • Data di rilascio: 7 aprile 2023

bcp supporta l'autenticazione Microsoft Entra, tra cui il supporto dell'autenticazione a più fattori (MFA) per il database SQL di Azure, il database SQL in Microsoft Fabric e Azure Synapse Analytics.

Nota

Microsoft Entra ID era precedentemente conosciuto come Azure Active Directory (Azure AD).

Requisiti di sistema

  • Windows 8, Windows 8.1, Windows 10, Windows 11
  • Windows Server 2016, Windows Server 2019, Windows Server 2022

Questo componente richiede la versione più recente di Microsoft Driver ODBC 17 per SQL Server.

Per controllare la versione di bcp, eseguire il comando bcp -v e confermare che sia in uso la versione 15.0.4298.1 o successiva.

Sintassi

bcp [database_name.] schema.{table_name | view_name | "query"}
    {in data_file | out data_file | queryout data_file | format nul}

    [-a packet_size]
    [-b batch_size]
    [-c]
    [-C { ACP | OEM | RAW | code_page } ]
    [-d database_name]
    [-D]
    [-e err_file]
    [-E]
    [-f format_file]
    [-F first_row]
    [-G Microsoft Entra authentication]
    [-h"hint [,...n]"]
    [-i input_file]
    [-k]
    [-K application_intent]
    [-l login_timeout]
    [-L last_row]
    [-m max_errors]
    [-n]
    [-N]
    [-o output_file]
    [-P password]
    [-q]
    [-r row_term]
    [-R]
    [-S [server_name[\instance_name]]]
    [-t field_term]
    [-T]
    [-U login_id]
    [-u]
    [-v]
    [-V (80 | 90 | 100 | 110 | 120 | 130 | 140 | 150 | 160)]
    [-w]
    [-x]
    [-Y[s|m|o]]

Considerazioni e limitazioni

  • L'utilità bcp presenta una limitazione per cui il messaggio di errore visualizza solo 512 byte di caratteri. Vengono visualizzati solo i primi 512 byte del messaggio di errore.

Considerazioni su bcp in Linux e macOS

  • Il terminatore del campo è una tabulazione (\t).

  • Il carattere di terminazione della riga è una nuova riga (\n).

  • La modalità carattere è il formato preferito per i file di formato bcp e i file di dati che non contengono caratteri estesi.

  • Una barra rovesciata (\) in un argomento della riga di comando deve essere racchiusa tra virgolette o preceduta da un carattere di escape. Ad esempio, per specificare una nuova riga come terminatore di riga personalizzato, è necessario usare uno dei meccanismi seguenti:

    • -r\\n
    • -r"\n"
    • -r'\n'

Opzioni della riga di comando

Nella tabella seguente sono elencate le opzioni della riga di comando disponibili in bcp e i sistemi operativi supportati.

Opzione della riga di comando Supportato su Windows Supportato su Linux e macOS
[database_name.]schema. {table_name | view_name | "query"} Sì Sì
{indata_file | outdata_file | queryoutdata_file | formato nul} Sì Sì
-a dimensione_del_pacchetto Sì Sì
-b batch_size Sì Sì
-c Sì Sì
-C { ACP | OEM | RAW | code_page } Sì NO
-d database_name Sì Sì
-D Sì Sì
-e err_file Sì Sì
-E Sì Sì
-f format_file Sì Sì
-F first_row Sì Sì
-G Autenticazione di Microsoft Entra Sì Sì
-h"hint [,... n]" Sì NO
-i input_file Sì NO
-Okay Sì Sì
-K application_intent Sì Sì
-l login_timeout Sì Sì
-L ultima_riga Sì Sì
-m max_errors Sì Sì
-n Sì Sì
-N Sì NO
-o output_file Sì NO
-P password Sì Sì
-q Sì Sì
-r row_term Sì Sì
-R Sì Sì
-S [server_name[\instance_name]] Sì Sì
-t field_term Sì Sì
-T Sì Sì
-U login_id Sì Sì
-u NO Sì
-v Sì Sì
-V (80 | 90 | 100 | 110 | 120 | 130 | 140 | 150 | 160 ) Sì NO
-w Sì Sì
-x Sì NO
-Y[s|m|o] NO Sì

database_name

Nome del database in cui si trova la tabella o la vista specificata. Se tale valore non è specificato, il database è quello predefinito dell'utente.

È inoltre possibile specificare in modo esplicito il nome del database tramite -d.

schema

Nome del proprietario della tabella o della vista. schema è facoltativo se l'utente che esegue l'operazione è il proprietario della tabella o della vista specificata. Se lo schema non è specificato e l'utente che esegue l'operazione non è proprietaria della tabella o della vista specificata, SQL Server restituisce un messaggio di errore e l'operazione viene annullata.

table_name

Nome della tabella di destinazione quando si importano dati in SQL Server (in) e della tabella di origine quando si esportano dati da SQL Server (out).

view_name

Nome della vista di destinazione quando si copiano dati in SQL Server (in) e della vista di origine quando si copiano dati da SQL Server (out). È possibile utilizzare come viste di destinazione solo quelle in cui tutte le colonne fanno riferimento alla stessa tabella. Per altre informazioni sulle restrizioni per la copia di dati nelle viste, vedere INSERT.

"query"

Una query Transact-SQL che restituisce un set di risultati. Se la query restituisce più set di risultati, nel file di dati viene copiato solo il primo set, mentre quelli successivi vengono ignorati. Utilizzare le virgolette doppie per racchiudere la query e le virgolette singole per qualsiasi testo incorporato nella query. queryout deve essere specificata anche in caso di copia massiva dei dati da una query.

La query può fare riferimento a una stored procedure a condizione che tutte le tabelle cui viene fatto riferimento nella stored procedure siano disponibili prima dell'esecuzione dell'istruzione bcp. Se, ad esempio, la stored procedure genera una tabella temporanea, l'istruzione bcp ha esito negativo poiché la tabella è disponibile solo in fase di esecuzione e non nel momento in cui viene eseguita l'istruzione. In questo caso, è opportuno inserire i risultati della stored procedure in una tabella e usare bcp per copiare i dati dalla tabella in un file di dati.

in

Esegue la copia da un file nella tabella o nella vista del database. Specifica la direzione della copia in blocco.

fuori

Esegue la copia dalla tabella o dalla vista del database in un file. Specifica la direzione della copia di massa.

Se si specifica un file esistente, il file viene sovrascritto. Quando l'utilità bcp estrae i dati, rappresenta una stringa vuota come null e una stringa Null come stringa vuota.

data_file

Percorso completo del file di dati. Quando si esegue un'importazione bulk dei dati in SQL Server, il file di dati include i dati da copiare nella tabella o nella vista specificata. Quando si esegue un'esportazione bulk dei dati da SQL Server, il file di dati include i dati copiati dalla tabella o dalla vista. Il percorso può essere costituito da un numero di caratteri compreso tra 1 e 255. Il file di dati può contenere un massimo di 2^63 - 1 righe.

queryout

Esegue la copia da una query e deve essere specificata solo in caso di copia bulk dei dati da una query.

format

Crea un file di formato basato sull'opzione specificata (-n, -c, -w o -N) e sui delimitatori della tabella o della vista. Durante la copia bulk dei dati, il comando bcp può fare riferimento a un file di formato e si può quindi evitare di immettere nuovamente le informazioni sul formato in modo interattivo. L'opzione format richiede l'opzione -f. Se si crea un file di formato XML, è necessaria anche l'opzione -x. Per altre informazioni, vedere Creare un file di formato (SQL Server). È necessario specificare nul come valore (format nul).

-a packet_size

Specifica il numero di byte inviati al e dal server per ogni pacchetto di rete. È possibile impostare un'opzione di configurazione del server tramite SQL Server Management Studio (o mediante la stored procedure di sistema sp_configure). Tuttavia, l'opzione di configurazione del server può essere scavalcata su base individuale utilizzando questa opzione. Il valore packet_size può essere compreso tra 4.096 byte e 65.535 byte. Il valore predefinito è 4096.

Le prestazioni delle operazioni di copia bulk migliorano con l'aumentare delle dimensioni del pacchetto. Se è richiesta una dimensione del pacchetto che non può essere concessa, viene utilizzato il valore predefinito. Le statistiche sulle prestazioni generate dall'utilità bcp indicano le dimensioni del pacchetto in uso.

-b batch_size

Specifica il numero di righe per ogni batch di dati importati. Ogni batch viene importato e registrato come transazione distinta che importa l'intero batch prima del commit. Per impostazione predefinita, tutte le righe incluse nel file di dati vengono importate come un unico batch. Per distribuire le righe tra più batch, specificare un valore di batch_size inferiore al numero di righe presenti nel file di dati. Se la transazione per un batch non viene completata correttamente, viene eseguito il rollback solo degli inserimenti dal batch corrente. I batch importati in precedenza dalle transazioni di cui è stato eseguito il commit non sono influenzati da un errore successivo.

Non usare questa opzione con l'opzione -h "ROWS_PER_BATCH=<bb>".

-c

Esegue l'operazione utilizzando un tipo di dati di tipo carattere. Questa opzione non visualizza una richiesta per ogni campo, ma usa char come tipo di archiviazione, senza prefissi e con il carattere di tabulazione \t come separatore di campo e il carattere di nuova riga (\r\n) come carattere di terminazione della riga. -c non è compatibile con -w.

Per altre informazioni, vedere Usare il formato carattere per importare o esportare dati (SQL Server).

-C { ACP | OEM | RAW | code_page }

Si applica a: Solo Windows. Non supportato in Linux e macOS.

Specifica la pagina di codice dei dati nel file di dati. code_page è pertinente solo se i dati contengono colonne di tipo char, varcharo text con valori di carattere maggiori di 127 o minori di 32.

È necessario specificare un nome delle regole di confronto per ogni colonna in un file di formato, tranne quando si desidera che l'opzione 65001 abbia la priorità rispetto alla specifica delle regole di confronto/tabella codici.

Valore pagina di codice Descrizione
ACP ANSI/Microsoft Windows (ISO 1252).
OEM Tabella codici predefinita utilizzata dal client. Si tratta della tabella codici predefinita usata se non si specifica -C.
RAW Non vengono eseguite conversioni tra tabelle codici. Questa è l'opzione più veloce perché non avviene alcuna conversione.
<code_page> Numero di tabella codici specifico, ad esempio 850.

Le versioni precedenti alla versione 13 (SQL Server 2016 (13.x)) non supportano la tabella codici 65001 (codifica UTF-8). Le versioni a partire dalla 13 possono importare la codifica UTF-8 per le versioni precedenti di SQL Server.

-d database_name

Specifica il database al quale connettersi. Per impostazione predefinita, bcp si connette al database predefinito dell'utente. Se si specificano -d <database_name> e un nome in tre parti (database_name.schema.table, passato come primo parametro a bcp), si verificherà un errore poiché non è possibile specificare due volte il nome del database. Se database_name inizia con un segno meno (-) o una barra (/), non aggiungere uno spazio tra -d e il nome del database.

-D

Indica che il valore passato all'opzione bcp -S deve essere interpretato come nome dell'origine dati (DSN).

È possibile usare un DSN per:

  • opzioni driver integrate per semplificare le righe comando
  • applicare le opzioni del driver che non sono altrimenti accessibili dalla riga di comando, ad esempio MultiSubnetFailover,
  • o per proteggere le credenziali sensibili dall'essere individuabili come argomenti della riga di comando.

Per maggiori informazioni, vedere il supporto DSN in sqlcmd e bcp.

-e err_file

Specifica il percorso completo di un file di errori usato per archiviare le eventuali righe che l'utilità bcp non è in grado di trasferire dal file al database. I messaggi di errore generati dal comando bcp vengono inviati alla workstation dell'utente. Se questa opzione non viene utilizzata, non viene creato alcun file degli errore.

Se err_file inizia con un segno meno (-) o una barra (/), non includere uno spazio tra -e e il valore err_file.

-E

Specifica che i valori di identità presenti nel file di dati importato devono essere utilizzati per la colonna di identità. Se si omette -E, i valori Identity della colonna nel file di dati da importare vengono ignorati e SQL Server assegna automaticamente valori univoci in base ai valori di inizializzazione e incremento specificati durante la creazione della tabella. Per altre informazioni, vedere DBCC CHECKIDENT.

Se il file di dati non contiene valori per la colonna Identity nella tabella o nella vista, usare un file di formato per specificare che la colonna Identity nella tabella o nella vista deve essere ignorata durante l'importazione dei dati. SQL Server assegna automaticamente valori univoci per la colonna.

L'opzione -E è caratterizzata da requisiti di autorizzazione di accesso speciali. Per altre informazioni, vedere la sezione "Osservazioni" di seguito in questo articolo.

-f format_file

Specifica il percorso completo di un file di formato. Il significato di questa opzione dipende dall'ambiente in cui viene utilizzata, come descritto di seguito:

  • Se -f viene usata con l'opzione format, per la tabella o per la vista indicata verrà creato il format_file specificato. Per creare un file di formato XML, è necessario specificare anche l'opzione -x. Per altre informazioni, vedere Creare un file di formato (SQL Server).

  • Se si usa con l'opzione in oout, -f richiede un file di formato esistente.

    Nota

    L'uso di un file di formato con l'opzione in o out è facoltativo. Se l'opzione -f viene omessa e non si specifica -n, -c, -w o -N, il comando richiede l'immissione di informazioni sul formato e consente di salvare le risposte in un file di formato, il cui nome predefinito è bcp.fmt.

Se format_file inizia con un segno meno (-) o una barra (/), non includere uno spazio tra -f e il valore format_file.

-F prima_riga

Specifica il numero della prima riga da esportare da una tabella o da importare da un file di dati. Per questo parametro è necessario impostare un valore maggiore di (>) 0, ma minore di (<) o uguale (=) al numero totale di righe. Se il parametro viene omesso, l'impostazione predefinita è la prima riga del file.

first_row può essere un numero intero positivo con valore massimo pari a 2^63-1. -F first_row è basato su 1.

-G

Si applica solo a: database SQL di Azure, database SQL in Microsoft Fabric e Azure Synapse Analytics.

Questa opzione viene utilizzata dal client per specificare che l'utente è autenticato con Microsoft Entra ID. L'opzione -G richiede la versione 14.0.3008.27 o successiva. Per determinare la versione, eseguire bcp -v. Per altre informazioni, vedere Usare l'autenticazione di Microsoft Entra con database SQL o Azure Synapse Analytics o l'autenticazione al database SQL in Fabric.

Importante

In Linux e macOS l'autenticazione interattiva di Microsoft Entra non è attualmente supportata. Per l'autenticazione interattiva di Microsoft Entra è necessario Microsoft ODBC Driver 17 per SQL Server versione 17.6.1 e versioni successive, e un ambiente Kerberos configurato correttamente.

Per verificare se la versione di bcp include il supporto per l'autenticazione di Microsoft Entra, digitare bcp --help e verificare che -G venga visualizzato nell'elenco degli argomenti disponibili.

  • Nome utente e password di Microsoft Entra

    Quando si vuole usare nome utente e password di Microsoft Enrea è possibile fornire l'opzione -G e anche usare nome utente e password fornendo le opzioni -U and -P.

    L'esempio seguente esporta i dati utilizzando le credenziali del nome utente e della password di Microsoft Entra. L'esempio esporta la tabella bcptest del database testdb dal server di Azure aadserver.database.windows.net e archivia i dati nel file c:\last\data1.dat:

    bcp bcptest out "c:\last\data1.dat" -c -S aadserver.database.windows.net -d testdb -G -U alice@aadtest.onmicrosoft.com -P xxxxx

    Nell'esempio seguente vengono importati i dati utilizzando le credenziali di un utente di Microsoft Entra. L'esempio importa i dati dal file c:\last\data1.dat nella tabella bcptest per il database testdb sul server di Azure aadserver.database.windows.net utilizzando il nome utente e la password di Microsoft Entra:

    bcp bcptest in "c:\last\data1.dat" -c -S aadserver.database.windows.net -d testdb -G -U alice@aadtest.onmicrosoft.com -P xxxxx

  • Integrato in Microsoft Entra

    Per l'autenticazione integrata di Microsoft Entra fornire l'opzione -G senza nome utente o password. Questa configurazione richiede che l'account utente di Windows corrente, ovvero l'account con cui viene eseguito il comando bcp, sia federato con Microsoft Entra ID:

    L'esempio seguente esporta i dati utilizzando l'autenticazione integrata di Microsoft Entra. L'esempio esporta la tabella bcptest dal database testdb nel server logico aadserver.database.windows.net e archivia i dati nel file c:\last\data2.dat, utilizzando le credenziali di Windows federate con Microsoft Entra ID:

    bcp bcptest out "c:\last\data2.dat" -S aadserver.database.windows.net -d testdb -G -c

    L'esempio seguente importa i dati utilizzando l'autenticazione integrata di Microsoft Entra. L'esempio importa i dati dalla tabella di file c:\last\data2.dat nella tabella bcptest nel database testdb sul server logico aadserver.database.windows.net, utilizzando le credenziali di Windows federate con Microsoft Entra ID:

    bcp bcptest in "c:\last\data2.dat" -S aadserver.database.windows.net -d testdb -G -c

  • Identità del servizio gestita Microsoft Entra

    Importante

    bcp è strettamente associato al driver. Le versioni principali di bcp e del driver con cui viene creato un DSN devono essere uguali. Per determinare la versione, eseguire bcp -v.

    L'esportazione di dati tramite bcp usando un'identità del servizio gestita in Windows richiede la configurazione di un DSN.

    Per configurare un DSN in un computer che esegue Windows:

    1. Premere il tasto Windows sulla testiera

    2. Digitare ODBC e selezionare la versione appropriata dell'amministratore dell'origine dati ODBC

    3. Selezionare la scheda DSN utente o la scheda DSN di sistema

    4. Selezionare Aggiungi e seguire le istruzioni

    5. Quando viene richiesto un tipo di autenticazione, selezionare Autenticazione dell'identità del servizio gestita di Azure

    6. Se si dispone di un'identità gestita assegnata dall'utente, incollare il Object (principal) ID dell'identità nella casella ID di login nella parte inferiore della scheda di autenticazione.

    7. Per configurare il DSN, continuare seguendo le istruzioni.

    Per una procedura dettagliata completa, inclusa di screenshot, vedere Creazione e modifica di DSN nell'interfaccia utente.

    Dopo aver configurato il DSN, bcp può quindi essere chiamato usando il flag -D per indicare che il valore passato per -S è un DSN.

    bcp bcptest out "c:\last\data1.dat" -c -D -S myDSN -d testdb

  • Token di accesso di Microsoft Entra ID

    Si applica a: Solo Linux e macOS. Windows non è supportato.

    Gli utenti di bcp 17.8 e versioni successive, in Linux e macOS, possono anche eseguire l'autenticazione con un token. Gli esempi seguenti usano PowerShell in Linux per recuperare un token di accesso.

    In questo esempio viene recuperato un token di accesso che viene inserito in un file per esportare i dati usando un'identità gestita assegnata dal sistema.

    Connect-AzAccount -Identity
$access_token | cut -f 1 | tr -d '\n' | iconv -f ascii -t UTF-16LE > /tmp/tokenFile
bcp bcptest out data2.dat -S aadserver.database.windows.net -d testdb -G -P /tmp/tokenFile -c

    In questo esempio viene passato un oggetto Client ID al parametro -AccountId di Connect-AzAccount per recuperare un token di accesso e inserirlo in un file token. Il token viene quindi usato per esportare i dati usando l'identità gestita assegnata dall'utente specificata.

    Connect-AzAccount -Identity -AccountId 'client_id_of_user_assigned_managed_identity'
$access_token | cut -f 1 | tr -d '\n' | iconv -f ascii -t UTF-16LE > /tmp/tokenFile
bcp bcptest out data2.dat -S aadserver.database.windows.net -d testdb -G -P /tmp/tokenFile -c

  • Microsoft Entra interactive

    Si applica a: Solo Windows. Linux e macOS non sono supportati.

    L'autenticazione interattiva Di Microsoft Entra, disponibile per tutti i componenti SQL di Azure e SQL Server 2022 (16.x) e versioni successive, consente di usare una finestra di dialogo interattiva per l'autenticazione, che supporta anche l'autenticazione a più fattori.

    L'autenticazione interattiva di Microsoft Entra richiede bcpversione 15.0.1000.34 o successiva e ODBC versione 17.2 o successiva.

    Per abilitare l'autenticazione interattiva, fornire l'opzione -G solo con il nome utente (-U) e senza una password.

    L'esempio seguente esporta i dati utilizzando l'autenticazione interattiva di Microsoft Entra, che include la specifica del nome utente di un account Microsoft Entra.

    Per la modalità interattiva è necessario immettere manualmente una password o, per gli account con l'autenticazione a più fattori abilitata, completare il metodo di autenticazione a più fattori configurato.

    bcp bcptest out "c:\last\data1.dat" -c -S aadserver.database.windows.net -d testdb -G -U alice@aadtest.onmicrosoft.com

    Se si utilizza un utente di Microsoft Entra che è un account di Windows da un dominio federato, il nome utente immesso nella riga di comando deve contenere il dominio , ad esempio joe@contoso.com:

    bcp bcptest out "c:\last\data1.dat" -c -S aadserver.database.windows.net -d testdb -G -U joe@contoso.com

    Se gli utenti guest esistono in un tenant specifico di Microsoft Entra e fanno parte di un gruppo esistente nel database SQL di Azure con autorizzazioni di database per eseguire il comando bcp , viene usato il relativo alias utente guest (ad esempio, keith0@adventure-works.com).

-h "suggerimenti [, ... n]"

Si applica a: Solo Windows. Non supportato in Linux e macOS.

Specifica i suggerimenti da utilizzare per l'importazione massiva di dati in una tabella o in una vista.

  • ORDER(column [ASC | DESC] [, ...n])

    Tipo di ordinamento dei dati nel file di dati. Le prestazioni dell'importazione bulk sono migliori se i dati da importare vengono ordinati in base all'indice cluster della tabella, se disponibile. Se il file di dati viene ordinato in un ordine diverso, ovvero diverso dall'ordine di una chiave di indice cluster o se non è presente alcun indice cluster nella tabella, la ORDER clausola viene ignorata. I nomi di colonna specificati devono corrispondere a nomi di colonna validi nella tabella di destinazione. Per impostazione predefinita, bcp presuppone che il file di dati non sia ordinato. Per garantire l'ottimizzazione dell'importazione bulk, SQL Server verifica inoltre che i dati importati siano ordinati.

  • ROWS_PER_BATCH = bb

    Numero di righe di dati per batch (come bb). Viene usato quando non si specifica -b e quindi l'intero file di dati viene inviato al server come singola transazione. Il server ottimizza il caricamento massivo in base al valore bb. Per impostazione predefinita, ROWS_PER_BATCH è sconosciuto.

  • KILOBYTES_PER_BATCH= cc

    Numero approssimativo di kilobyte di dati per batch (come cc). Per impostazione predefinita, KILOBYTES_PER_BATCH è sconosciuto.

  • TABLOCK

    Specifica che un blocco a livello di tabella di aggiornamento bulk viene acquisito durante l'operazione di bulkload; in caso contrario, viene acquisito un blocco a livello di riga. Questo hint migliora significativamente le prestazioni perché mantenere un lock durante l'operazione di copia in blocco riduce la contenzione del blocco nella tabella. Una tabella può essere caricata simultaneamente da più client se la tabella non contiene indici e TABLOCK viene specificata. Per impostazione predefinita, il comportamento di blocco è determinato dall'opzione table lock on bulkloadtable . Per altre informazioni, vedere sp_tableoption.

    Nota

    Se la tabella di destinazione è un indice columnstore cluster, TABLOCK l'hint non è necessario per il caricamento da più client simultanei perché a ogni thread simultaneo viene assegnato un rowgroup separato all'interno dell'indice e ne carica i dati. Per ulteriori dettagli, consultare Indici columnstore: Panoramica.

  • VINCOLI_DI_VERIFICA

    Specifica che tutti i vincoli sulla tabella o sulla vista di destinazione devono essere verificati durante l'operazione di importazione massiva. Senza l'hint CHECK_CONSTRAINTS, gli eventuali CHECK, e FOREIGN KEY vincoli vengono ignorati e, dopo l'operazione, il vincolo nella tabella viene segnato come non attendibile.

    Nota

    UNIQUEI vincoli , PRIMARY KEYe NOT NULL vengono sempre applicati.

    A un certo punto è necessario controllare i vincoli sull'intera tabella. Se la tabella non era vuota prima dell'operazione di importazione di massa, il costo della riconvalida del vincolo può superare il costo di applicare i vincoli CHECK ai dati incrementali. È pertanto consigliabile abilitare in genere il controllo dei vincoli durante un'importazione bulk incrementale.

    Una situazione in cui può essere necessario disabilitare i vincoli (comportamento predefinito) è rappresentata dal caso in cui i dati di input contengono righe che violano i vincoli. Con CHECK i vincoli disabilitati, è possibile importare i dati e quindi usare istruzioni Transact-SQL per rimuovere i dati non validi.

    L'utilitàbcp ora esegue la convalida e i controlli dei dati che possono causare la mancata esecuzione degli script quando questi vengono eseguiti su dati non validi inclusi in un file di dati.

    Nota

    L'opzione -mmax_errors non è valida per il controllo dei vincoli.

  • Attivatori di Incendio

    Quando si specifica questa opzione con l'argomento in , tutti i trigger di inserimento definiti nella tabella di destinazione vengono eseguiti durante l'operazione di copia bulk. Se FIRE_TRIGGERS non viene specificato, non vengono eseguiti trigger di inserimento. FIRE_TRIGGERS viene ignorato per gli outargomenti , queryoute format .

-i input_file

Si applica a: solo Windows. Non supportato in Linux e macOS.

Specifica il nome di un file di risposta contenente le risposte alle domande del prompt dei comandi per ogni campo dati quando si esegue una copia bulk in modalità interattiva, ovvero senza specificare -n, -c, -w, o -N.

Se input_file inizia con un trattino (-) o una barra (/), non includere uno spazio tra -i e il valore di input_file.

-k

Specifica che durante l'operazione il valore delle colonne vuote deve essere Null, ovvero che non verranno inseriti valori predefiniti in tali colonne. Per altre informazioni, vedere Mantenere i valori Null o i valori predefiniti durante l'importazione in blocco (SQL Server).

-K intento_applicazione

Dichiara il tipo di carico di lavoro dell'applicazione in caso di connessione a un server. L'unico valore consentito è ReadOnly. Se -K non è specificata, l’utilitàbcp non supporta la connettività a una replica secondaria in un gruppo di disponibilità Always On. Per ulteriori informazioni, vedere Distribuire il carico di lavoro in sola lettura a una replica secondaria di un gruppo di disponibilità Always On.

-l login_timeout

Specifica un timeout di accesso. L'opzione -l specifica il numero di secondi che devono trascorrere prima che si verifichi il timeout di un accesso a SQL Server quando si cerca di stabilire la connessione a un server. Il timeout di accesso predefinito è di 15 secondi. Il valore del timeout di login deve essere un numero compreso tra 0 e 65534. Se il valore specificato non è numerico o non è compreso in tale intervallo, bcp genera un messaggio di errore. Il valore 0 specifica un timeout infinito.

-L ultima_riga

Specifica il numero dell'ultima riga da esportare da una tabella o da importare da un file di dati. Per questo parametro è necessario specificare un valore maggiore di (>) 0, ma minore di (<) o uguale (=) al numero dell'ultima riga. Se il parametro viene omesso, l'impostazione predefinita è l'ultima riga del file.

last_row può essere un numero intero positivo con valore massimo pari a 2^63-1.

-m max_errors

Specifica il numero massimo di errori di sintassi che possono verificarsi prima dell'annullamento dell'operazione bcp . Un errore di sintassi implica un errore di conversione dei dati nel tipo di dati di destinazione. Nel valore totale restituito da max_errors sono esclusi tutti gli errori che possono essere rilevati solo a livello del server, ad esempio le violazioni dei vincoli.

Una riga che non può essere copiata dall'utilità bcp viene ignorata e conteggiata come errore. Se l'opzione viene omessa, il valore predefinito è 10.

Nota

L'opzione -m non è valida per la conversione dei tipi di dati money o bigin.

-n

Esegue l'operazione di copia bulk utilizzando i tipi di dati nativi del database. Con questa opzione non viene visualizzata una richiesta per ogni campo, ma vengono utilizzati i valori nativi.

Per altre informazioni, vedere Usare il formato nativo per importare o esportare dati (SQL Server).

-N

Si applica a: Solo Windows. Non supportato in Linux e macOS.

Esegue l'operazione di copia bulk utilizzando i tipi di dati nativi del database per i dati non di tipo carattere e i caratteri Unicode per i dati di tipo carattere. Questa opzione rappresenta un'alternativa, con migliori prestazioni, all'opzione -w e può essere usata per trasferire dati tra istanze di SQL Server con un file di dati. Non viene visualizzato un prompt per ogni campo. Utilizzare questa opzione per trasferire dati contenenti caratteri ANSI estesi se si desidera sfruttare le prestazioni della modalità nativa.

Per altre informazioni, vedere Usare il formato Unicode nativo per importare o esportare dati (SQL Server).

Se si esportano e successivamente si importano i dati nello stesso schema di tabella usando bcp con -N, può essere visualizzato un avviso di troncamento se è presente una colonna contenente caratteri non Unicode a lunghezza fissa, ad esempio char(10).

L'avviso può essere ignorato. Per evitare la visualizzazione dell'avviso, usare -n invece di -N.

-o output_file

Si applica a: Solo Windows. Non supportato in Linux e macOS.

Specifica il nome di un file in cui viene reindirizzato l'output dal prompt dei comandi.

Se output_file inizia con un segno meno (-) o una barra diagonale (/), non includere uno spazio tra -o e il valore output_file.

-P password

Specifica la password per l'ID di accesso . Se questa opzione non viene usata, il comando bcp richiede una password. Se questa opzione viene usata alla fine del prompt dei comandi senza password, bcp usa la password predefinita (NULL).

Importante

Non usare una password vuota. Usare una password complessa.

Per nascondere la password, non specificare l'opzione -P in combinazione con l'opzione -U. Al contrario, dopo aver specificato bcp insieme all'opzione -U e ad altre opzioni (non specificare -P), premere INVIO e il comando richiederà una password. Questo metodo garantisce che la password venga nascosta durante l'immissione.

Se la password inizia con un segno meno (-) o una barra (/), non aggiungere uno spazio tra -P e il valore password.

-q

Esegue l'istruzione SET QUOTED_IDENTIFIER ON nella connessione tra l'utilità bcp e un'istanza di SQL Server. Questa opzione consente di specificare il nome di un database, di un proprietario, di una tabella o di una vista che include uno spazio o una virgoletta singola. Racchiudere l'intero nome di tabella o vista in tre parti tra virgolette ("").

Per specificare un nome di database contenente uno spazio o una virgoletta singola, utilizzare l'opzione -q.

-q non è applicabile ai valori passati a -d.

Per altre informazioni, vedere la sezione Osservazioni in questo articolo.

-r row_term

Specifica il terminatore di riga. Il valore predefinito è \n (carattere di nuova riga). Utilizzare questo parametro per specificare un carattere di terminazione della riga diverso da quello predefinito. Per altre informazioni, vedere Impostazione dei caratteri di terminazione del campo e della riga (SQL Server).

Se si specifica il carattere di terminazione della riga in notazione esadecimale nel comando bcp, il valore verrà troncato in corrispondenza di 0x00. Ad esempio, se si specifica 0x410041 viene usato 0x41.

Se row_term inizia con un trattino (-) o una barra (/), non includere uno spazio tra -r e il valore row_term.

-R

Specifica che la copia bulk dei dati relativi a valuta, data e ora verrà eseguita in SQL Server usando il formato definito per le impostazioni locali del computer client. Per impostazione predefinita, le impostazioni internazionali vengono ignorate.

-S [server_name[\instance_name]]

Specifica il nome dell'istanza di SQL Server a cui connettersi o se -D viene usato un DSN.

Se non si specifica alcun server, l'utilità bcp si connette all'istanza predefinita di SQL Server del computer locale. È necessario specificare questa opzione se un comando bcp viene eseguito da un computer remoto in rete o in un'istanza denominata locale. Per connettersi all'istanza predefinita di SQL Server in un server, specificare solo server_name. Per connettersi a un'istanza denominata di SQL Server, specificare server_name**\**instance_name.

-t field_term

Specifica il carattere di terminazione del campo. Il valore predefinito è \t (carattere di tabulazione). Utilizzare questo parametro per specificare un carattere di terminazione del campo diverso da quello predefinito. Per altre informazioni, vedere Impostazione dei caratteri di terminazione del campo e della riga (SQL Server).

Se si specifica il carattere di terminazione del campo in notazione esadecimale nel comando bcp, il valore verrà troncato in corrispondenza di 0x00. Ad esempio, se si specifica 0x410041 viene usato 0x41.

Se field_term inizia con un segno meno (-) o una barra (/), non inserire uno spazio tra -t e il valore field_term.

-T

Specifica che l'utilità bcp si connette a SQL Server con una connessione trusted che usa la sicurezza integrata. Non è necessario specificare le credenziali di sicurezza dell'utente di rete, ovvero login_ide password. Se non si specifica -T, è necessario specificare -U e -P per connettersi.

Importante

Quando l'utilità bcp si connette a SQL Server con una connessione trusted con sicureza integrata, usare l'opzione -T option (connessione trusted) anziché la combinazione nome utente e password. Quando l'utilità bcp si connette al database SQL o ad Azure Synapse Analytics, non è supportato l'uso dell'autenticazione di Windows o dell'autenticazione di Microsoft Entra. Utilizzare le opzioni -U e -P.

-U login_id

Specifica l'ID di accesso usato per connettersi a SQL Server.

-u

Si applica a: Solo Linux e macOS, per bcp versione 18 e versioni successive. Non supportato in Windows.

Considera attendibile il certificato del server.

-v

Visualizza il numero di versione e le informazioni sul copyright per l'utilità bcp .

-V { 80 | 90 | 100 | 110 | 120 | 130 | 140 | 150 | 160 }

Si applica a: Solo Windows. Non supportato in Linux e macOS.

Esegue l'operazione di copia bulk utilizzando i tipi di dati di una versione precedente di SQL Server. Con questa opzione non viene visualizzata una richiesta per ogni campo, ma vengono utilizzati i valori predefiniti.

  • 80 = SQL Server 2000 (8.x)
  • 90 = SQL Server 2005 (9.x)
  • 100 = SQL Server 2008 (10.0.x) e SQL Server 2008 R2 (10.50.x)
  • 110 = SQL Server 2012 (11.x)
  • 120 = SQL Server 2014 (12.x)
  • 130 = SQL Server 2016 (13.x)
  • 140 = SQL Server 2017 (14.x)
  • 150 = SQL Server 2019 (15.x)
  • 160 = SQL Server 2022 (16.x)

Per generare, ad esempio, dati per tipi non supportati da SQL Server 2000 (8.x), ma introdotti in versioni successive di SQL Server, usare l'opzione -V80.

Per altre informazioni, vedere Importare dati in formato nativo e carattere da versioni precedenti di SQL Server.

-w

Esegue l'operazione di copia bulk utilizzando caratteri Unicode. Questa opzione non richiede ogni campo; usa nchar come tipo di archiviazione, nessun prefisso, \t (carattere di tabulazione) come separatore di campo e \n (carattere di nuova riga) come carattere di terminazione della riga. -w non è compatibile con -c.

Per altre informazioni, vedere Usare il formato carattere Unicode per importare o esportare dati (SQL Server).

-x

Si applica a: Solo Windows. Non supportato in Linux e macOS.

Questa opzione viene utilizzata con le opzioni format e -fformat_file e genera un file di formato basato su XML anziché un file di formato predefinito non XML. L'opzione -x non può essere usata per l'importazione o l'esportazione dei dati. Genera un errore se viene usata senza format e -fformat_file.

-Y[s|m|o]

Si applica a: Solo Linux e macOS, per bcp versione 18 e versioni successive. Non supportato in Windows.

Specifica la modalità di crittografia della connessione. Le opzioni sono Rigido, Obbligatorio e Facoltativo. L'uso di -Y senza parametri usa la modalità di crittografia obbligatoria ed è equivalente a -Ym.

Osservazioni:

  • Il client bcp 13.0 viene installato quando si installano gli strumenti di Microsoft SQL Server 2019 (15.x). Se gli strumenti vengono installati per più versioni di SQL Server, a seconda dell'ordine dei valori della PATH variabile di ambiente, è possibile usare il client bcp precedente anziché il client bcp 13.0. La variabile di ambiente definisce il set di directory utilizzato in Windows per la ricerca di file eseguibili. Per determinare la versione in uso, eseguire il comando bcp -val prompt dei comandi di Windows. Per informazioni su come impostare il percorso di PATH comando nella variabile di ambiente, vedere Variabili di ambiente o cercare variabili di ambiente nella Guida di Windows.

    Per assicurarsi che sia in esecuzione la versione più recente dell'utilità bcp, è necessario rimuovere le versioni precedenti dell'utilità bcp.

    Per determinare la posizione di installazione di tutte le versioni dell'utilità bcp, digitare nel prompt dei comandi:

    where bcp.exe

  • L'utilità bcp può anche essere scaricata separatamente dal Microsoft SQL Server 2016 Feature Pack. Selezionare ENU\x64\MsSqlCmdLnUtils.msi o ENU\x86\MsSqlCmdLnUtils.msi.

  • I file di formato XML sono supportati solo quando gli strumenti di SQL Server vengono installati insieme a SQL Server Native Client.

  • Per informazioni sulla posizione e sulle modalità di esecuzione dell'utilità bcp e sulle convenzioni di sintassi per le utilità della riga di comando, vedere Utilità del prompt dei comandi SQL (motore di database).

  • Per informazioni sulla preparazione dei dati per le operazioni di importazione o esportazione in blocco, vedere Preparare i dati per l'importazione o l'esportazione bulk.

  • Per informazioni sui casi in cui le operazioni di inserimento di righe eseguite durante l'importazione in blocco vengono registrate nel log delle transazioni, vedere Prerequisiti per la registrazione minima nell'importazione in blocco.

  • Uso di caratteri speciali aggiuntivi

    I caratteri <, >, |, & e ^ sono caratteri speciali della shell dei comandi e devono essere preceduti dal carattere di escape (^) o racchiusi tra virgolette quando usate in una stringa (ad esempio,"StringContaining&Symbol"). Se si utilizzano le virgolette per racchiudere una stringa che contiene uno dei caratteri speciali, le virgolette sono impostate come parte del valore della variabile di ambiente.

Supporto per file di dati nativi

In SQL Server l'utilità bcp supporta file di dati nativi compatibili con le versioni di SQL Server a partire da SQL Server 2000 (8.x) e versioni successive.

Colonne calcolate e colonne di timestamp

I valori per le colonne calcolate o timestamp nel file di dati importato vengono ignorati e SQL Server assegna automaticamente nuovi valori. Se il file di dati non contiene valori per le colonne calcolate o timestamp della tabella, usare un file di formato per specificare che le colonne calcolate o timestamp della tabella dovranno essere ignorate durante l'importazione dei dati. I valori per la colonna verranno assegnati automaticamente da SQL Server.

Le colonne calcolate e timestamp sono copiate in massa da SQL Server a un file di dati con le modalità consuete.

Definizione di identificatori contenenti spazi o virgolette

Gli identificatori di SQL Server possono includere caratteri come spazi incorporati e virgolette. Tali identificatori possono essere utilizzati nei modi seguenti:

  • Quando al prompt dei comandi si specifica un identificatore o un nome di file che include uno spazio o una virgoletta singola, racchiuderlo tra virgolette doppie ("").

    Il comando bcp out seguente, ad esempio, consente di creare un file di dati denominato Currency Types.dat:

    bcp AdventureWorks2022.Sales.Currency out "Currency Types.dat" -T -c

  • Per specificare un nome di database contenente uno spazio o una virgoletta singola, utilizzare l'opzione -q.

  • Per i nomi di proprietario, di tabella o di vista contenenti spazi incorporati o virgolette, è possibile effettuare le operazioni seguenti:

    • Specificare l'opzione -q oppure

    • Racchiudere il nome del proprietario, della tabella o della vista tra parentesi quadre ([]) all'interno di virgolette.

Convalida dei dati

L'utilitàbcp ora esegue la convalida e i controlli dei dati che possono causare la mancata esecuzione degli script quando questi vengono eseguiti su dati non validi inclusi in un file di dati. L'utilità bcp , ad esempio, verifica quanto segue:

  • Validità delle rappresentazioni native dei tipi di dati float o real.

  • La lunghezza dei dati Unicode è costituita da un numero pari di byte.

Il caricamento di alcuni tipi di dati non validi di cui può essere eseguita l'importazione bulk nelle versioni precedenti di SQL Server può avere esito negativo in questa versione. Nelle versioni precedenti l'errore si verifica solo quando un client tenta di accedere ai dati non validi. La convalida aggiuntiva riduce la possibilità di sorprese durante l'esecuzione di query sui dati in seguito al caricamento in blocco.

Esportazione o importazione in massa di documenti SQLXML

Per l'esportazione o l'importazione bulk di dati SQLXML, utilizzare uno dei tipi di dati seguenti nel file di formato.

Tipo di dati Effetto
SQLCHAR o SQLVARYCHAR I dati vengono inviati nella tabella codici del client o nella tabella codici implicita delle regole di confronto. L'effetto equivale a quello ottenuto specificando l'opzione -c senza definire un file di formato.
SQLNCHAR o SQLNVARCHAR I dati vengono inviati in formato Unicode. L'effetto equivale a quello ottenuto specificando l'opzione -w senza definire un file di formato.
SQLBINARY o SQLVARYBIN I dati vengono inviati senza conversione.

Autorizzazioni

Un'operazione bcp out richiede SELECT l'autorizzazione sulla tabella di origine.

Per un'operazione bcp in sono necessarie SELECT/INSERT autorizzazioni minime per la tabella di destinazione. Inoltre, ALTER TABLE l'autorizzazione è necessaria se sono soddisfatte le condizioni seguenti:

  • Esistono vincoli e l'hint CHECK_CONSTRAINTS non viene specificato.

    Per impostazione predefinita, i vincoli sono disabilitati. Per abilitare i vincoli in modo esplicito, usare l'opzione -h con l'hint CHECK_CONSTRAINTS .

  • I trigger esistono e l'hint FIRE_TRIGGER non è specificato.

    Per impostazione predefinita, i trigger non vengono attivati. Per attivare i trigger in modo esplicito, usare l'opzione -h con l'hint FIRE_TRIGGERS .

  • Si usa l'opzione -E per importare valori Identity da un file dati.

Nota

La richiesta di ALTER TABLE autorizzazione per la tabella di destinazione è stata introdotta in SQL Server 2005 (9.x). Questo requisito può causare l'esito negativo degli script bcp che non applicano trigger e controlli dei vincoli se l'account utente non dispone ALTER TABLE delle autorizzazioni per la tabella di destinazione.

Procedure consigliate relative alla modalità carattere (-c) e alla modalità nativa (-n)

In questa sezione sono presenti indicazioni relative alla modalità carattere (-c) e alla modalità nativa (-n).

  • (Amministratore/utente) Quando possibile, utilizzare il formato nativo (-n) per evitare i problemi relativi al separatore. Utilizzare il formato nativo per esportare e importare tramite SQL Server. Se i dati saranno importati in un database non SQL Server, esportarli da SQL Server con l'opzione -c o -w.

  • (Amministratore) Verificare i dati quando si usa bcp out. Ad esempio, quando si usa bcp out, bcp ine quindi bcp out si verifica che i dati vengano esportati correttamente e che i valori del carattere di terminazione non vengano usati come parte di alcuni valori di dati. Considerare di eseguire l'override dei caratteri di terminazione predefiniti (usando le opzioni -t e -r) con valori esadecimali casuali per evitare conflitti tra i valori del carattere di terminazione e i valori dei dati.

  • (Utente) Utilizzare un carattere di terminazione lungo e univoco (qualsiasi sequenza di byte o caratteri) per ridurre la possibilità di un conflitto con il valore stringa effettivo. Questa operazione può essere effettuata utilizzando le opzioni -t e -r.

Esempi

Gli esempi in questa sezione usano il database di esempio WideWorldImporters per SQL Server 2016 (13.x) e versioni successive, database SQL di Azure e Istanza gestita di SQL di Azure. WideWorldImporters può essere scaricato da https://github.com/Microsoft/sql-server-samples/releases/tag/wide-world-importers-v1.0. Per la sintassi da usare per ripristinare il database di esempio, vedere Istruzioni RESTORE.

Condizioni di test di esempio

Se non specificato diversamente, si presuppone che l'utente usi l'autenticazione di Windows e abbia una connessione trusted all'istanza del server in cui viene eseguito il comando bcp . Una directory denominata D:\bcp viene usata nella maggior parte degli esempi.

Lo script di Transact-SQL seguente crea una copia vuota della WideWorldImporters.Warehouse.StockItemTransactions tabella e quindi aggiunge un vincolo di chiave primaria:

USE WideWorldImporters;
GO

SET NOCOUNT ON;

IF NOT EXISTS (SELECT *
               FROM sys.tables
               WHERE name = 'Warehouse.StockItemTransactions_bcp')
    BEGIN
        SELECT *
        INTO WideWorldImporters.Warehouse.StockItemTransactions_bcp
        FROM WideWorldImporters.Warehouse.StockItemTransactions
        WHERE 1 = 2;

        ALTER TABLE Warehouse.StockItemTransactions_bcp
        ADD CONSTRAINT PK_Warehouse_StockItemTransactions_bcp
            PRIMARY KEY NONCLUSTERED (StockItemTransactionID ASC);
    END

È possibile troncare la tabella StockItemTransactions_bcp in base alle esigenze:

TRUNCATE TABLE WideWorldImporters.Warehouse.StockItemTransactions_bcp;

A. Identificare la versione dell'utilità bcp

Al prompt dei comandi immettere il comando seguente:

bcp -v

B. Copia le righe della tabella in un file di dati (con connessione attendibile)

Gli esempi seguenti illustrano l'uso dell'opzione out nella tabella WideWorldImporters.Warehouse.StockItemTransactions.

  • Base

    Questo esempio crea un file di dati denominato StockItemTransactions_character.bcp in cui vengono copiati i dati della tabella usando il formato carattere .

    Al prompt dei comandi immettere il comando seguente:

    bcp WideWorldImporters.Warehouse.StockItemTransactions out D:\bcp\StockItemTransactions_character.bcp -c -T

  • Esteso

    Questo esempio crea un file di dati denominato StockItemTransactions_native.bcp in cui vengono copiati i dati della tabella usando il formato nativo . L'esempio inoltre: specifica il numero massimo di errori di sintassi, un file di errore e un file di output.

    Al prompt dei comandi immettere il comando seguente:

    bcp WideWorldImporters.Warehouse.StockItemTransactions OUT D:\bcp\StockItemTransactions_native.bcp -m 1 -n -e D:\bcp\Error_out.log -o D:\bcp\Output_out.log -S -T

Esaminare Error_out.log e Output_out.log. Error_out.log deve essere vuoto. Confrontare le dimensioni dei file tra StockItemTransactions_character.bcp e StockItemTransactions_native.bcp.

C. Copia le righe di tabella in un file di dati (con autenticazione in modalità mista)

L'esempio seguente illustra l'uso dell'opzione out nella tabella WideWorldImporters.Warehouse.StockItemTransactions. Questo esempio crea un file di dati denominato StockItemTransactions_character.bcp in cui vengono copiati i dati della tabella usando il formato carattere .

Si presuppone che l'utente usi l'autenticazione in modalità mista e quindi l'opzione -U è necessaria per specificare l'ID di accesso. A meno che non venga eseguita la connessione all'istanza predefinita di SQL Server sul computer locale, usare l'opzione -S per specificare il nome di sistema e, facoltativamente, il nome di un'istanza.

Al prompt dei comandi, immettere il comando seguente (il sistema chiede di specificare la password):

bcp WideWorldImporters.Warehouse.StockItemTransactions out D:\bcp\StockItemTransactions_character.bcp -c -U<login_id> -S<server_name\instance_name>

D. Copia dati da un file a una tabella

Gli esempi seguenti illustrano l'opzione in nella tabella WideWorldImporters.Warehouse.StockItemTransactions_bcp tramite i file creati in precedenza.

  • Base

    Questo esempio usa il file di dati StockItemTransactions_character.bcp creato in precedenza.

    Al prompt dei comandi immettere il comando seguente:

    bcp WideWorldImporters.Warehouse.StockItemTransactions_bcp IN D:\bcp\StockItemTransactions_character.bcp -c -T

  • Esteso

    Questo esempio usa il file di dati StockItemTransactions_native.bcp creato in precedenza. L'esempio inoltre: usa l'hint TABLOCK, specifica la dimensione del batch, il numero massimo di errori di sintassi, un file di errore e un file di output.

    Al prompt dei comandi immettere il comando seguente:

    bcp WideWorldImporters.Warehouse.StockItemTransactions_bcp IN D:\bcp\StockItemTransactions_native.bcp -b 5000 -h "TABLOCK" -m 1 -n -e D:\bcp\Error_in.log -o D:\bcp\Output_in.log -S -T

    Esaminare Error_in.log e Output_in.log.

E. Copia una colonna specifica in un file di dati

Per copiare una colonna specifica, è possibile usare l'opzione queryout. Nell'esempio seguente viene copiata in un file di dati solo la colonna StockItemTransactionID della tabella Warehouse.StockItemTransactions .

Al prompt dei comandi immettere il comando seguente:

bcp "SELECT StockItemTransactionID FROM WideWorldImporters.Warehouse.StockItemTransactions WITH (NOLOCK)" queryout D:\bcp\StockItemTransactionID_c.bcp -c -T

F. Copia una riga specifica in un file di dati

Per copiare una riga specifica, è possibile usare l'opzione queryout. Nell'esempio seguente solo la riga dell'utente denominato Amy Trefl viene copiata dalla tabella WideWorldImporters.Application.People in un file di dati Amy_Trefl_c.bcp.

Nota

L'opzione -d viene utilizzata per identificare il database.

Al prompt dei comandi immettere il comando seguente:

bcp "SELECT * from Application.People WHERE FullName = 'Amy Trefl'" queryout D:\bcp\Amy_Trefl_c.bcp -d WideWorldImporters -c -T

G. Copia dati da una query a un file di dati

Per copiare il set di risultati da un'istruzione Transact-SQL a un file di dati, usare l'opzione queryout. Nell'esempio seguente vengono copiati i nomi dalla tabella WideWorldImporters.Application.People nel file di dati People.txt , ordinandoli in base al nome completo.

Nota

L'opzione -t viene usata per creare un file delimitato da virgole.

Al prompt dei comandi immettere il comando seguente:

bcp "SELECT FullName, PreferredName FROM WideWorldImporters.Application.People ORDER BY FullName" queryout D:\bcp\People.txt -t, -c -T

H. Creare file di formato

Nell'esempio seguente vengono creati tre diversi file di formato per la tabella Warehouse.StockItemTransactions nel database WideWorldImporters . Esaminare il contenuto di ogni file creato.

Al prompt dei comandi immettere i comandi seguenti:

REM non-XML character format
bcp WideWorldImporters.Warehouse.StockItemTransactions format nul -f D:\bcp\StockItemTransactions_c.fmt -c -T

REM non-XML native format
bcp WideWorldImporters.Warehouse.StockItemTransactions format nul -f D:\bcp\StockItemTransactions_n.fmt -n -T

REM XML character format
bcp WideWorldImporters.Warehouse.StockItemTransactions format nul -f D:\bcp\StockItemTransactions_c.xml -x -c -T

Nota

Per usare l'opzione -x, è necessario avere un client bcp 9.0. Per informazioni su come usare il client bcp 9.0, vedere la sezione Osservazioni .

Per altre informazioni, vedere Usare file in formato non XML (SQL Server) e File in formato XML (SQL Server).

I. Usare un file di formato per l'importazione in blocco con bcp

Per usare un file di formato creato in precedenza durante l'importazione di dati in un'istanza di SQL Server, specificare -f con l'opzione in. Il comando seguente, ad esempio, consente di eseguire la copia bulk del contenuto di un file di dati, StockItemTransactions_character.bcp, in una copia della tabella Warehouse.StockItemTransactions_bcp usando il file di formato creato in precedenza, StockItemTransactions_c.xml.

Nota

L'opzione -L viene usata per importare solo i primi 100 record.

Al prompt dei comandi immettere il comando seguente:

bcp WideWorldImporters.Warehouse.StockItemTransactions_bcp in D:\bcp\StockItemTransactions_character.bcp -L 100 -f D:\bcp\StockItemTransactions_c.xml -T

Nota

I file di formato risultano particolarmente utili quando i campi dei file di dati sono diversi dalle colonne della tabella, ad esempio per numero, ordine o tipi di dati. Per altre informazioni, vedere Formattare i file per importare ed esportare i dati (SQL Server).

J. Specificare una pagina di codice

Il seguente esempio parziale di codice mostra l'importazione bcp specificando una pagina codice 65001.

bcp MyTable in "D:\data.csv" -T -c -C 65001 -t , ...

K. File di output di esempio che utilizza un campo personalizzato e dei delimitatori di riga

Questo esempio mostra due file di esempio, generati da bcp utilizzando caratteri di terminazione di campo e riga personalizzati.

  1. Creare una tabella dbo.T1 nel database tempdb con due colonne, ID e Name.

    USE tempdb;
GO

CREATE TABLE dbo.T1 (ID INT, [Name] NVARCHAR (20));
GO

INSERT INTO dbo.T1 VALUES (1, N'Natalia');
INSERT INTO dbo.T1 VALUES (2, N'Mark');
INSERT INTO dbo.T1 VALUES (3, N'Randolph');
GO

  2. Generare un file di output dalla tabella di esempio dbo.T1 utilizzando un carattere di terminazione del campo personalizzato.

    In questo esempio il nome del server è MYSERVERe -t , specifica il carattere di terminazione del campo personalizzato.

    bcp dbo.T1 out T1.txt -T -S MYSERVER -d tempdb -w -t ,

    Il set di risultati è il seguente.

    1,Natalia
2,Mark
3,Randolph

  3. Generare un file di output dalla tabella di esempio dbo.T1 utilizzando un carattere di terminazione del campo e un carattere di terminazione riga personalizzati.

    In questo esempio il nome del server è MYSERVER, -t , specifica il carattere di terminazione del campo personalizzato e -r : specifica il terminatore di riga personalizzato.

    bcp dbo.T1 out T1.txt -T -S MYSERVER -d tempdb -w -t , -r :

    Il set di risultati è il seguente.

    1,Natalia:2,Mark:3,Randolph:

    Nota

    Il carattere di terminazione di riga viene sempre aggiunto, anche all'ultimo record. Tuttavia, il carattere di terminazione del campo non viene aggiunto all'ultimo campo.

Esempi aggiuntivi

Negli articoli seguenti sono inclusi altri esempi relativi all'uso di bcp:

Contenuto correlato

Ottieni aiuto

Contribuire alla documentazione di SQL

Sapevi che puoi modificare il contenuto SQL da solo? L'autore delle modifiche contribuirà a migliorare la documentazione e verrà accreditato come collaboratore alla realizzazione della pagina.

Per altre informazioni, vedere Modificare la documentazione di Microsoft Learn.