Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CREATE SEQUENCE

CREATE SEQUENCE— tentukan generator urutan baru.

Sintaksis yang didukung

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

Deskripsi

CREATE SEQUENCEmembuat generator nomor urut baru. Ini melibatkan pembuatan dan inisialisasi tabel baris tunggal khusus baru dengan nama. name Generator akan dimiliki oleh pengguna yang mengeluarkan perintah.

Jika nama skema diberikan maka urutan dibuat dalam skema yang ditentukan. Jika tidak, itu dibuat dalam skema saat ini. Nama urutan harus berbeda dari nama relasi lainnya (tabel, urutan, indeks, tampilan, tampilan terwujud, atau tabel asing) dalam skema yang sama.

Setelah urutan dibuat, Anda menggunakan fungsinextval,currval, dan setval untuk beroperasi pada urutan. Fungsi-fungsi ini didokumentasikan dalamFungsi manipulasi urutan.

Meskipun Anda tidak dapat memperbarui urutan secara langsung, Anda dapat menggunakan kueri seperti:

SELECT * FROM name;

untuk memeriksa beberapa parameter dan keadaan urutan saat ini. Secara khusus, last_value bidang urutan menunjukkan nilai terakhir yang dialokasikan oleh sesi apa pun. (Tentu saja, nilai ini mungkin sudah usang pada saat dicetak, jika sesi lain secara aktif melakukan nextval panggilan.) Parameter lain seperti increment dan maxvalue dapat diamati dalam pg_sequences tampilan.

Parameter

Catatan

Gunakan DROP SEQUENCE untuk menghapus urutan.

Urutan didasarkan pada bigint aritmatika, sehingga kisarannya tidak dapat melebihi kisaran bilangan bulat delapan byte (-9223372036854775808 hingga 9223372036854775807).

Karena nextval dan setval panggilan tidak pernah diputar kembali, objek urutan tidak dapat digunakan jika penugasan nomor urut “tanpa celah” diperlukan.

Setiap sesi akan mengalokasikan dan menyimpan nilai urutan berturut-turut selama satu akses ke objek urutan dan meningkatkan objek urutan yang sesuai. last_value Kemudian, penggunaan cache -1 berikutnya dari nextval dalam sesi itu hanya mengembalikan nilai yang telah dialokasikan sebelumnya tanpa menyentuh objek urutan. Jadi, angka apa pun yang dialokasikan tetapi tidak digunakan dalam sesi akan hilang ketika sesi itu berakhir, menghasilkan “lubang” dalam urutan.

Selain itu, meskipun beberapa sesi dijamin untuk mengalokasikan nilai urutan yang berbeda, nilai mungkin dihasilkan di luar urutan ketika semua sesi dipertimbangkan. Misalnya, dengan cache pengaturan 10, sesi A mungkin mencadangkan nilai 1.. 10 dan kembali nextval = 1, maka sesi B mungkin mencadangkan nilai 11.. 20 dan kembali nextval = 11 sebelum sesi A dihasilkan nextval = 2. Jadi, dengan cache pengaturan satu, aman untuk mengasumsikan bahwa nextval nilai dihasilkan secara berurutan; dengan cache pengaturan yang lebih besar dari satu Anda hanya boleh berasumsi bahwa nextval nilainya semuanya berbeda, bukan bahwa mereka dihasilkan murni secara berurutan. Juga, last_value akan mencerminkan nilai terbaru yang dicadangkan oleh sesi apa pun, apakah itu belum dikembalikan olehnextval.

Pertimbangan lain adalah bahwa setval eksekusi pada urutan seperti itu tidak akan diperhatikan oleh sesi lain sampai mereka menggunakan nilai yang telah dialokasikan sebelumnya yang telah mereka cache.

Contoh

Buat urutan naik yang disebutserial, mulai dari 101:

CREATE SEQUENCE serial CACHE 65536 START 101;

Pilih nomor berikutnya dari urutan ini:

SELECT nextval('serial');

 nextval
---------
     101

Pilih nomor berikutnya dari urutan ini:

SELECT nextval('serial');

 nextval
---------
     102

Gunakan urutan ini dalam sebuah INSERT perintah:

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

Setel ulang urutan ke nilai tertentu menggunakansetval:

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

 nextval
---------
     201

Kompatibilitas

CREATE SEQUENCEsesuai dengan standar SQL, dengan pengecualian berikut: