INSERT (Transact-SQL)

Articolo
05/23/2023

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

Consente di aggiungere una o più righe a una tabella o a una vista in SQL Server. Per alcuni esempi, vedere Esempi.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

-- Syntax for SQL Server and Azure SQL Database  

[ WITH <common_table_expression> [ ,...n ] ]  
INSERT   
{  
        [ TOP ( expression ) [ PERCENT ] ]   
        [ INTO ]   
        { <object> | rowset_function_limited   
          [ WITH ( <Table_Hint_Limited> [ ...n ] ) ]  
        }  
    {  
        [ ( column_list ) ]   
        [ <OUTPUT Clause> ]  
        { VALUES ( { DEFAULT | NULL | expression } [ ,...n ] ) [ ,...n     ]   
        | derived_table   
        | execute_statement  
        | <dml_table_source>  
        | DEFAULT VALUES   
        }  
    }  
}  
[;]  
  
<object> ::=  
{   
    [ server_name . database_name . schema_name .   
      | database_name .[ schema_name ] .   
      | schema_name .   
    ]  
  table_or_view_name  
}  
  
<dml_table_source> ::=  
    SELECT <select_list>  
    FROM ( <dml_statement_with_output_clause> )   
      [AS] table_alias [ ( column_alias [ ,...n ] ) ]  
    [ WHERE <search_condition> ]  
        [ OPTION ( <query_hint> [ ,...n ] ) ]

-- External tool only syntax  

INSERT   
{  
    [BULK]  
    { database_name.schema_name.table_or_view_name | schema_name.table_or_view_name | table_or_view_name }  
    ( <column_definition> )  
    [ WITH (  
        [ [ , ] CHECK_CONSTRAINTS ]  
        [ [ , ] FIRE_TRIGGERS ]  
        [ [ , ] KEEP_NULLS ]  
        [ [ , ] KILOBYTES_PER_BATCH = kilobytes_per_batch ]  
        [ [ , ] ROWS_PER_BATCH = rows_per_batch ]  
        [ [ , ] ORDER ( { column [ ASC | DESC ] } [ ,...n ] ) ]  
        [ [ , ] TABLOCK ]  
    ) ]  
}  
  
[; ] <column_definition> ::=  
 column_name <data_type>  
    [ COLLATE collation_name ]  
    [ NULL | NOT NULL ]  
  
