Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CREATE SEQUENCE

CREATE SEQUENCE— definiere einen neuen Sequenzgenerator.

Unterstützte Syntax

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 SEQUENCEerstellt einen neuen Sequenznummerngenerator. Dies beinhaltet das Erstellen und Initialisieren einer neuen speziellen einzeiligen Tabelle mit dem Namen. name Der Generator wird dem Benutzer gehören, der den Befehl ausgibt.

Wenn ein Schemaname angegeben wird, wird die Sequenz im angegebenen Schema erstellt. Andernfalls wird sie im aktuellen Schema erstellt. Der Sequenzname muss sich vom Namen jeder anderen Relation (Tabelle, Sequenz, Index, Ansicht, materialisierte Ansicht oder Fremdtabelle) im selben Schema unterscheiden.

Nachdem eine Sequenz erstellt wurde, verwenden Sie die Funktionennextval, undcurrval, setval um die Sequenz zu bearbeiten. Diese Funktionen sind in dokumentiertSequenz-Bearbeitungsfunktionen.

Sie können eine Sequenz zwar nicht direkt aktualisieren, aber Sie können eine Abfrage wie die folgende verwenden:

SELECT * FROM name;

um einige Parameter und den aktuellen Status einer Sequenz zu untersuchen. Insbesondere zeigt das last_value Feld der Sequenz den letzten Wert an, der von einer Sitzung zugewiesen wurde. (Natürlich kann dieser Wert zum Zeitpunkt der Ausgabe veraltet sein, wenn andere Sitzungen aktiv nextval Aufrufe ausführen.) Andere Parameter wie increment und maxvalue können in der pg_sequences Ansicht beobachtet werden.

Parameters

Hinweise

Wird verwendetDROP SEQUENCE, um eine Sequenz zu entfernen.

Sequenzen basieren auf bigint Arithmetik, sodass der Bereich den Bereich einer 8-Byte-Ganzzahl (-9223372036854775808 bis 9223372036854775807) nicht überschreiten darf.

Da Aufrufe niemals rückgängig gemacht werden, können Sequenzobjekte nicht verwendet werden, wenn eine „lückenlose“ nextval Zuweisung setval von Sequenznummern erforderlich ist.

In jeder Sitzung werden aufeinanderfolgende Sequenzwerte während eines Zugriffs auf das Sequenzobjekt zugewiesen und zwischengespeichert und die Werte des Sequenzobjekts entsprechend erhöht. last_value Bei den nächsten cache -1 Verwendungen von nextval innerhalb dieser Sitzung werden dann einfach die vorab zugewiesenen Werte zurückgegeben, ohne das Sequenzobjekt zu berühren. Somit gehen alle innerhalb einer Sitzung zugewiesenen, aber nicht verwendeten Zahlen verloren, wenn die Sitzung endet, was zu „Löchern“ in der Sequenz führt.

Darüber hinaus wird zwar garantiert, dass mehreren Sitzungen unterschiedliche Sequenzwerte zugewiesen werden, die Werte können jedoch bei der Berücksichtigung aller Sitzungen nicht in der richtigen Reihenfolge generiert werden. Bei einer cache Einstellung von 10 könnte Sitzung A beispielsweise die Werte 1.. 10 reservieren und nextval =1 zurückgeben, dann könnte Sitzung B die Werte 11.. 20 reservieren und =11 zurückgeben, bevor Sitzung A nextval =2 generiert hat. nextval Bei einer cache Einstellung von eins kann man also davon ausgehen, dass nextval Werte sequentiell generiert werden. Bei einer cache Einstellung größer als eins sollten Sie nur davon ausgehen, dass die nextval Werte alle unterschiedlich sind, nicht dass sie rein sequentiell generiert werden. Außerdem last_value wird der letzte Wert wiedergegeben, der für eine Sitzung reserviert wurde, unabhängig davon, ob er noch von zurückgegeben wurde oder nicht. nextval

Eine weitere Überlegung ist, dass ein in einer solchen Sequenz setval ausgeführter Vorgang von anderen Sitzungen erst bemerkt wird, wenn sie alle vorab zugewiesenen Werte aufgebraucht haben, die sie zwischengespeichert haben.

Beispiele

Erstellen Sie eine aufsteigende Sequenz mit dem Namenserial, beginnend bei 101:

CREATE SEQUENCE serial CACHE 65536 START 101;

Wählen Sie die nächste Zahl aus dieser Sequenz aus:

SELECT nextval('serial');

 nextval
---------
     101

Wählen Sie die nächste Zahl aus dieser Sequenz aus:

SELECT nextval('serial');

 nextval
---------
     102

Verwenden Sie diese Sequenz in einem INSERT Befehl:

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

Setzen Sie die Sequenz auf einen bestimmten Wert zurück, indem Siesetval:

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

 nextval
---------
     201

Kompatibilität

CREATE SEQUENCEentspricht dem SQL-Standard, mit den folgenden Ausnahmen: