All Products
Search
Document Center

PolarDB:ALTER SEQUENCE

Last Updated:Jul 02, 2025

Topik ini menjelaskan cara mengubah nilai awal dari sebuah urutan serta cara mengonversi tipe urutan dari satu jenis ke jenis lain. Urutan grup yang berisi beberapa unit tidak dapat dikonversi menjadi urutan dari tipe lain.

Peringatan

Sebelum mengonversi tipe urutan dari satu jenis ke jenis lain, perhatikan poin-poin berikut:

  • Anda tidak dapat mengonversi urutan grup yang berisi beberapa unit menjadi urutan dari tipe lain atau mengubah nilai parameter UNIT COUNT dan INDEX. Jika Anda mengubah tipe urutan atau nilai parameter UNIT COUNT atau INDEX, urutan tersebut tidak akan bekerja sesuai harapan.

  • Sebelum mengubah nilai parameter START WITH, analisis nilai-nilai urutan yang ada dan laju pembuatan nilai urutan untuk mencegah terjadinya nilai urutan duplikat. Berhati-hatilah saat mengubah nilai parameter START WITH.

  • Saat mengeksekusi pernyataan ALTER SEQUENCE CHANGE TO untuk mengonversi tipe urutan dari satu jenis ke jenis lain, Anda harus mengonfigurasi parameter START WITH. Jika pernyataan ALTER SEQUENCE yang dieksekusi untuk memodifikasi urutan tidak mencakup klausa CHANGE TO, parameter START WITH bersifat opsional.

Urutan baru

Syntax

ALTER SEQUENCE <name> [ CHANGE TO GROUP | TIME ]
START WITH <numeric value>
[ INCREMENT BY <numeric value> ]
[ MAXVALUE <numeric value> ]
[ CYCLE | NOCYCLE ]

Parameters

Parameter

Deskripsi

START WITH

Nilai awal untuk urutan baru. Jika Anda tidak mengonfigurasi parameter ini, nilai awal default digunakan. Nilai default: 1.

INCREMENT BY

Peningkatan antara dua nilai urutan yang berdekatan, juga disebut nilai interval atau ukuran langkah. Jika Anda tidak mengonfigurasi parameter ini, nilai awal default digunakan. Nilai default: 1. Parameter ini didukung hanya saat Anda memodifikasi properti urutan baru. Jika Anda mengonversi urutan baru menjadi urutan grup atau waktu, parameter ini tidak didukung.

MAXVALUE

Nilai maksimum untuk urutan baru. Nilainya harus bilangan bulat positif. Jika Anda tidak menentukan parameter ini, nilai maksimum default digunakan. Nilai maksimum default adalah 9223372036854775807 dan bertipe data BIGINT bertanda. Parameter ini didukung hanya saat Anda memodifikasi properti urutan baru. Jika Anda mengonversi urutan baru menjadi urutan grup atau waktu, parameter ini tidak didukung.

CYCLE atau NOCYCLE

Anda hanya dapat memilih salah satu dari parameter-parameter ini.

  • CYCLE: Saat nilai maksimum untuk urutan baru tercapai, nilai awal dapat digunakan kembali dalam urutan baru.

  • NOCYCLE: Saat nilai maksimum untuk urutan baru tercapai, nilai awal tidak dapat digunakan kembali dalam urutan baru. Jika lebih banyak nilai diberikan, kesalahan akan dikembalikan. Jika Anda tidak mengonfigurasi parameter ini, nilai default NOCYCLE digunakan.

Parameter ini didukung hanya saat Anda memodifikasi properti urutan baru. Jika Anda mengonversi urutan baru menjadi urutan grup atau waktu, parameter ini tidak didukung.

Catatan
  • Urutan baru dapat dikonversi menjadi urutan grup yang hanya berisi satu unit.

  • Setelah urutan baru dikonversi menjadi urutan waktu, nilai awal asli dari urutan menjadi tidak valid.

Urutan grup

Syntax

ALTER SEQUENCE <name> [ CHANGE TO NEW | TIME ]
START WITH <numeric value>
[ INCREMENT BY <numeric value> ]
[ MAXVALUE <numeric value> ]
[ CYCLE | NOCYCLE ]

Parameters

Parameter

Deskripsi

START WITH

Nilai awal untuk urutan grup. Jika Anda tidak mengonfigurasi parameter ini, nilai awal default digunakan. Nilai default: 1.

INCREMENT BY