<data type> ::=   
[ type_schema_name . ] type_name   
    [ ( precision [ , scale ] | max ]

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse and Microsoft Fabric

INSERT [INTO] { database_name.schema_name.table_name | schema_name.table_name | table_name }
    [ ( column_name [ ,...n ] ) ]  
    {   
      VALUES ( { NULL | expression } )  
      | SELECT <select_criteria>  
    }  
    [ OPTION ( <query_option> [ ,...n ] ) ]  
[;]

Argomenti

WITH <common_table_expression>
Specifica il set di risultati denominato temporaneo, noto anche come espressione di tabella comune, definito nell'ambito dell'istruzione INSERT. Il set di risultati deriva da un'istruzione SELECT. Per altre informazioni, vedere WITH common_table_expression (Transact-SQL).

TOP (expression) [ PERCENT ]
Specifica il numero o la percentuale di righe casuali che verranno inserite. Il valore diexpression può essere specificato come numero o come percentuale di righe. Per altre informazioni, vedere TOP (Transact-SQL).

INTO
Parola chiave facoltativa che può essere specificata tra INSERT e la tabella di destinazione.

server_name
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Nome del server collegato in cui si trova la tabella o la vista. server_name può essere specificato come nome di server collegato o tramite la funzione OPENDATASOURCE.

Quando nome_server è specificato come server collegato, è obbligatorio specificare database_name e schema_name. Quando server_name viene specificato con OPENDATASOURCE, database_name e schema_name possono non essere validi per tutte le origini dati e non essere soggetti alle funzionalità del provider OLE DB che accede all'oggetto remoto.

database_name
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Nome del database.

schema_name
Nome dello schema a cui appartiene la tabella o la vista.

table_or view_name
Nome della tabella o della vista in cui si desidera inserire i dati.

Una variabile table, all'interno del proprio ambito, può essere usata come origine di tabella in un'istruzione INSERT.

È necessario che la vista a cui viene fatto riferimento in table_or_view_name sia aggiornabile e includa un riferimento esatto a una tabella di base nella clausola FROM della definizione della vista. In un'istruzione INSERT eseguita in una vista a più tabelle, ad esempio, è necessario specificare un argomento column_list che faccia riferimento solo alle colonne di una sola tabella di base. Per altre informazioni sulle viste aggiornabili, vedere CREATE VIEW (Transact-SQL).

rowset_function_limited
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Funzione OPENQUERY o OPENROWSET. L'utilizzo di queste funzioni è soggetto alle funzionalità del provider OLE DB che accede all'oggetto remoto.

WITH ( <table_hint_limited> [... n ] )
Specifica uno o più hint di tabella consentiti per una tabella di destinazione. La parola chiave WITH e le parentesi sono obbligatorie.

Le opzioni READPAST, NOLOCK e READUNCOMMITTED non sono consentite. Per altre informazioni sugli hint di tabella, vedere Hint di tabella (Transact-SQL).

Importante

La funzionalità che consente di specificare gli hint HOLDLOCK, SERIALIZABLE, READCOMMITTED, REPEATABLEREAD o UPDLOCK su tabelle specificate come destinazione di istruzioni INSERT verrà rimossa a partire da una delle prossime versioni di SQL Server. Questi hint non influiscono sulle prestazioni delle istruzioni INSERT. Evitarne l'utilizzo in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui sono attualmente implementati.

La specifica di un hint TABLOCK in una tabella di destinazione di un'istruzione INSERT equivale alla specifica dell'hint TABLOCKX poiché determina l'acquisizione di un blocco esclusivo sulla tabella.

(column_list)
Elenco di una o più colonne in cui inserire i dati. Il valore di column_list deve essere racchiuso tra parentesi e delimitato da virgole.

Se una colonna non è presente nell'elenco column_list, il motore di database deve essere in grado di fornire un valore in base alla definizione della colonna. In caso contrario, la riga non può essere caricata. Nel motore di database viene fornito automaticamente un valore se la colonna soddisfa i requisiti seguenti:

Dispone di una proprietà IDENTITY. Viene utilizzato il valore Identity incrementale successivo.
Include un valore predefinito. Viene utilizzato il valore predefinito della colonna.
È di tipo timestamp. Viene utilizzato il valore timestamp corrente.
Ammette i valori Null. Viene utilizzato un valore Null.
Colonna calcolata. Viene utilizzato il valore calcolato.

Quando vengono inseriti valori espliciti in una colonna Identity, è necessario usare column_list. L'opzione SET IDENTITY_INSERT ,poi, deve essere impostata su ON per la tabella.

Clausola OUTPUT
Restituisce le righe inserite come parte dell'operazione di inserimento. I risultati possono essere restituiti all'applicazione di elaborazione o possono essere inseriti in una tabella o in una variabile di tabella per essere elaborati ulteriormente.

La clausola OUTPUT non è supportata in istruzioni DML che fanno riferimento a viste partizionate locali, viste partizionate distribuite o tabelle remote, né in istruzioni INSERT che contengono un parametro execute_statement. La clausola OUTPUT INTO non è supportata in istruzioni INSERT che contengono una clausola <dml_table_source>. Per altre informazioni sugli argomenti e sul comportamento di questa clausola, vedere Clausola OUTPUT (Transact-SQL).

VALUES
Parola chiave che introduce l'elenco o gli elenchi di valori dei dati da inserire. Deve essere disponibile un valore per ogni colonna in column_list, se specificato, o nella tabella. L'elenco di valori deve essere racchiuso tra parentesi.

Se i valori dell'elenco di valori non sono nello stesso ordine delle colonne della tabella o se non è disponibile un valore per ogni colonna della tabella, è necessario usare column_list per specificare in modo esplicito la colonna in cui vengono archiviati i valori inseriti.

È possibile usare il costruttore di riga di Transact-SQL, denominato anche costruttore di valori di tabella, per specificare più righe in una singola istruzione INSERT. Il costruttore di riga è costituito da una singola clausola VALUES con più elenchi di valori racchiusi tra parentesi e separati da una virgola. Per altre informazioni, vedere Costruttore di valori di tabella (Transact-SQL).

Nota

Il costruttore di valori di tabella non è supportato in Azure Synapse Analytics. È invece possibile eseguire istruzioni successive INSERT per inserire più righe. In Azure Synapse Analytics i valori di inserimento possono essere solo valori letterali costanti o riferimenti a variabili. Per inserire un valore non letterale, impostare una variabile su valore non costante e inserire la variabile.

DEFAULT
Forza il caricamento nel motore di database del valore predefinito di una colonna. Se per la colonna non è disponibile alcun valore predefinito e la colonna ammette valori NULL, viene inserito un valore NULL. Per una colonna definita con tipo di dati timestamp, viene inserito il valore timestamp successivo. DEFAULT non è un valore valido per una colonna Identity.

expression
Costante, variabile o espressione. L'espressione non può contenere un'istruzione EXECUTE.

Quando si fa riferimento ai tipi di dati dei caratteri Unicode nchar, nvarchar e ntext, è necessario far precedere 'expression' dalla lettera maiuscola 'N'. Se la lettera "N" non è specificata, in SQL Server la stringa viene convertita in base alla tabella codici corrispondente alle regole di confronto predefinite del database o della colonna. Tutti i caratteri non trovati nella tabella codici vengono persi.

derived_table
Qualsiasi istruzione SELECT valida che restituisce righe di dati da caricare nella tabella. L'istruzione SELECT non può contenere un'espressione di tabella comune.

execute_statement
Qualsiasi istruzione EXECUTE valida che restituisce dati con le istruzioni SELECT o READTEXT. Per altre informazioni, vedere EXECUTE (Transact-SQL).

Le opzioni RESULT SETS dell'istruzione EXECUTE non possono essere specificate in un'istruzione INSERT...EXEC.

Se con INSERT si usa execute_statement, ogni set di risultati deve essere compatibile con le colonne nella tabella o in column_list.

È possibile usare execute_statement per eseguire stored procedure nello stesso server o in un server remoto. Viene eseguita la procedura nel server remoto e i set di risultati vengono restituiti al server locale e caricati nella tabella relativa. In una transazione distribuita execute_statement non può essere eseguito a fronte di un server collegato di loopback quando per la connessione è abilitato MARS (Multiple Active Result Set).

Se execute_statement restituisce dati con l'istruzione READTEXT, ogni istruzione READTEXT può restituire dati per un valore massimo di 1 MB (1024 KB). È anche possibile usare execute_statement con procedure estese. execute_statement inserisce i dati restituiti dal thread principale della procedura estesa. Gli output dei thread diversi da quello principale, tuttavia, non vengono inseriti.

Un parametro con valori di tabella non può essere specificato come destinazione di un'istruzione INSERT EXEC, ma può essere specificato come origine nella stringa INSERT EXEC o nella stored procedure. Per altre informazioni, vedere Usare parametri con valori di tabella (motore di database).

<dml_table_source>
Specifica che le righe inserite nella tabella di destinazione sono quelle restituite dalla clausola OUTPUT di un'istruzione INSERT, UPDATE, DELETE o MERGE, facoltativamente filtrate da una clausola WHERE. Se si specifica <dml_table_source>, la destinazione dell'istruzione INSERT esterna deve soddisfare le restrizioni seguenti:

Deve essere una tabella di base e non una vista.
Non può essere una tabella remota.
Non può includere trigger definiti.
Non può partecipare ad alcuna relazione di chiave primaria/chiave esterna.
Non può partecipare alla replica di tipo merge né a sottoscrizioni aggiornabili per la replica transazionale.

Il livello di compatibilità del database deve essere impostato su 100 o più. Per altre informazioni, vedere Clausola OUTPUT (Transact-SQL).

<select_list>
Elenco delimitato da virgole che specifica le colonne restituite dalla clausola OUTPUT da inserire. Le colonne in <select_list> devono essere compatibili con le colonne in cui vengono inseriti i valori. <select_list> non può fare riferimento a funzioni di aggregazione né a TEXTPTR.

Nota

Qualsiasi variabile elencata nell'elenco SELECT fa riferimento ai rispettivi valori originali, indipendentemente da qualsiasi modifica apportata a tali valori in <dml_statement_with_output_clause>.

<dml_statement_with_output_clause>
Istruzione INSERT, UPDATE, DELETE o MERGE valida che restituisce le righe interessate in una clausola OUTPUT. L'istruzione non può contenere una clausola WITH e non può avere come destinazione tabelle remote o viste partizionate. Se si specifica UPDATE o DELETE, non può trattarsi di un'istruzione UPDATE o DELETE basata su cursori. Non è possibile fare riferimento alle righe di origine come istruzioni DML nidificate.

WHERE <search_condition>
Qualsiasi clausola WHERE contenente un valore valido per <search_condition> in grado di filtrare le righe restituite da <dml_statement_with_output_clause>. Per altre informazioni, vedere Condizione di ricerca (Transact-SQL). Se usato in questo contesto, <search_condition> non può contenere sottoquery, funzioni scalari definite dall'utente che eseguono l'accesso ai dati, funzioni di aggregazione, TEXTPTR o predicati di ricerca full-text.

DEFAULT VALUES
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Forza l'inserimento nella nuova riga dei valori predefiniti associati a ogni colonna.

BULK
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Utilizzato dagli strumenti esterni per caricare un flusso di dati binario. Questa opzione non è destinata all'uso con strumenti quali SQL Server Management Studio, SQLCMD, OSQL o API di accesso ai dati come SQL Native Client.

FIRE_TRIGGERS
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Specifica che gli eventuali trigger di inserimento definiti nella tabella di destinazione vengano eseguiti durante l'operazione di caricamento del flusso di dati binario. Per altre informazioni, vedere BULK INSERT (Transact-SQL).

CHECK_CONSTRAINTS
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Specifica che tutti i vincoli sulla tabella o sulla vista di destinazione devono essere controllati durante l'operazione di caricamento del flusso di dati binario. Per altre informazioni, vedere BULK INSERT (Transact-SQL).

KEEPNULLS
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Specifica che le colonne vuote devono mantenere un valore null durante l'operazione di caricamento del flusso di dati binario. Per altre informazioni, vedere Mantenere i valori Null o usare i valori predefiniti durante l'importazione bulk (SQL Server).

KILOBYTES_PER_BATCH = kilobytes_per_batch
Specifica il numero approssimativo di kilobyte (KB) di dati per ogni batch come kilobytes_per_batch. Per altre informazioni, vedere BULK INSERT (Transact-SQL).

ROWS_PER_BATCH =rows_per_batch
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Indica il numero approssimativo di righe di dati nel flusso di dati binario. Per altre informazioni, vedere BULK INSERT (Transact-SQL).

Nota

Se non viene specificato un elenco di colonne, viene generato un errore di sintassi.

Osservazioni:

Per informazioni specifiche sull'inserimento di dati in tabelle grafici SQL, vedere INSERT (grafico SQL).

Consigli per iniziare

Usare la funzione @@ROWCOUNT per restituire il numero di righe inserite all'applicazione client. Per altre informazioni, vedere @@ROWCOUNT (Transact-SQL).

Procedure consigliate per l'importazione bulk di dati

Uso di INSERT INTO...SELECT per eseguire l'importazione bulk dei dati con registrazione minima e parallelismo

È possibile usare INSERT INTO <target_table> SELECT <columns> FROM <source_table> per trasferire in modo efficiente un numero elevato di righe da una tabella, ad esempio una tabella di staging, in un'altra tabella con registrazione minima. La registrazione minima può migliorare le prestazioni dell'istruzione e ridurre la possibilità che l'operazione riempia lo spazio del log delle transazioni disponibile durante la transazione.

Per utilizzare la registrazione minima con questa istruzione, sono necessari i requisiti seguenti:

Il modello di recupero del database deve essere impostato sul modello con registrazione minima o con registrazione minima delle operazioni bulk.
La tabella di destinazione deve essere un heap vuoto o non vuoto.
La tabella di destinazione non deve essere utilizzata nella replica.
L'hint TABLOCK deve essere specificato per la tabella di destinazione.

Per le righe inserite in un heap come risultato di un'azione di inserimento in un'istruzione MERGE può essere eseguita la registrazione minima.

A differenza dell'istruzione BULK INSERT, che contiene un blocco di aggiornamento bulk meno restrittivo, l'istruzione INSERT INTO … SELECT con l'hint TABLOCK contiene un blocco esclusivo (X) nella tabella. Ciò significa che non è possibile inserire righe usando operazioni di inserimento multiple eseguite simultaneamente.

Tuttavia, a partire da SQL Server 2016 (13.x) e dal livello di compatibilità del database 130, una singola istruzione INSERT INTO … SELECT può essere eseguita in parallelo durante l'inserimento in heap o indici columnstore cluster (CCI). Gli inserimenti paralleli sono possibili quando si usa l'hint TABLOCK.

Il parallelismo per l'istruzione precedente presenta i requisiti seguenti, simili ai requisiti per la registrazione minima:

La tabella di destinazione deve essere un heap vuoto o non vuoto.
La tabella di destinazione deve includere un indice columnstore cluster (CCI) ma non indici non cluster.
La tabella di destinazione non deve contenere una colonna Identity con IDENTITY_INSERT impostato su OFF.
L'hint TABLOCK deve essere specificato per la tabella di destinazione.

Per gli scenari in cui sono soddisfatti i requisiti per la registrazione minima e l'inserimento parallelo, entrambi i miglioramenti funzioneranno insieme per garantire la massima velocità effettiva delle operazioni di caricamento dei dati.

Per altre informazioni sull'uso di INSERT in Warehouse in Microsoft Fabric, vedere Inserire dati nel warehouse tramite Transact-SQL.

Nota

Anche gli inserimenti all'interno di tabelle temporanee locali (identificate dal prefisso #) e di tabelle temporanee globali (identificate da prefissi ##) sono abilitati per il parallelismo usando l'hint TABLOCK.

Uso di OPENROWSET e BULK per l'importazione bulk dei dati

La funzione OPENROWSET può accettare gli hint di tabella seguenti i quali supportano le ottimizzazioni per il caricamento bulk con l'istruzione INSERT:

L'hint TABLOCK può ridurre al minimo il numero di record del log per l'operazione di inserimento. Per il database è necessario impostare il modello di recupero con registrazione minima o con registrazione minima delle operazioni bulk. La tabella di destinazione non può inoltre essere utilizzata nella replica. Per altre informazioni, vedere Prerequisiti per la registrazione minima nell'importazione bulk.
L'hint TABLOCK può abilitare le operazioni di inserimento parallele. La tabella di destinazione è un heap o un indice columnstore cluster (CCI) senza indici non cluster e non è possibile specificare una colonna Identity per la tabella di destinazione.
Il controllo dei vincoli FOREIGN KEY e CHECK può essere disabilitato temporaneamente specificando l'hint IGNORE_CONSTRAINTS.
L'esecuzione dei trigger può essere disabilitata temporaneamente specificando l'hint IGNORE_TRIGGERS.
L'hint KEEPDEFAULTS consente l'inserimento del valore predefinito di una colonna di tabella, se disponibile, al posto del valore NULL quando nel record di dati non è presente un valore per la colonna.
L'hint KEEPIDENTITY consente l'utilizzo dei valori Identity presenti nel file di dati importato per la colonna Identity nella tabella di destinazione.

Queste ottimizzazioni sono simili a quelle disponibili con il comando BULK INSERT. Per ulteriori informazioni, vedere Hint di tabella (Transact-SQL).

Tipi di dati

Quando si inseriscono righe, considerare il comportamento dei tipi di dati seguenti:

Se un valore viene caricato in colonne di tipo char, varchar o varbinary, il riempimento o il troncamento degli spazi vuoti finali (spazi per i tipi di dati char e varchar, zeri per varbinary) viene determinato dall'impostazione SET ANSI_PADDING definita per la colonna alla creazione della tabella. Per altre informazioni, vedere SET ANSI_PADDING (Transact-SQL).

Nella tabella seguente vengono descritte le operazioni predefinite per SET ANSI_PADDING OFF.

Tipo di dati	Operazione predefinita
char	Il valore viene riempito con spazi fino alla larghezza di colonna specificata.
varchar	Gli spazi finali vengono rimossi fino all'ultimo carattere diverso dallo spazio o fino al carattere di spazio singolo per le stringhe composte da soli spazi.
varbinary	Gli zero finali vengono rimossi.

Se una stringa vuota (' ') viene caricata in una colonna di tipo varchar o text, l'operazione predefinita prevede il caricamento di una stringa di lunghezza zero.
L'inserimento di un valore Null in una colonna di tipo text o image non consente di creare un puntatore di testo valido né di preallocare una pagina di testo da 8 KB.
Nelle colonne di tipo uniqueidentifier vengono archiviati valori binari a 16 byte con una formattazione speciale. Diversamente dalle colonne Identity, il motore di database non genera automaticamente valori per le colonne di tipo uniqueidentifier. Durante un'operazione di inserimento è possibile usare variabili di tipo uniqueidentifier e costanti stringa nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (36 caratteri inclusi i trattini, dove x è una cifra esadecimale compresa nell'intervallo 0-9 o a-f) per le colonne di tipo uniqueidentifier. 6F9619FF-8B86-D011-B42D-00C04FC964FF, ad esempio, è un valore valido per una variabile o una colonna di tipouniqueidentifier. Per ottenere un ID univoco globale (GUID), usare la funzione NEWID().

