MENGOMENTARI - Amazon Redshift
SintaksParameterCatatan penggunaanContoh

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

MENGOMENTARI

Membuat atau mengubah komentar tentang objek database.

Sintaks

COMMENT ON
{
TABLE object_name |
COLUMN object_name.column_name |
CONSTRAINT constraint_name ON table_name |
DATABASE object_name |
VIEW object_name
}
IS 'text' | NULL

Parameter

object_name

Nama objek database yang dikomentari. Anda dapat menambahkan komentar ke objek berikut:

  • TABEL

  • COLUMN (juga mengambil column_name).

  • CONSTRAINT (juga mengambil constraint_name dan table_name).

  • BASIS DATA

  • MELIHAT

  • SCHEMA

IS 'teks' | NULL

Teks komentar yang ingin Anda tambahkan atau ganti untuk objek yang ditentukan. String teks adalah tipe data TEXT. Lampirkan komentar dalam tanda kutip tunggal. Tetapkan nilainya ke NULL untuk menghapus teks komentar.

column_name

Nama kolom yang dikomentari. Parameter dari COLUMN. Mengikuti tabel yang ditentukan dalamobject_name.

constraint_name

Nama kendala yang sedang dikomentari. Parameter KENDALA.

table_name

Nama tabel yang berisi kendala. Parameter KENDALA.

Catatan penggunaan

Anda harus menjadi superuser atau pemilik objek database untuk menambah atau memperbarui komentar.

Komentar pada database hanya dapat diterapkan ke database saat ini. Pesan peringatan ditampilkan jika Anda mencoba mengomentari database yang berbeda. Peringatan yang sama ditampilkan untuk komentar pada database yang tidak ada.

Komentar pada tabel eksternal, kolom eksternal, dan kolom tampilan pengikatan akhir tidak didukung.

Contoh

Contoh berikut menambahkan komentar ke tabel PENJUALAN. 

COMMENT ON TABLE sales IS 'This table stores tickets sales data';

Contoh berikut menampilkan komentar pada tabel PENJUALAN. 

select obj_description('public.sales'::regclass);

obj_description
-------------------------------------
This table stores tickets sales data

Contoh berikut menghapus komentar dari tabel PENJUALAN. 

COMMENT ON TABLE sales IS NULL;

Contoh berikut menambahkan komentar ke kolom EVENTID dari tabel PENJUALAN. 

COMMENT ON COLUMN sales.eventid IS 'Foreign-key reference to the EVENT table.';

Contoh berikut menampilkan komentar pada kolom EVENTID (kolom nomor 5) dari tabel PENJUALAN. 

select col_description( 'public.sales'::regclass, 5::integer );

col_description
-----------------------------------------
Foreign-key reference to the EVENT table.

Contoh berikut menambahkan komentar deskriptif ke tabel EVENT. 

comment on table event is 'Contains listings of individual events.';

Untuk melihat komentar, kueri katalog sistem PG_DESCRIPTION. Contoh berikut mengembalikan deskripsi untuk tabel EVENT.

select * from pg_catalog.pg_description
where objoid =
(select oid from pg_class where relname = 'event'
and relnamespace =
(select oid from pg_catalog.pg_namespace where nspname = 'public') );

objoid | classoid | objsubid | description
-------+----------+----------+----------------------------------------
116658 |     1259 |        0 | Contains listings of individual events.