Peningkatan antara dua nilai urutan yang berdekatan, juga disebut nilai interval atau ukuran langkah. Jika Anda tidak mengonfigurasi parameter ini, nilai awal default digunakan. Nilai default: 1. Parameter ini didukung hanya saat Anda mengonversi urutan grup menjadi urutan baru.

MAXVALUE

Nilai maksimum untuk urutan grup. Nilainya harus bilangan bulat positif. Jika Anda tidak menentukan parameter ini, nilai maksimum default digunakan. Nilai maksimum default adalah 9223372036854775807 dan bertipe data BIGINT bertanda. Parameter ini didukung hanya saat Anda mengonversi urutan grup menjadi urutan baru.

CYCLE atau NOCYCLE

Anda hanya dapat memilih salah satu dari parameter-parameter ini. Parameter ini didukung hanya saat Anda mengonversi urutan grup menjadi urutan baru.

  • CYCLE: Saat nilai maksimum untuk urutan grup tercapai, nilai awal dapat digunakan kembali dalam urutan grup.

  • NOCYCLE: Saat nilai maksimum untuk urutan grup tercapai, nilai awal tidak dapat digunakan kembali dalam urutan baru. Jika lebih banyak nilai diberikan, kesalahan akan dikembalikan. Jika Anda tidak mengonfigurasi parameter ini, nilai default NOCYCLE digunakan.

Catatan

Saat mengonversi urutan grup menjadi urutan waktu, nilai parameter START WITH, INCREMENT BY, MAXVALUE, dan CYCLE atau NOCYCLE menjadi tidak valid.

Urutan waktu

Syntax

ALTER SEQUENCE <name> [ CHANGE TO NEW | GROUP ]
START WITH <numeric value>
[ INCREMENT BY <numeric value> ]
[ MAXVALUE <numeric value> ]
[ CYCLE | NOCYCLE ]

Parameters

Parameter

Deskripsi

START WITH

Nilai awal untuk urutan waktu. Jika Anda tidak mengonfigurasi parameter ini, nilai awal default digunakan. Nilai default: 1.

INCREMENT BY

Peningkatan antara dua nilai urutan yang berdekatan, juga disebut nilai interval atau ukuran langkah. Jika Anda tidak mengonfigurasi parameter ini, nilai awal default digunakan. Nilai default: 1. Parameter ini didukung hanya saat Anda mengonversi urutan waktu menjadi urutan baru.

MAXVALUE

Nilai maksimum untuk urutan waktu. Nilainya harus bilangan bulat positif. Jika Anda tidak menentukan parameter ini, nilai maksimum default digunakan. Nilai maksimum default adalah 9223372036854775807 dan bertipe data BIGINT bertanda. Parameter ini didukung hanya saat Anda mengonversi urutan waktu menjadi urutan baru.

CYCLE atau NOCYCLE

Anda hanya dapat memilih salah satu dari parameter-parameter ini. Parameter ini didukung hanya saat Anda mengonversi urutan waktu menjadi urutan baru.

  • CYCLE: Saat nilai maksimum untuk urutan waktu tercapai, nilai awal dapat digunakan kembali dalam urutan waktu.

  • NOCYCLE: Saat nilai maksimum untuk urutan waktu tercapai, nilai awal tidak dapat digunakan kembali dalam urutan waktu. Jika lebih banyak nilai diberikan, kesalahan akan dikembalikan. Jika Anda tidak mengonfigurasi parameter ini, nilai default NOCYCLE digunakan.

Catatan

Saat mengonversi urutan waktu menjadi urutan grup, nilai parameter START WITH, INCREMENT BY, MAXVALUE, dan CYCLE atau NOCYCLE menjadi tidak valid karena hanya satu unit yang terkandung.

Contoh

  • Ubah nilai awal dari sebuah urutan.

    ALTER SEQUENCE seq1 START WITH 1000000;
  • Konversikan urutan menjadi urutan grup.

    ALTER SEQUENCE seq2 CHANGE TO GROUP START WITH 2000000;
  • Konversikan urutan menjadi urutan waktu.

    ALTER SEQUENCE seq3 CHANGE TO TIME;
  • Konversikan urutan menjadi urutan baru dan gunakan nilai default dari parameter START WITH, MAXVALUE, dan CYCLE atau NOCYCLE.

    ALTER SEQUENCE seq4 CHANGE TO NEW START WITH 100;
  • Konversikan urutan menjadi urutan baru dan tentukan nilai untuk parameter START WITH, MAXVALUE, dan CYCLE atau NOCYCLE.

    ALTER SEQUENCE seq5 CHANGE TO NEW START WITH 200 INCREMENT BY 2 MAXVALUE 300 NOCYCLE;