Inserimento di valori in colonne di tipo definito dall'utente

Per inserire valori in colonne di tipo definito dall'utente è possibile effettuare una delle operazioni indicate di seguito:

Specificare un valore del tipo definito dall'utente.
Specificare valore in un tipo di dati di sistema di SQL Server, a condizione che i tipi definiti dall'utente supportino la conversione implicita o esplicita da quel tipo. L'esempio seguente illustra come inserire un valore in una colonna del tipo definito dall'utente Point tramite conversione esplicita da una stringa.
```
INSERT INTO Cities (Location)  
VALUES ( CONVERT(Point, '12.3:46.2') );  
```
È inoltre possibile specificare un valore binario senza eseguirne la conversione esplicita, perché tutti i tipi definiti dall'utente possono essere convertiti in modo implicito dal tipo binario.
Chiamare una funzione definita dall'utente che restituisce un valore con il tipo definito dall'utente. Nell'esempio seguente viene utilizzata la funzione definita dall'utente CreateNewPoint() per creare un nuovo valore con il tipo definito dall'utente Point e inserire tale valore nella tabella Cities.
```
INSERT INTO Cities (Location)  
VALUES ( dbo.CreateNewPoint(x, y) );  
```

Gestione errori

È possibile implementare la gestione degli errori per l'istruzione INSERT specificando l'istruzione in un costrutto TRY...CATCH.

Se un'istruzione INSERT viola un vincolo o una regola oppure il valore non è compatibile con il tipo di dati della colonna, l'istruzione ha esito negativo e viene restituito un messaggio di errore.

