Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CREATE SEQUENCE

CREATE SEQUENCE— definire un nuovo generatore di sequenze.

Sintassi supportata

CREATE SEQUENCE [ IF NOT EXISTS ] name CACHE cache
    [ AS data_type ]
    [ INCREMENT [ BY ] increment ]
    [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ]
    [ [ NO ] CYCLE ]
    [ START [ WITH ] start ]
    [ OWNED BY { table_name.column_name | NONE } ]

where data_type is BIGINT
      and cache = 1 or cache >= 65536

Description

CREATE SEQUENCEcrea un nuovo generatore di numeri di sequenza. Ciò comporta la creazione e l'inizializzazione di una nuova tabella speciale a riga singola con il nome. name Il generatore sarà di proprietà dell'utente che emette il comando.

Se viene fornito un nome di schema, la sequenza viene creata nello schema specificato. Altrimenti viene creata nello schema corrente. Il nome della sequenza deve essere distinto dal nome di qualsiasi altra relazione (tabella, sequenza, indice, vista, vista materializzata o tabella esterna) nello stesso schema.

Dopo aver creato una sequenza, è possibile utilizzare le funzioni nextval e setval operare sulla sequenza. currval Queste funzioni sono documentate inFunzioni di manipolazione di sequenze.

Sebbene non sia possibile aggiornare direttamente una sequenza, è possibile utilizzare una query come:

SELECT * FROM name;

per esaminare alcuni parametri e lo stato corrente di una sequenza. In particolare, il last_value campo della sequenza mostra l'ultimo valore assegnato da ogni sessione. (Naturalmente, questo valore potrebbe essere obsoleto nel momento in cui viene stampato, se altre sessioni effettuano nextval chiamate attivamente.) Altri parametri come increment e maxvalue possono essere osservati nella pg_sequences vista.

Parameters

Note

Utilizzare DROP SEQUENCE per rimuovere una sequenza.

Le sequenze sono basate sull'bigintaritmetica, quindi l'intervallo non può superare l'intervallo di un numero intero di otto byte (da -9223372036854775808 a 9223372036854775807).

Poiché le chiamate e non vengono mai annullate, gli oggetti di sequenza non possono essere utilizzati se è necessaria l'assegnazione «senza interruzioni» dei numeri di sequenza. nextval setval

Ogni sessione allocherà e memorizzerà nella cache i valori di sequenza successivi durante un accesso all'oggetto sequenza e aumenterà di conseguenza quelli dell'oggetto sequenza. last_value Quindi, i successivi utilizzi cache -1 di nextval quella sessione restituiscono semplicemente i valori preallocati senza toccare l'oggetto della sequenza. Pertanto, tutti i numeri assegnati ma non utilizzati all'interno di una sessione andranno persi al termine di quella sessione, con conseguenti «buchi» nella sequenza.

Inoltre, sebbene sia garantito che più sessioni assegnino valori di sequenza distinti, i valori potrebbero essere generati in modo non sequenziale se si considerano tutte le sessioni. Ad esempio, con un'cacheimpostazione di 10, la sessione A potrebbe riservare i valori 1.. 10 e restituire nextval =1, quindi la sessione B potrebbe riservare i valori 11.. 20 e restituire nextval =11 prima che la sessione A abbia generato =2. nextval Pertanto, con un'cacheimpostazione pari a uno si può presumere che nextval i valori vengano generati in sequenza; con un'cacheimpostazione maggiore di uno si deve solo supporre che nextval i valori siano tutti distinti, non che vengano generati in modo puramente sequenziale. Inoltre, last_value rifletterà il valore più recente riservato da qualsiasi sessione, indipendentemente dal fatto che sia stato ancora restituito da. nextval

Un'altra considerazione è che un'setvalesecuzione su tale sequenza non verrà notata dalle altre sessioni finché non avranno esaurito i valori preallocati che hanno memorizzato nella cache.

Esempi

Create una sequenza crescente chiamataserial, a partire da 101:

CREATE SEQUENCE serial CACHE 65536 START 101;

Seleziona il numero successivo da questa sequenza:

SELECT nextval('serial');

 nextval
---------
     101

Seleziona il numero successivo da questa sequenza:

SELECT nextval('serial');

 nextval
---------
     102

Usa questa sequenza in un INSERT comando:

INSERT INTO distributors VALUES (nextval('serial'), 'nothing');

Reimposta la sequenza su un valore specifico utilizzandosetval:

SELECT setval('serial', 200);
SELECT nextval('serial');

 nextval
---------
     201

Compatibilità

CREATE SEQUENCEè conforme allo standard SQL, con le seguenti eccezioni: