FirebirdSQL logo
 FILTEREXCEPTION 

CREATE OR ALTER SEQUENCE

Verwendet für

Erstellen einer neuen oder Ändern einer bestehenden Sequenz

Verfügbar in

DSQL, ESQL

Syntax
CREATE OR ALTER {SEQUENCE | GENERATOR} seq_name
  {RESTART | START WITH start_value}
  [INCREMENT [BY] increment]
Table 1. CREATE OR ALTER SEQUENCE-Anweisungsparameter
Parameter Beschreibung

seq_name

Name der Sequenz (Generator).Diese kann aus bis zu 63 Zeichen bestehen

start_value

Anfangswert der Sequenz.Standard ist 1

increment

Erhöhen der Sequenz (bei Verwendung von NEXT VALUE FOR seq_name);kann nicht 0 sein.Standard ist 1.

Wenn die Sequenz nicht existiert, wird sie erstellt.Eine bestehende Sequenz wird geändert:

  • Wenn RESTART angegeben ist, wird die Sequenz mit dem in den Metadaten gespeicherten Anfangswert neu gestartet

  • Wenn die START WITH-Klausel angegeben ist, wird die Sequenz mit start_value neu gestartet, aber der start_value wird nicht gespeichert.Mit anderen Worten, es verhält sich wie RESTART WITH in [fblangref40-ddl-sequence-alter-de].

  • Wenn die INCREMENT [BY]-Klausel angegeben ist, wird increment als Inkrement in den Metadaten gespeichert und für nachfolgende Aufrufe von NEXT VALUE FOR verwendet

Beispiel für SEQUENZ ERSTELLEN ODER ÄNDERN

Erstelle eine neue oder modifiziere eine bestehende Sequenz EMP_NO_GEN
CREATE OR ALTER SEQUENCE EMP_NO_GEN
  START WITH 10
  INCREMENT BY 1
Siehe auch

[fblangref40-ddl-sequence-create-de], [fblangref40-ddl-sequence-alter-de], [fblangref40-ddl-sequence-drop-de], [fblangref40-ddl-sequence-recr-de], [fblangref40-ddl-sequence-setgen-de], NEXT VALUE FOR, GEN_ID()-Funktion

DROP SEQUENCE

Verwendet für

Löschen einer Sequenz SEQUENCE (GENERATOR)

Verfügbar in

DSQL, ESQL

Syntax
DROP {SEQUENCE | GENERATOR} seq_name
Table 1. DROP SEQUENCE-Anweisungsparameter
Parameter Beschreibung

seq_name

Name der Sequenz (Generator).Diese kann aus bis zu 63 Zeichen bestehen

Die Anweisungen DROP SEQUENCE und DROP GENERATOR sind äquivalent: beide löschen eine existierende Sequenz (Generator).Beides ist gültig, aber DROP SEQUENCE wird empfohlen, da es im SQL-Standard definiert ist.

Die Anweisungen schlagen fehl, wenn die Sequenz (Generator) Abhängigkeiten hat.

Wer kann eine Sequenz löschen?

Die Anweisung DROP SEQUENCE (DROP GENERATOR) kann ausgeführt werden durch:

  • Administratoren

  • Der Besitzer der Sequenz

  • Benutzer mit dem Privileg DROP ANY SEQUENCE (DROP ANY GENERATOR)

Beispiel für DROP SEQUENCE

Löschen der EMP_NO_GEN-Reihe:
DROP SEQUENCE EMP_NO_GEN;
Siehe auch

[fblangref40-ddl-sequence-create-de], [fblangref40-ddl-sequence-crtoralt-de], [fblangref40-ddl-sequence-recr-de]

RECREATE SEQUENCE

Verwendet für

Sequenz erstellen oder neu erstellen (Generator)

Verfügbar in

DSQL, ESQL

Syntax
RECREATE {SEQUENCE | GENERATOR} seq_name
  [START WITH start_value]
  [INCREMENT [BY] increment]
Table 1. RECREATE SEQUENCE-Anweisungsparameter
Parameter Beschreibung

seq_name

Name der Sequenz (Generator).Diese kann aus bis zu 63 Zeichen bestehen

start_value

Anfangswert der Sequenz

increment

Erhöhen der Sequenz (bei Verwendung von NEXT VALUE FOR seq_name);kann nicht 0 sein

Siehe [fblangref40-ddl-sequence-create-de] für die vollständige Syntax von CREATE SEQUENCE und Beschreibungen zur Definition einer Sequenz und ihrer Optionen.

RECREATE SEQUENCE erstellt oder erstellt eine Sequenz neu.Existiert bereits eine Sequenz mit diesem Namen, versucht die RECREATE SEQUENCE-Anweisung, sie zu löschen und eine neue zu erstellen.Vorhandene Abhängigkeiten verhindern die Ausführung der Anweisung.

Beispiel für RECREATE SEQUENCE

Neuerstellen der Sequenz EMP_NO_GEN
RECREATE SEQUENCE EMP_NO_GEN
  START WITH 10
  INCREMENT BY 2;
Siehe auch

[fblangref40-ddl-sequence-create-de], [fblangref40-ddl-sequence-alter-de], [fblangref40-ddl-sequence-crtoralt-de], [fblangref40-ddl-sequence-drop-de], [fblangref40-ddl-sequence-setgen-de], NEXT VALUE FOR, GEN_ID()-Funktion

SET GENERATOR

Verwendet für

Setzen des aktuellen Werts einer Sequenz oder eines Generators auf einen bestimmten Wert

Verfügbar in

DSQL, ESQL

Syntax
SET GENERATOR seq_name TO new_val
Table 1. SET GENERATOR-Anweisungsparameter
Parameter Beschreibung

seq_name

Name des Generators (Sequenz)

new_val

Neuer Sequenz-(Generator-)Wert.Eine 64-Bit-Ganzzahl von -2-63 bis 263-1.

Die Anweisung SET GENERATOR setzt den aktuellen Wert einer Sequenz oder eines Generators auf den angegebenen Wert.

Note

Obwohl SET GENERATOR als veraltet gilt, wird es aus Gründen der Abwärtskompatibilität beibehalten.Die Verwendung der standardkonformen ALTER SEQUENCE wird empfohlen.

Wer kann einen SET GENERATOR verwenden?

Die SET GENERATOR-Anweisung kann ausgeführt werden durch:

  • Administratoren

  • Der Besitzer der Sequenz (Generator)

  • Benutzer mit dem Privileg ALTER ANY SEQUENCE (ALTER ANY GENERATOR)

Beispiel für SET GENERATOR

Wert der Sequenz EMP_NO_GEN auf 145 setzen:
SET GENERATOR EMP_NO_GEN TO 145;
Note

Ähnliche Effekte lassen sich mit [fblangref40-ddl-sequence-alter-de] erzielen:

ALTER SEQUENCE EMP_NO_GEN
  RESTART WITH 145 + increment;

Der Wert von increment ist hier das aktuelle Inkrement der Sequenz.Wir müssen es hinzufügen, da ALTER SEQUENCE den aktuellen Wert berechnet, der basierend auf dem nächsten Wert, den es erzeugen soll, gesetzt werden soll.
Siehe auch

[fblangref40-ddl-sequence-alter-de], [fblangref40-ddl-sequence-create-de], [fblangref40-ddl-sequence-crtoralt-de], [fblangref40-ddl-sequence-drop-de], NEXT VALUE FOR, GEN_ID()-Funktion