Se l'istruzione INSERT carica più righe tramite SELECT o EXECUTE e i valori caricati violano una regola o un vincolo, l'istruzione viene arrestata e non viene caricata alcuna riga.

Quando un'istruzione INSERT rileva un errore aritmetico (overflow, divisione per zero o errore di dominio) durante la valutazione di un'espressione, l'errore viene gestito dal motore di database come se l'opzione SET ARITHABORT fosse impostata su ON. Il batch viene arrestato e viene restituito un messaggio di errore. Quando un'istruzione INSERT, DELETE o UPDATE rileva un errore aritmetico (un errore di overflow, una divisione per zero o un errore di dominio) durante la valutazione di un'espressione, se SET ARITHABORT e SET ANSI_WARNINGS sono impostate su OFF, SQL Server inserisce o aggiorna un valore Null. Se la colonna di destinazione non ammette valori Null, l'operazione di inserimento o aggiornamento ha esito negativo e viene generato un errore per l'utente.

Interoperabilità

Se viene definito un trigger INSTEAD OF nelle azioni INSERT eseguite in una tabella o vista, viene eseguito il trigger anziché l'istruzione INSERT. Per altre informazioni sui trigger INSTEAD OF, vedere CREATE TRIGGER (Transact-SQL).

Limitazioni e restrizioni

Quando si inseriscono valori in tabelle remote e non tutti i valori per tutte le colonne vengono specificati, è necessario identificare le colonne in cui devono essere inseriti i valori specificati.

Quando TOP viene utilizzato con INSERT, le righe a cui viene fatto riferimento non vengono disposte in alcun ordine e non è possibile specificare la clausola ORDER BY direttamente in tali istruzioni. Se è necessario utilizzare TOP per inserire righe in un ordine cronologico significativo, è necessario utilizzare questa clausola insieme a una clausola ORDER BY specificata in un'istruzione sub-SELECT. Vedere la sezione Esempi più avanti in questo argomento.

Le query INSERT che usano SELECT con ORDER BY per popolare le righe garantiscono la modalità di calcolo dei valori Identity, ma non l'ordine in cui vengono inserite le righe.

In Parallel Data Warehouse la clausola ORDER BY non è valida in VIEWS, CREATE TABLE AS SELECT, INSERT SELECT, nelle funzioni inline, nelle tabelle derivate, nelle sottoquery e nelle espressioni di tabella comuni a meno che non sia specificata anche la clausola TOP.

Comportamento di registrazione

L'istruzione INSERT è sempre completamente registrata tranne quando si usa la funzione OPENROWSET con la parola chiave BULK o quando si usa l'istruzione INSERT INTO <target_table> SELECT <columns> FROM <source_table>. Per queste operazioni è possibile eseguire la registrazione minima. Per ulteriori informazioni, vedere la sezione "Procedure consigliate per il caricamento bulk dei dati" più indietro in questo argomento.

Sicurezza

Durante una connessione a un server collegato, il server mittente fornisce un nome di account di accesso e una password per connettersi al server ricevente per suo conto. Perché la connessione funzioni, è necessario creare un mapping dell'account di accesso tra i server collegati usando sp_addlinkedsrvlogin.

Quando si usa OPENROWSET(BULK...), è essenziale comprendere il modo in cui la rappresentazione viene gestita da SQL Server. Per altre informazioni, vedere "Considerazioni sulla sicurezza" Importazione di dati per operazioni bulk con BULK INSERT o OPENROWSET(BULK...) (SQL Server).

Autorizzazioni

È richiesta l'autorizzazione INSERT per la tabella di destinazione.

Le autorizzazioni INSERT vengono concesse per impostazione predefinita ai membri del ruolo predefinito del server sysadmin, ai membri dei ruoli predefiniti del database db_owner e db_datawriter e al proprietario della tabella. I membri dei ruoli sysadmin, db_owner e db_securityadmin e il proprietario della tabella possono trasferire le autorizzazioni ad altri utenti.

Per eseguire INSERT con l'opzione BULK della funzione OPENROWSET, è necessario essere un membro del ruolo predefinito del server sysadmin o bulkadmin.

Esempi

Categoria	Elementi di sintassi inclusi
Sintassi di base	INSERT * costruttore di valori di tabella
Gestione dei valori di colonna	IDENTITY * NEWID * valori predefiniti * tipi definiti dall'utente
Inserimento di dati da altre tabelle	INSERIRE... SELECT * INSERT... EXECUTE * WITH common table expression * TOP * OFFSET FETCH
Indicazione di oggetti di destinazione diversi dalle tabelle standard	Viste * variabili di tabella
Inserimento di righe in una tabella remota	Server collegato * funzione set di righe OPENQUERY * funzione set di righe OPENDATASOURCE
Caricamento bulk di dati da tabelle o file di dati	INSERIRE... SELECT * Funzione OPENROWSET
Override del comportamento predefinito di Query Optimizer tramite hint	Hint di tabella
Acquisizione dei risultati dell'istruzione INSERT	Clausola OUTPUT

Sintassi di base

Negli esempi contenuti in questa sezione vengono illustrate le funzionalità di base dell'istruzione INSERT tramite la sintassi minima richiesta.

R. Inserimento di una sola riga di dati

Nell'esempio seguente viene inserita una riga nella Production.UnitMeasure tabella nel database AdventureWorks2022. Le colonne nella tabella sono UnitMeasureCode, Name e ModifiedDate. Poiché i valori per tutte le colonne vengono specificati ed elencati nello stesso ordine delle colonne nella tabella, non è necessario specificare i nomi delle colonne nell'elenco delle colonne*.*

INSERT INTO Production.UnitMeasure  
VALUES (N'FT', N'Feet', '20080414');

B. Inserimento di più righe di dati

Nell'esempio seguente viene utilizzato il costruttore di valori di tabella per inserire tre righe nella Production.UnitMeasure tabella nel database AdventureWorks2022 in una singola istruzione INSERT. Poiché i valori per tutte le colonne vengono specificati ed elencati nello stesso ordine delle colonne nella tabella, non è necessario specificare i nomi delle colonne nell'elenco delle colonne.

Nota

Il costruttore del valore di tabella non è supportato in Azure Synapse Analytics.

INSERT INTO Production.UnitMeasure  
VALUES (N'FT2', N'Square Feet ', '20080923'), (N'Y', N'Yards', '20080923')
    , (N'Y3', N'Cubic Yards', '20080923');

C. Inserimento di dati in un ordine diverso rispetto alle colonne della tabella

Nell'esempio seguente viene utilizzato un elenco di colonne per specificare in modo esplicito i valori inseriti in ogni colonna. L'ordine di colonna nella Production.UnitMeasure tabella nel database AdventureWorks2022 è UnitMeasureCode, Name, ModifiedDate, ma le colonne non sono elencate in tale ordine in column_list.

INSERT INTO Production.UnitMeasure (Name, UnitMeasureCode,  
    ModifiedDate)  
VALUES (N'Square Yards', N'Y2', GETDATE());

Gestione dei valori delle colonne

Gli esempi in questa sezione illustrano i metodi di inserimento di valori in colonne definite con una proprietà IDENTITY, un valore DEFAULT o sono definiti con tipi di dati come uniqueidentifier o colonne di tipo definito dall'utente.

D. Inserimento di dati in una tabella con colonne che presentano valori predefiniti

Nell'esempio seguente viene illustrato l'inserimento di righe in una tabella con colonne per cui viene generato automaticamente un valore o è specificato un valore predefinito. Column_1 è una colonna calcolata che genera automaticamente un valore concatenando una stringa con il valore inserito in column_2. Column_2 è definito con un vincolo predefinito. Se per questa colonna non viene specificato alcun valore, viene utilizzato quello predefinito. Column_3 è definito con il tipo di dati rowversion, che genera automaticamente un numero binario incrementale univoco. Column_4 non genera automaticamente alcun valore. Quando non viene specificato alcun valore per questa colonna, viene inserito un valore NULL. Le istruzioni INSERT inseriscono righe che contengono valori solo per alcune delle colonne. Nell'ultima istruzione INSERT non viene specificata alcuna colonna e solo i valori predefiniti vengono inseriti tramite la clausola DEFAULT VALUES.

