ALTER SEQUENCE (Transact-SQL)
Si applica a:
SQL Server database SQL di Azure Istanza gestita di SQL di Azure
Modifica gli argomenti di un oggetto sequenza esistente. Se la sequenza è stata creata con l'opzione CACHE, la modifica della sequenza comporta la ricreazione della cache.
Gli oggetti sequenza vengono creati tramite l'istruzione CREATE SEQUENCE. Le sequenze sono valori interi e possono essere di qualsiasi tipo di dati in grado di restituire un intero. Non è possibile modificare il tipo di dati tramite l'istruzione ALTER SEQUENCE. Per modificare il tipo di dati, eliminare e ricreare l'oggetto sequenza.
Una sequenza è un oggetto associato a schema definito dall'utente che genera una sequenza di valori numerici in base a una specifica. Si generano nuovi valori da una sequenza chiamando la funzione NEXT VALUE FOR. Usare sp_sequence_get_range per ottenere immediatamente più numeri di sequenza. Per informazioni e scenari in cui vengono usate le istruzioni CREATE SEQUENCE, sp_sequence_get_range e la funzione NEXT VALUE FOR, vedere Numeri di sequenza.
Convenzioni di sintassi Transact-SQL
Sintassi
ALTER SEQUENCE [schema_name. ] sequence_name
[ RESTART [ WITH <constant> ] ]
[ INCREMENT BY <constant> ]
[ { MINVALUE <constant> } | { NO MINVALUE } ]
[ { MAXVALUE <constant> } | { NO MAXVALUE } ]
[ CYCLE | { NO CYCLE } ]
[ { CACHE [ <constant> ] } | { NO CACHE } ]
[ ; ]
Nota
Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.
Argomenti
sequence_name
Specifica il nome univoco con il quale è nota la sequenza nel database. Il tipo è sysname.
RESTART [ WITH <constant> ]
Valore successivo che verrà restituito dall'oggetto sequenza. Se specificato, il valore RESTART WITH deve essere un numero intero minore o uguale al valore massimo e maggiore o uguale al valore minimo dell'oggetto sequenza. Se il valore WITH viene omesso, la numerazione della sequenza ricomincia in base alle opzioni CREATE SEQUENCE originali.
INCREMENT BY <constant>
Valore usato per incrementare (o diminuire, in caso di valore negativo) il valore di base dell'oggetto sequenza per ogni chiamata alla funzione NEXT VALUE FOR. Se l'incremento è un valore negativo, l'oggetto sequenza ha un ordine decrescente, in caso contrario avrà un ordine crescente. L'incremento non può essere 0.
[ MINVALUE <constant> | NO MINVALUE ]
Specifica i limiti per l'oggetto sequenza. Se viene specificato NO MINVALUE, viene utilizzato il valore possibile minimo del tipo di dati della sequenza.
[ MAXVALUE <constant> | NO MAXVALUE
Specifica i limiti per l'oggetto sequenza. Se viene specificato NO MAXVALUE, viene utilizzato il valore possibile massimo del tipo di dati della sequenza.
[ CYCLE | NO CYCLE ]
Questa proprietà specifica se l'oggetto sequenza deve riprendere dal valore minimo (o massimo per gli oggetti sequenza con ordine decrescente) o generare un'eccezione quando viene superato il valore massimo o minimo.
Nota
Dopo la ripresa del ciclo, il valore successivo sarà il valore minimo o massimo, non il valore START VALUE della sequenza.
[ CACHE [<constant> ] | NO CACHE ]
Migliora le prestazioni delle applicazioni che utilizzano gli oggetti sequenza riducendo il numero di I/O necessari per rendere persistenti i valori generati nelle tabelle di sistema.
Per altre informazioni sul comportamento della cache, vedere CREATE SEQUENCE (Transact-SQL).
Osservazioni:
Per informazioni sulla creazione delle sequenze e sulla gestione della cache delle sequenze, vedere CREATE SEQUENCE (Transact-SQL).
Non è possibile modificare MINVALUE per le sequenze con ordine crescente e MAXVALUE per le sequenze con ordine decrescente in un valore che non consente il valore START WITH della sequenza. Per modificare MINVALUE per una sequenza con ordine crescente in un numero maggiore del valore START WITH o per modificare MAXVALUE di una sequenza con ordine decrescente in un numero più piccolo del valore START WITH, includere l'argomento RESTART WITH per riprendere la sequenza in un punto desiderato compreso nell'intervallo minimo e massimo.
Metadati UFX
Per informazioni sulle sequenze, eseguire una query su sys.sequences.
Sicurezza
Autorizzazioni
È necessaria l'autorizzazione ALTER per la sequenza o ALTER per lo schema. Per concedere l'autorizzazione ALTER per la sequenza, usare ALTER ON OBJECT nel formato seguente:
GRANT ALTER ON OBJECT::Test.TinySeq TO [AdventureWorks\Larry]
È possibile trasferire la proprietà di un oggetto sequenza tramite l'istruzione ALTER AUTHORIZATION.
Audit
Per controllare ALTER SEQUENCE, monitorare SCHEMA_OBJECT_CHANGE_GROUP.
Esempi
Per esempi relativi alla creazione di sequenze e all'uso della funzione NEXT VALUE FOR per generare numeri di sequenza, vedere Numeri di sequenza.
R. Alterazione di una sequenza
Nell'esempio seguente vengono creati uno schema denominato Test e una sequenza denominata TestSeq usando il tipo di dati int, con un intervallo di valori compreso tra 100 e 200. La sequenza inizia con 125 e aumenta di 25 ogni volta che viene generato un numero. Poiché la sequenza è configurata per la ripresa del ciclo quando il valore supera il valore massimo di 200, la sequenza riprende dal valore minimo di 100.
CREATE SCHEMA Test ;
GO
CREATE SEQUENCE Test.TestSeq
AS int
START WITH 125
INCREMENT BY 25
MINVALUE 100
MAXVALUE 200
CYCLE
CACHE 3
;
GO
Nell'esempio seguente la sequenza TestSeq viene modificata in modo da avere un intervallo di valori compreso tra 50 e 200. La sequenza riavvia la serie di numerazione con 100 e aumenta di 50 ogni volta che viene generato un numero.
ALTER SEQUENCE Test. TestSeq
RESTART WITH 100
INCREMENT BY 50
MINVALUE 50
MAXVALUE 200
NO CYCLE
NO CACHE
;
GO
Poiché la sequenza non viene ripresa, la funzione NEXT VALUE FOR genererà un errore quando la sequenza supererà 200.
B. Riavvio di una sequenza
Nell'esempio seguente viene creata una sequenza denominata CountBy1. La sequenza utilizza i valori predefiniti.
CREATE SEQUENCE Test.CountBy1 ;
Per generare un valore di sequenza, il proprietario esegue l'istruzione seguente:
SELECT NEXT VALUE FOR Test.CountBy1
Il valore restituito -9.223.372.036.854.775.808 è il valore più piccolo possibile per il tipo di dati bigint. Il proprietario voleva che la sequenza iniziasse con 1, ma non ha indicato la clausola START WITH quando ha creato la sequenza. Per risolvere l'errore, il proprietario esegue l'istruzione seguente.
ALTER SEQUENCE Test.CountBy1 RESTART WITH 1 ;
Il proprietario riesegue quindi l'istruzione seguente per generare un numero di sequenza.
SELECT NEXT VALUE FOR Test.CountBy1;
Il numero è ora 1, come previsto.
La sequenza CountBy1 è stata creata usando il valore predefinito di NO CYCLE, pertanto si arresterà dopo avere generato il numero 9.223.372.036.854.775.807. Le chiamate successive all'oggetto sequenza restituiranno l'errore 11728. Nell'istruzione seguente viene modificato l'oggetto sequenza in modo che venga ripreso il ciclo e viene impostata una cache di 20.
ALTER SEQUENCE Test.CountBy1
CYCLE
CACHE 20 ;
Quando l'oggetto sequenza raggiunge 9.223.372.036.854.775.807 il ciclo viene ripreso e il numero successivo dopo la ripresa del ciclo sarà il minimo del tipo di dati, ovvero -9.223.372.036.854.775.808.
Il proprietario nota che il tipo di dati bigint usa 8 byte ogni volta che viene impiegato. Il tipo di dati int che usa 4 byte è sufficiente. Non è tuttavia possibile modificare il tipo di dati di un oggetto sequenza. Per modificare un tipo di dati int, il proprietario deve eliminare l'oggetto sequenza e ricrearlo con il tipo di dati corretto.
Vedi anche
CREATE edizione Standard QUENCE (Transact-SQL)
DROP edizione Standard QUENCE (Transact-SQL)
NEXT VALUE FOR (Transact-SQL)
Numeri di sequenza
sp_sequence_get_range (Transact-SQL)
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per