CREATE TABLE dbo.T1   
(  
    column_1 AS 'Computed column ' + column_2,   
    column_2 varchar(30)   
        CONSTRAINT default_name DEFAULT ('my column default'),  
    column_3 rowversion,  
    column_4 varchar(40) NULL  
);  
GO  
INSERT INTO dbo.T1 (column_4)   
    VALUES ('Explicit value');  
INSERT INTO dbo.T1 (column_2, column_4)   
    VALUES ('Explicit value', 'Explicit value');  
INSERT INTO dbo.T1 (column_2)   
    VALUES ('Explicit value');  
INSERT INTO T1 DEFAULT VALUES;   
GO  
SELECT column_1, column_2, column_3, column_4  
FROM dbo.T1;  
GO

E. Inserimento di dati in una tabella con una colonna Identity

Nell'esempio seguente vengono illustrati diversi metodi per l'inserimento di dati in una colonna Identity. Le prime due istruzioni INSERT consentono di generare valori Identity per le nuove righe. La terza istruzione INSERT ignora la proprietà IDENTITY per la colonna con l'istruzione SET IDENTITY_INSERT e inserisce un valore esplicito nella colonna Identity.

CREATE TABLE dbo.T1 ( column_1 int IDENTITY, column_2 VARCHAR(30));  
GO  
INSERT T1 VALUES ('Row #1');  
INSERT T1 (column_2) VALUES ('Row #2');  
GO  
SET IDENTITY_INSERT T1 ON;  
GO  
INSERT INTO T1 (column_1,column_2)   
    VALUES (-99, 'Explicit identity value');  
GO  
SELECT column_1, column_2  
FROM T1;  
GO

F. Inserimento di dati in una colonna uniqueidentifier tramite NEWID()

L'esempio seguente usata la funzione NEWID() per ottenere un GUID per column_2. Diversamente dalle colonne Identity, il motore di database non genera automaticamente valori per le colonne di tipo uniqueidentifier, come illustrato dalla seconda istruzione INSERT.

CREATE TABLE dbo.T1   
(  
    column_1 int IDENTITY,   
    column_2 uniqueidentifier,  
);  
GO  
INSERT INTO dbo.T1 (column_2)   
    VALUES (NEWID());  
INSERT INTO T1 DEFAULT VALUES;   
GO  
SELECT column_1, column_2  
FROM dbo.T1;

G. Inserimento di dati in colonne di tipo definito dall'utente

Le istruzioni Transact-SQL seguenti consentono di inserire tre righe nella colonna PointValue della tabella Points. Questa colonna usa un tipo CLR definito dall'utente (UDT). Il tipo di dati Point è costituito da valori integer X e Y esposti come proprietà del tipo definito dall'utente. È necessario utilizzare la funzione CAST o CONVERT per eseguire il cast dei valori X e Y delimitati da virgole al tipo Point. Le prime due istruzioni usano la funzione CONVERT per convertire un valore stringa nel tipo Point, mentre la terza istruzione usa la funzione CAST. Per altre informazioni, vedere Modifica di dati di tipo definito dall'utente.

INSERT INTO dbo.Points (PointValue) VALUES (CONVERT(Point, '3,4'));  
INSERT INTO dbo.Points (PointValue) VALUES (CONVERT(Point, '1,5'));  
INSERT INTO dbo.Points (PointValue) VALUES (CAST ('1,99' AS Point));

Inserimento di dati da altre tabelle

Negli esempi contenuti in questa sezione vengono illustrati i metodi per l'inserimento di righe da una tabella in un'altra.

H. Utilizzo delle opzioni SELECT ed EXECUTE per inserire dati da altre tabelle

Nell'esempio seguente viene illustrato come inserire dati da una tabella in un'altra usando l'istruzione INSERT...SELECT o INSERT...EXECUTE. Ogni metodo è basato su un'istruzione SELECT su più tabelle, in cui l'elenco di colonne include un'espressione e un valore letterale.

La prima istruzione INSERT usa un'istruzione SELECT per derivare i dati dalle tabelle di origine (Employee, SalesPersone Person) nel database AdventureWorks2022 e archiviare il set di risultati nella EmployeeSales tabella. Nella seconda istruzione INSERT viene utilizzata la clausola EXECUTE per chiamare una stored procedure che contiene l'istruzione SELECT. Nella terza istruzione INSERT viene utilizzata la clausola EXECUTE per fare riferimento all'istruzione SELECT come stringa letterale.

CREATE TABLE dbo.EmployeeSales  
( DataSource   varchar(20) NOT NULL,  
  BusinessEntityID   varchar(11) NOT NULL,  
  LastName     varchar(40) NOT NULL,  
  SalesDollars money NOT NULL  
);  
GO  
CREATE PROCEDURE dbo.uspGetEmployeeSales   
AS   
    SET NOCOUNT ON;  
    SELECT 'PROCEDURE', sp.BusinessEntityID, c.LastName,   
        sp.SalesYTD   
    FROM Sales.SalesPerson AS sp    
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.BusinessEntityID LIKE '2%'  
    ORDER BY sp.BusinessEntityID, c.LastName;  
GO  
--INSERT...SELECT example  
INSERT INTO dbo.EmployeeSales  
    SELECT 'SELECT', sp.BusinessEntityID, c.LastName, sp.SalesYTD   
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.BusinessEntityID LIKE '2%'  
    ORDER BY sp.BusinessEntityID, c.LastName;  
GO  
--INSERT...EXECUTE procedure example  
INSERT INTO dbo.EmployeeSales   
EXECUTE dbo.uspGetEmployeeSales;  
GO  
--INSERT...EXECUTE('string') example  
INSERT INTO dbo.EmployeeSales   
EXECUTE   
('  
SELECT ''EXEC STRING'', sp.BusinessEntityID, c.LastName,   
    sp.SalesYTD   
    FROM Sales.SalesPerson AS sp   
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.BusinessEntityID LIKE ''2%''  
    ORDER BY sp.BusinessEntityID, c.LastName  
');  
GO  
--Show results.  
SELECT DataSource,BusinessEntityID,LastName,SalesDollars  
FROM dbo.EmployeeSales;

I. Utilizzo dell'espressione di tabella comune WITH per la definizione dei dati inseriti

Nell'esempio seguente viene creata la NewEmployee tabella nel database AdventureWorks2022. Le righe di una o più tabelle da inserire nella tabella EmployeeTemp vengono definite tramite un'espressione di tabella comune (NewEmployee). L'istruzione INSERT fa riferimento alle colonne nell'espressione di tabella comune.

CREATE TABLE HumanResources.NewEmployee  
(  
    EmployeeID int NOT NULL,  
    LastName nvarchar(50) NOT NULL,  
    FirstName nvarchar(50) NOT NULL,  
    PhoneNumber Phone NULL,  
    AddressLine1 nvarchar(60) NOT NULL,  
    City nvarchar(30) NOT NULL,  
    State nchar(3) NOT NULL,   
    PostalCode nvarchar(15) NOT NULL,  
    CurrentFlag Flag  
);  
GO  
WITH EmployeeTemp (EmpID, LastName, FirstName, Phone,   
                   Address, City, StateProvince,   
                   PostalCode, CurrentFlag)  
AS (SELECT   
       e.BusinessEntityID, c.LastName, c.FirstName, pp.PhoneNumber,  
       a.AddressLine1, a.City, sp.StateProvinceCode,   
       a.PostalCode, e.CurrentFlag  
    FROM HumanResources.Employee e  
        INNER JOIN Person.BusinessEntityAddress AS bea  
        ON e.BusinessEntityID = bea.BusinessEntityID  
        INNER JOIN Person.Address AS a  
        ON bea.AddressID = a.AddressID  
        INNER JOIN Person.PersonPhone AS pp  
        ON e.BusinessEntityID = pp.BusinessEntityID  
        INNER JOIN Person.StateProvince AS sp  
        ON a.StateProvinceID = sp.StateProvinceID  
        INNER JOIN Person.Person as c  
        ON e.BusinessEntityID = c.BusinessEntityID  
    )  
INSERT INTO HumanResources.NewEmployee   
    SELECT EmpID, LastName, FirstName, Phone,   
           Address, City, StateProvince, PostalCode, CurrentFlag  
    FROM EmployeeTemp;  
GO

J. Utilizzo della clausola TOP per limitare i dati inseriti dalla tabella di origine

Nell'esempio seguente viene creata la tabella EmployeeSales e vengono inseriti i dati relativi al nome e alle vendite annuali per i primi 5 dipendenti casuali della tabella HumanResources.Employee nel database AdventureWorks2022. L'istruzione INSERT sceglie 5 righe qualsiasi tra quelle restituite dall'istruzione SELECT. La clausola OUTPUT consente di visualizzare le righe inserite nella tabella EmployeeSales. Si noti che la clausola ORDER BY nell'istruzione SELECT non viene utilizzata per determinare i primi 5 dipendenti.

CREATE TABLE dbo.EmployeeSales  
( EmployeeID   nvarchar(11) NOT NULL,  
  LastName     nvarchar(20) NOT NULL,  
  FirstName    nvarchar(20) NOT NULL,  
  YearlySales  money NOT NULL  
 );  
GO  
INSERT TOP(5)INTO dbo.EmployeeSales  
    OUTPUT inserted.EmployeeID, inserted.FirstName, 
        inserted.LastName, inserted.YearlySales  
    SELECT sp.BusinessEntityID, c.LastName, c.FirstName, sp.SalesYTD   
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.SalesYTD > 250000.00  
    ORDER BY sp.SalesYTD DESC;

Se è necessario utilizzare TOP per inserire righe in un ordine cronologico significativo, è necessario utilizzare questa clausola insieme a ORDER BY in un'istruzione sub-SELECT, come illustrato nell'esempio seguente. La clausola OUTPUT consente di visualizzare le righe inserite nella tabella EmployeeSales. Si noti che i primi 5 dipendenti vengono ora inseriti in base ai risultati della clausola ORDER BY anziché alle righe casuali.

INSERT INTO dbo.EmployeeSales  
    OUTPUT inserted.EmployeeID, inserted.FirstName, 
        inserted.LastName, inserted.YearlySales  
    SELECT TOP (5) sp.BusinessEntityID, c.LastName, c.FirstName, sp.SalesYTD   
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.SalesYTD > 250000.00  
    ORDER BY sp.SalesYTD DESC;

Specifica di oggetti di destinazione diversi dalle tabelle standard

Negli esempi contenuti in questa sezione viene illustrato come inserire righe specificando una vista o una variabile di tabella.

K. Inserimento di dati specificando una vista

Nell'esempio seguente viene specificato il nome di una vista come oggetto di destinazione. La nuova riga, tuttavia, viene inserita nella tabella di base sottostante. L'ordine dei valori nell'istruzione INSERT deve corrispondere all'ordine delle colonne della vista. Per altre informazioni, vedere Modificare i dati tramite una vista.

CREATE TABLE T1 ( column_1 int, column_2 varchar(30));  
GO  
CREATE VIEW V1 AS   
SELECT column_2, column_1   
FROM T1;  
GO  
INSERT INTO V1   
    VALUES ('Row 1',1);  
GO  
SELECT column_1, column_2   
FROM T1;  
GO  
SELECT column_1, column_2  
FROM V1;  
GO

.L Inserimento di dati in una variabile di tabella

Nell'esempio seguente viene specificata una variabile di tabella come oggetto di destinazione nel database AdventureWorks2022.

-- Create the table variable.  
DECLARE @MyTableVar table(  
    LocationID int NOT NULL,  
    CostRate smallmoney NOT NULL,  
    NewCostRate AS CostRate * 1.5,  
    ModifiedDate datetime);  
  
-- Insert values into the table variable.  
INSERT INTO @MyTableVar (LocationID, CostRate, ModifiedDate)  
    SELECT LocationID, CostRate, GETDATE() 
    FROM Production.Location  
    WHERE CostRate > 0;  
  
-- View the table variable result set.  
SELECT * FROM @MyTableVar;  
GO

Inserimento di righe in una tabella remota

Gli esempi di questa sezione illustrano come inserire righe in una tabella di destinazione remota tramite un server collegato o una funzione per i set di righe per fare riferimento alla tabella remota.

M. Inserimento di dati in una tabella remota tramite un server collegato

Nell'esempio seguente vengono inserite righe in una tabella remota. L'esempio inizia con la creazione di un collegamento all'origine dati remota tramite sp_addlinkedserver. Il nome del server collegato, MyLinkServer, viene specificato come parte del nome di oggetto in quattro parti nel formato server.catalogo.schema.oggetto.

Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

USE master;  
GO  
-- Create a link to the remote data source.   
-- Specify a valid server name for @datasrc as 'server_name' 
-- or 'server_nameinstance_name'.  
  
EXEC sp_addlinkedserver @server = N'MyLinkServer',  
    @srvproduct = N' ',  
    @provider = N'SQLNCLI',   
    @datasrc = N'server_name',  
    @catalog = N'AdventureWorks2022';  
GO

-- Specify the remote data source in the FROM clause using a four-part name   
-- in the form linked_server.catalog.schema.object.  
  
INSERT INTO MyLinkServer.AdventureWorks2022.HumanResources.Department (Name, GroupName)  
VALUES (N'Public Relations', N'Executive General and Administration');  
GO

N. Inserimento di dati in una tabella remota tramite una funzione OPENQUERY

L'esempio seguente inserisce una riga in una tabella remota specificando la funzione per i set di righe OPENQUERY. Viene utilizzato il nome del server collegato creato nell'esempio precedente.

Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

INSERT OPENQUERY (MyLinkServer, 
    'SELECT Name, GroupName 
     FROM AdventureWorks2022.HumanResources.Department')  
VALUES ('Environmental Impact', 'Engineering');  
GO

.O Inserimento di dati in una tabella remota tramite una funzione OPENDATASOURCE

L'esempio seguente inserisce una riga in una tabella remota tramite la funzione per i set di righe OPENDATASOURCE. Specificare un nome server valido per l'origine dati usando il formato nome_server oppure nome_server\nome_istanza.

Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

-- Use the OPENDATASOURCE function to specify the remote data source.  
-- Specify a valid server name for Data Source using the format 
-- server_name or server_nameinstance_name.  
  
INSERT INTO OPENDATASOURCE('SQLNCLI',  
    'Data Source= <server_name>; Integrated Security=SSPI')  
    .AdventureWorks2022.HumanResources.Department (Name, GroupName)  
    VALUES (N'Standards and Methods', 'Quality Assurance');  
GO

P. Inserimento in una tabella esterna creata con PolyBase

Esportare dati da SQL Server in Hadoop o Archiviazione di Azure. Prima di tutto creare una tabella esterna che punta al file o alla directory di destinazione. Usare quindi INSERT INTO per esportare i dati da una tabella di SQL Server locale a un'origine dati esterna. L'istruzione INSERT INTO crea il file o la directory di destinazione, se non esiste, e i risultati dell'istruzione SELECT vengono esportati nel percorso specificato nel formato di file specificato. Per altre informazioni, vedere Get started with PolyBase(Introduzione a PolyBase).

Si applica a: SQL Server.

-- Create an external table.   
CREATE EXTERNAL TABLE [dbo].[FastCustomers2009] (  
        [FirstName] char(25) NOT NULL,   
        [LastName] char(25) NOT NULL,   
        [YearlyIncome] float NULL,   
        [MaritalStatus] char(1) NOT NULL  
)  
WITH (  
        LOCATION='/old_data/2009/customerdata.tbl',  
        DATA_SOURCE = HadoopHDP2,  
        FILE_FORMAT = TextFileFormat,  
        REJECT_TYPE = VALUE,  
        REJECT_VALUE = 0  
);  
  
-- Export data: Move old data to Hadoop while keeping 
-- it query-able via external table.  

INSERT INTO dbo.FastCustomer2009  
SELECT T.* FROM Insured_Customers T1 JOIN CarSensor_Data T2  
ON (T1.CustomerKey = T2.CustomerKey)  
WHERE T2.YearMeasured = 2009 and T2.Speed > 40;

Caricamento bulk di dati da tabelle o file di dati

Negli esempi di questa sezione vengono illustrati due metodi per eseguire il caricamento bulk dei dati in una tabella tramite l'istruzione INSERT.

D. Inserimento di dati in un heap con registrazione minima

Nell'esempio seguente viene creata una nuova tabella (heap) in cui vengono inseriti dati da un'altra tabella con registrazione minima. L'esempio presuppone che il modello di recupero del database AdventureWorks2022 sia impostato su FULL. Per assicurare l'uso della registrazione minima, il modello di recupero del database AdventureWorks2022 viene impostato su BULK_LOGGED prima che le righe vengano inserite e reimpostato su FULL dopo l'istruzione INSERT INTO...SELECT. Inoltre, viene specificato l'hint TABLOCK per la tabella di destinazione Sales.SalesHistory. In tal modo, si assicura l'utilizzo da parte dell'istruzione di uno spazio minimo nel log delle transazioni con risultati efficienti.

-- Create the target heap.  
CREATE TABLE Sales.SalesHistory(  
    SalesOrderID int NOT NULL,  
    SalesOrderDetailID int NOT NULL,  
    CarrierTrackingNumber nvarchar(25) NULL,  
    OrderQty smallint NOT NULL,  
    ProductID int NOT NULL,  
    SpecialOfferID int NOT NULL,  
    UnitPrice money NOT NULL,  
    UnitPriceDiscount money NOT NULL,  
    LineTotal money NOT NULL,  
    rowguid uniqueidentifier ROWGUIDCOL  NOT NULL,  
    ModifiedDate datetime NOT NULL );  
GO  
-- Temporarily set the recovery model to BULK_LOGGED.  
ALTER DATABASE AdventureWorks2022  
SET RECOVERY BULK_LOGGED;  
GO  
-- Transfer data from Sales.SalesOrderDetail to Sales.SalesHistory  
INSERT INTO Sales.SalesHistory WITH (TABLOCK)  
    (SalesOrderID,   
     SalesOrderDetailID,  
     CarrierTrackingNumber,   
     OrderQty,   
     ProductID,   
     SpecialOfferID,   
     UnitPrice,   
     UnitPriceDiscount,  
     LineTotal,   
     rowguid,   
     ModifiedDate)  
SELECT * FROM Sales.SalesOrderDetail;  
GO  
-- Reset the recovery model.  
ALTER DATABASE AdventureWorks2022  
SET RECOVERY FULL;  
GO

.R Utilizzo della funzione OPENROWSET con BULK per eseguire il caricamento bulk dei dati in una tabella

Nell'esempio seguente vengono inserite righe da un file di dati in una tabella specificando la funzione OPENROWSET. Per l'ottimizzazione delle prestazioni, viene specificato l'hint di tabella IGNORE_TRIGGERS. Per altri esempi, vedere Importazione di dati per operazioni bulk con BULK INSERT o OPENROWSET(BULK...) (SQL Server).

Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

INSERT INTO HumanResources.Department WITH (IGNORE_TRIGGERS) (Name, GroupName)  
SELECT b.Name, b.GroupName   
FROM OPENROWSET (  
    BULK 'C:SQLFilesDepartmentData.txt',  
    FORMATFILE = 'C:SQLFilesBulkloadFormatFile.xml',  
    ROWS_PER_BATCH = 15000)AS b ;

Override del comportamento predefinito di Query Optimizer tramite hint

Gli esempi contenuti in questa sezione illustrano come usare gli hint di tabella per eseguire temporaneamente l'override del comportamento predefinito di Query Optimizer durante l'elaborazione dell'istruzione INSERT.

Attenzione

Poiché Query Optimizer di SQL Server seleziona in genere il piano di esecuzione migliore per una query, gli hint devono essere usati solo se strettamente necessari ed esclusivamente da sviluppatori e amministratori di database esperti.

S. Utilizzo dell'hint TABLOCK per specificare un metodo di blocco

Nell'esempio seguente viene impostata l'acquisizione di un blocco esclusivo (X) sulla tabella Production.Location. Tale blocco viene mantenuto attivo fino al termine dell'istruzione INSERT.

Si applica a: SQL Server, database SQL.

INSERT INTO Production.Location WITH (XLOCK)  
(Name, CostRate, Availability)  
VALUES ( N'Final Inventory', 15.00, 80.00);

Acquisizione dei risultati dell'istruzione INSERT

Gli esempi contenuti in questa sezione illustrano come usare la clausola OUTPUT per restituire informazioni da (o espressioni basate su) ogni riga interessata da un'istruzione INSERT. Questi risultati possono essere restituiti all'applicazione di elaborazione per l'utilizzo nei messaggi di errore, l'archiviazione e altri scopi simili dell'applicazione.

T. Uso della clausola OUTPUT con un'istruzione INSERT

Nell'esempio seguente viene inserita una riga nella tabella ScrapReason e viene utilizzata la clausola OUTPUT per restituire i risultati dell'istruzione alla variabile di tabella @MyTableVar. Poiché la colonna ScrapReasonID è definita con una proprietà IDENTITY, per tale colonna non viene specificato un valore nell'istruzione INSERT. Si noti tuttavia che il valore generato dal motore di database per tale colonna viene restituito nella clausola OUTPUT nella colonna INSERTED.ScrapReasonID.

DECLARE @MyTableVar table( NewScrapReasonID smallint,  
                           Name varchar(50),  
                           ModifiedDate datetime);  
INSERT Production.ScrapReason  
    OUTPUT INSERTED.ScrapReasonID, INSERTED.Name, INSERTED.ModifiedDate  
        INTO @MyTableVar  
VALUES (N'Operator error', GETDATE());  
  
--Display the result set of the table variable.  
SELECT NewScrapReasonID, Name, ModifiedDate FROM @MyTableVar;  
--Display the result set of the table.  
SELECT ScrapReasonID, Name, ModifiedDate   
FROM Production.ScrapReason;

U. Utilizzo della clausola OUTPUT con colonne Identity e calcolate

Nell'esempio seguente viene creata la tabella EmployeeSales in cui vengono quindi inserite diverse righe tramite un'istruzione INSERT con un'istruzione SELECT per il recupero dei dati dalle tabelle di origine. La tabella EmployeeSales include una colonna Identity (EmployeeID) e una colonna calcolata (ProjectedSales). Poiché questi valori vengono generati dal motore di database durante l'operazione di inserimento, nessuna di queste colonne può essere definita in @MyTableVar.

CREATE TABLE dbo.EmployeeSales  
( EmployeeID   int IDENTITY (1,5)NOT NULL,  
  LastName     nvarchar(20) NOT NULL,  
  FirstName    nvarchar(20) NOT NULL,  
  CurrentSales money NOT NULL,  
  ProjectedSales AS CurrentSales * 1.10   
);  
GO  
DECLARE @MyTableVar table(  
  LastName     nvarchar(20) NOT NULL,  
  FirstName    nvarchar(20) NOT NULL,  
  CurrentSales money NOT NULL  
  );  
  
INSERT INTO dbo.EmployeeSales (LastName, FirstName, CurrentSales)  
  OUTPUT INSERTED.LastName,   
         INSERTED.FirstName,   
         INSERTED.CurrentSales  
  INTO @MyTableVar  
    SELECT c.LastName, c.FirstName, sp.SalesYTD  
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.BusinessEntityID LIKE '2%'  
    ORDER BY c.LastName, c.FirstName;  
  
SELECT LastName, FirstName, CurrentSales  
FROM @MyTableVar;  
GO  
SELECT EmployeeID, LastName, FirstName, CurrentSales, ProjectedSales  
FROM dbo.EmployeeSales;

V. Inserimento dei dati restituiti da una clausola OUTPUT

Nell'esempio seguente vengono acquisiti i dati restituiti dalla clausola OUTPUT di un'istruzione MERGE e tali dati vengono inseriti in un'altra tabella. L'istruzione MERGE aggiorna quotidianamente la Quantity colonna della ProductInventory tabella in base agli ordini elaborati nella SalesOrderDetail tabella nel database AdventureWorks2022. Vengono inoltre eliminate le righe dei prodotti le cui scorte vengono azzerate. In questo esempio vengono acquisite le righe eliminate, che vengono inserite in un'altra tabella, ZeroInventory, in cui viene tenuta traccia dei prodotti senza scorte.

--Create ZeroInventory table.  
CREATE TABLE Production.ZeroInventory (DeletedProductID int, RemovedOnDate DateTime);  
GO  
  
INSERT INTO Production.ZeroInventory (DeletedProductID, RemovedOnDate)  
SELECT ProductID, GETDATE()  
FROM  
(   MERGE Production.ProductInventory AS pi  
    USING (SELECT ProductID, SUM(OrderQty) FROM Sales.SalesOrderDetail AS sod  
           JOIN Sales.SalesOrderHeader AS soh  
           ON sod.SalesOrderID = soh.SalesOrderID  
           AND soh.OrderDate = '20070401'  
           GROUP BY ProductID) AS src (ProductID, OrderQty)  
    ON (pi.ProductID = src.ProductID)  
    WHEN MATCHED AND pi.Quantity - src.OrderQty <= 0  
        THEN DELETE  
    WHEN MATCHED  
        THEN UPDATE SET pi.Quantity = pi.Quantity - src.OrderQty  
    OUTPUT $action, deleted.ProductID) AS Changes (Action, ProductID)  
WHERE Action = 'DELETE';  
IF @@ROWCOUNT = 0  
PRINT 'Warning: No rows were inserted';  
GO  
SELECT DeletedProductID, RemovedOnDate FROM Production.ZeroInventory;

W. Inserimento di dati tramite l'opzione SELECT

L'esempio seguente illustra come inserire più righe di dati tramite un'istruzione INSERT con un'opzione SELECT. La prima istruzione INSERT usa direttamente un'istruzione SELECT per recuperare i dati dalla tabella di origine e quindi archiviare il set di risultati nella tabellaEmployeeTitles.

CREATE TABLE EmployeeTitles  
( EmployeeKey   INT NOT NULL,  
  LastName     varchar(40) NOT NULL,  
  Title      varchar(50) NOT NULL  
);  
INSERT INTO EmployeeTitles  
    SELECT EmployeeKey, LastName, Title   
    FROM ssawPDW.dbo.DimEmployee  
    WHERE EndDate IS NULL;

X. Indicazione di un'etichetta con l'istruzione INSERT

L'esempio seguente illustra l'uso di un'etichetta con un'istruzione INSERT.

-- Uses AdventureWorks  
  
INSERT INTO DimCurrency   
VALUES (500, N'C1', N'Currency1')  
OPTION ( LABEL = N'label1' );

Y. Uso di un'etichetta e di un hint per la query con l'istruzione INSERT

Questa query illustra la sintassi di base per l'uso di un'etichetta e di un hint di join per la query con l'istruzione INSERT. Dopo l'invio della query al nodo di controllo, SQL Server, in esecuzione nei nodi di calcolo, genera il piano di query di SQL Server applicando la strategia di hash join. Per altre informazioni sugli hint di join e su come usare la clausola OPTION, vedere OPTION (SQL Server PDW).

-- Uses AdventureWorks  
  
INSERT INTO DimCustomer (CustomerKey, CustomerAlternateKey, 
    FirstName, MiddleName, LastName )   
SELECT ProspectiveBuyerKey, ProspectAlternateKey, 
    FirstName, MiddleName, LastName  
FROM ProspectiveBuyer p JOIN DimGeography g ON p.PostalCode = g.PostalCode  
WHERE g.CountryRegionCode = 'FR'  
OPTION ( LABEL = 'Add French Prospects', HASH JOIN);

Vedi anche

BULK INSERT (Transact-SQL)
DELETE (Transact-SQL)
EXECUTE (Transact-SQL)
FROM (Transact-SQL)
IDENTITY (proprietà) (Transact-SQL)
NEWID (Transact-SQL)
SELECT (Transact-SQL)
UPDATE (Transact-SQL)
MERGE (Transact-SQL)
Clausola OUTPUT (Transact-SQL)
Usare le tabelle inserite ed eliminate

Condividi tramite

INSERT (Transact-SQL)

Sintassi

Argomenti

Osservazioni:

Consigli per iniziare

Procedure consigliate per l'importazione bulk di dati

Uso di INSERT INTO...SELECT per eseguire l'importazione bulk dei dati con registrazione minima e parallelismo

Uso di OPENROWSET e BULK per l'importazione bulk dei dati

Tipi di dati

Inserimento di valori in colonne di tipo definito dall'utente

Gestione errori

Interoperabilità

Limitazioni e restrizioni

Comportamento di registrazione

Sicurezza

Autorizzazioni

Esempi

Sintassi di base

R. Inserimento di una sola riga di dati

B. Inserimento di più righe di dati

C. Inserimento di dati in un ordine diverso rispetto alle colonne della tabella

Gestione dei valori delle colonne

D. Inserimento di dati in una tabella con colonne che presentano valori predefiniti

E. Inserimento di dati in una tabella con una colonna Identity

F. Inserimento di dati in una colonna uniqueidentifier tramite NEWID()

G. Inserimento di dati in colonne di tipo definito dall'utente

Inserimento di dati da altre tabelle

H. Utilizzo delle opzioni SELECT ed EXECUTE per inserire dati da altre tabelle

I. Utilizzo dell'espressione di tabella comune WITH per la definizione dei dati inseriti

J. Utilizzo della clausola TOP per limitare i dati inseriti dalla tabella di origine

Specifica di oggetti di destinazione diversi dalle tabelle standard

K. Inserimento di dati specificando una vista

.L Inserimento di dati in una variabile di tabella

Inserimento di righe in una tabella remota

M. Inserimento di dati in una tabella remota tramite un server collegato

N. Inserimento di dati in una tabella remota tramite una funzione OPENQUERY

.O Inserimento di dati in una tabella remota tramite una funzione OPENDATASOURCE

P. Inserimento in una tabella esterna creata con PolyBase

Caricamento bulk di dati da tabelle o file di dati

D. Inserimento di dati in un heap con registrazione minima

.R Utilizzo della funzione OPENROWSET con BULK per eseguire il caricamento bulk dei dati in una tabella

Override del comportamento predefinito di Query Optimizer tramite hint

S. Utilizzo dell'hint TABLOCK per specificare un metodo di blocco

Acquisizione dei risultati dell'istruzione INSERT

T. Uso della clausola OUTPUT con un'istruzione INSERT

U. Utilizzo della clausola OUTPUT con colonne Identity e calcolate

V. Inserimento dei dati restituiti da una clausola OUTPUT

W. Inserimento di dati tramite l'opzione SELECT

X. Indicazione di un'etichetta con l'istruzione INSERT

Y. Uso di un'etichetta e di un hint per la query con l'istruzione INSERT

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive