Skema informasi untuk database dialek PostgreSQL

Skema informasi adalah skema bawaan yang umum untuk setiap database PostgreSQL. Anda dapat menjalankan kueri SQL terhadap tabel di information_schema untuk mengambil metadata skema untuk database.

Misalnya, kueri berikut mengambil nama semua tabel yang ditentukan pengguna dalam database:

  SELECT
    table_name
  FROM
    information_schema.tables
  WHERE
    table_schema = 'public'

Penggunaan

• Tabel information_schema hanya tersedia melalui antarmuka SQL, misalnya:

  • executeQuery API
  • Perintah gcloud spanner databases execute-sql
  • Halaman Query database di konsol Google Cloud.

  Metode baca tunggal lainnya tidak mendukung information_schema.

• Kueri terhadap information_schema dapat menggunakan batas stempel waktu yang kuat dan terbatas, atau tidak berlaku lagi dengan tepat.
• Jika Anda menggunakan database dialek GoogleSQL, lihat Skema informasi untuk database dialek GoogleSQL.

Perbedaan dengan information_schema untuk PostgreSQL

Tabel di information_schema untuk database dialek PostgreSQL menyertakan kolom dari tabel di information_schema untuk PostgreSQL open source dan dalam beberapa kasus juga menyertakan kolom dari Spanner. Dalam tabel ini, kolom PostgreSQL open source muncul terlebih dahulu dan dalam urutan yang sama seperti pada database PostgreSQL open source, dan setiap kolom yang berbeda untuk Spanner akan ditambahkan setelahnya. Kueri yang ditulis untuk information_schema versi PostgreSQL open source akan berfungsi tanpa modifikasi saat menggunakan database dialek PostgreSQL di Google Cloud CLI.

Perbedaan penting lainnya pada information_schema untuk database dialek PostgreSQL adalah:

• Beberapa kolom tabel untuk PostgreSQL open source tersedia, tetapi tidak diisi di database dialek PostgreSQL.
• Database dialek PostgreSQL menggunakan public untuk nama skema default.
• Nama batasan yang dihasilkan secara otomatis menggunakan format yang berbeda dari database PostgreSQL open source.
• Tabel yang terkait dengan fitur PostgreSQL open source yang tidak didukung dalam database dialek PostgreSQL tidak tersedia.
• Beberapa tabel yang tersedia dengan Spanner, tetapi tidak tersedia dengan PostgreSQL open source, seperti database_options, index_columns, indexes, dan spanner_statistics.

Pemfilteran baris dalam information_schema tabel dan tampilan

Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader (atau kepada anggota peran tersebut) dapat melihat semua baris di semua tabel dan tampilan information_schema. Untuk akun utama lainnya, Spanner memfilter baris berdasarkan peran database saat ini. Deskripsi tabel dan tampilan di bagian berikut menunjukkan cara Spanner memfilter baris untuk setiap tabel dan tampilan.

Tabel di information_schema untuk database dialek PostgreSQL

Tabel dan tampilan di information_schema kompatibel dengan tabel dan tampilan di information_schema untuk PostgreSQL open source.

Bagian berikut menjelaskan tabel dan tampilan di information_schema untuk database dialek PostgreSQL.

applicable_roles

Tampilan yang difilter baris ini mencantumkan semua keanggotaan peran yang secara eksplisit diberikan ke semua peran database. Principal yang memiliki izin IAM level database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat keanggotaan peran yang diberikan ke peran database saat ini atau peran yang menjadi anggota dari peran database saat ini.

Karena semua peran database adalah anggota dari peran publik, hasilnya akan menghilangkan catatan untuk keanggotaan implisit dalam peran publik.

change_stream_columns

Tampilan yang difilter baris ini berisi informasi tentang kolom tabel dan aliran perubahan yang memantaunya. Setiap baris menjelaskan satu aliran perubahan dan satu kolom. Jika aliran perubahan melacak seluruh tabel, kolom dalam tabel tersebut tidak akan ditampilkan dalam tampilan ini.

Principal yang memiliki izin IAM level database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat baris untuk aliran data perubahan yang diberi hak istimewa SELECT ke peran database saat ini, ke peran dengan peran database saat ini menjadi anggota, atau ke public.

change_stream_options

Tampilan yang difilter baris ini berisi opsi konfigurasi untuk aliran perubahan. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat opsi untuk aliran perubahan dengan hak istimewa SELECT yang diberikan ke peran database saat ini, ke peran dengan peran database saat ini menjadi anggota, atau ke public.

change_stream_privileges

Tampilan yang difilter baris ini mencantumkan semua hak istimewa kontrol akses terperinci yang diberikan pada semua aliran data perubahan ke peran database apa pun, termasuk public. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat hak istimewa yang diberikan di aliran perubahan ke peran database saat ini, ke peran dengan anggota yang memiliki peran database saat ini, atau ke public.

change_stream_tables

Tampilan yang difilter baris ini berisi informasi tentang tabel dan aliran perubahan yang memantaunya. Setiap baris mendeskripsikan satu tabel dan satu aliran perubahan. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat baris untuk aliran perubahan yang diberi hak istimewa SELECT ke peran database saat ini, ke peran dengan peran database saat ini menjadi anggota, atau ke public.

Data dalam change_stream_tables tidak menyertakan hubungan implisit antara tabel dan aliran perubahan yang melacak seluruh database.

change_streams

Tampilan yang difilter baris ini mencantumkan semua aliran perubahan database, dan mencatat mana yang melacak seluruh database versus tabel atau kolom tertentu. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat perubahan aliran yang diberi hak istimewa kontrol akses terperinci SELECT ke peran database saat ini, ke peran dengan peran database saat ini menjadi anggota, atau ke public.

check_constraints

Tampilan check_constraints berisi satu baris untuk setiap batasan pemeriksaan yang ditentukan oleh kata kunci CHECK atau NOT NULL.

column_column_usage

Tampilan ini mencantumkan semua kolom yang dihasilkan, yang bergantung pada kolom dasar lain dalam tabel yang sama.

column_options

Tampilan ini mencantumkan semua opsi yang ditentukan untuk kolom tabel yang direferensikan dari batasan kunci asing. Tampilan hanya berisi kolom dalam tabel referensi yang dapat diakses oleh pengguna saat ini (dengan menjadi pemilik atau hak istimewa).

column_privileges

Tampilan yang difilter baris ini mencantumkan semua hak istimewa kontrol akses terperinci yang diberikan pada semua kolom ke peran database apa pun, termasuk public. Principal yang memiliki izin tingkat database IAM dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat hak istimewa yang diberikan di kolom untuk peran database saat ini, ke peran yang perannya merupakan anggota database saat ini, atau ke public.

Tampilan ini mencakup hak istimewa SELECT, INSERT, dan UPDATE yang diwarisi oleh kolom dari tabel atau tampilan yang berisi kolom tersebut.

columns

Tampilan yang difilter baris ini memberikan informasi tentang semua kolom tabel dan kolom tampilan dalam database. Principal yang memiliki izin IAM level database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat kolom yang memiliki hak istimewa kontrol akses terperinci yang diberikan pada akun utama tersebut (atau hak istimewa SELECT, INSERT, atau UPDATE yang diberikan pada tabel yang memuatnya) untuk peran database saat ini, peran yang merupakan anggota dari peran database saat ini, atau ke public.

constraint_column_usage

Tampilan ini berisi satu baris tentang setiap kolom yang digunakan oleh batasan.

• Untuk batasan PRIMARY KEY dan CHECK yang ditentukan oleh kata kunci NOT NULL, tampilan akan berisi kolom-kolom tersebut.
• Untuk batasan CHECK yang dibuat dengan kata kunci CHECK, tampilan menyertakan kolom yang digunakan oleh ekspresi batasan pemeriksaan.
• Untuk batasan kunci asing, tampilan berisi kolom dari tabel yang direferensikan.
• Untuk batasan UNIQUE, tampilan berisi kolom dari KEY_COLUMN_USAGE.

constraint_table_usage

Tampilan ini berisi satu baris untuk setiap tabel yang digunakan oleh batasan. Untuk batasan FOREIGN KEY, informasi tabel adalah untuk tabel dalam klausa REFERENCES. Untuk batasan kunci unik atau utama, tampilan ini hanya mengidentifikasi tabel tempat batasan tersebut berada. Batasan pemeriksaan dan batasan not-null tidak disertakan dalam tampilan ini.

database_options

Tabel ini mencantumkan opsi yang ditetapkan pada database.

enabled_roles

Tampilan yang difilter baris ini mencantumkan peran database yang ditentukan. Principal yang memiliki izin IAM level database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua peran database. Semua akun utama lainnya hanya dapat melihat peran database yang aksesnya telah diberikan kepadanya, baik secara langsung maupun melalui pewarisan. Semua peran sistem kecuali public juga muncul dalam tampilan ini.

index_columns

Tampilan ini mencantumkan kolom pada indeks.

indexes

Tampilan ini mencantumkan indeks dalam skema.

information_schema_catalog_name

Tabel ini berisi satu baris dan satu kolom yang berisi nama {i>database<i}.

key_column_usage

Tampilan ini mengidentifikasi semua kolom dalam database saat ini yang direferensikan oleh batasan unik, kunci utama, atau kunci asing. Untuk mengetahui informasi tentang kolom batasan CHECK, lihat tampilan check_constraints.

parameters

Tampilan yang difilter baris ini mendefinisikan argumen untuk setiap fungsi baca aliran perubahan. Setiap baris menjelaskan satu argumen untuk satu fungsi pembacaan aliran perubahan.

Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat parameter untuk fungsi pembacaan aliran perubahan yang memberikan hak istimewa kontrol akses terperinci EXECUTE ke peran database saat ini, ke peran dengan peran database saat ini sebagai anggota, atau ke public.

referential_constraints

Tampilan ini berisi satu baris tentang setiap batasan FOREIGN KEY. Anda hanya dapat melihat batasan-batasan yang Anda miliki akses tulisnya ke tabel referensi. Tampilan ini juga mengidentifikasi batasan PRIMARY KEY dan UNIQUE pada tabel direferensikan yang digunakan kunci asing untuk penerapan batasan dan tindakan referensial.

role_change_stream_grants

Tampilan yang difilter baris ini mencantumkan hak istimewa SELECT yang diberikan pada semua aliran perubahan ke peran database apa pun, termasuk public. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat hak istimewa yang diberikan di aliran perubahan ke peran database saat ini dan ke peran yang anggotanya dimiliki oleh peran database saat ini, tidak termasuk public.

role_column_grants

Tampilan yang difilter baris ini mencantumkan semua hak istimewa kontrol akses terperinci yang diberikan pada semua kolom ke peran database apa pun, termasuk public. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat hak istimewa yang diberikan di kolom ke peran database saat ini dan ke peran yang merupakan anggota dari peran database saat ini, tidak termasuk public.

Tampilan ini mencakup hak istimewa SELECT, INSERT, dan UPDATE yang diwarisi oleh kolom dari tabel atau tampilan yang berisi kolom tersebut.

role_routine_grants

Tampilan yang difilter baris ini mencantumkan hak istimewa EXECUTE yang diberikan pada semua fungsi baca aliran perubahan ke peran database apa pun, termasuk public. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat hak istimewa yang diberikan pada fungsi baca aliran perubahan ke peran database saat ini dan ke peran yang merupakan anggota dari peran database saat ini, tidak termasuk public.

role_table_grants

Tampilan yang difilter baris ini mencantumkan semua hak istimewa kontrol akses terperinci yang diberikan pada semua tabel dan tampilan untuk semua peran database, termasuk public. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat hak istimewa yang diberikan pada tabel dan tampilan untuk peran database saat ini serta peran yang merupakan anggota dari peran database saat ini, tidak termasuk public.

routine_options

Tampilan yang difilter baris ini berisi satu baris untuk setiap opsi bagi setiap fungsi pembacaan aliran perubahan yang ditentukan.

Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat opsi untuk fungsi pembacaan aliran perubahan di mana hak istimewa kontrol akses terperinci EXECUTE diberikan ke peran database saat ini, ke peran dengan peran database saat ini sebagai anggota, atau ke public.

routine_privileges

Tampilan yang difilter baris ini mencantumkan semua hak istimewa kontrol akses terperinci yang diberikan pada semua fungsi baca aliran data perubahan ke peran database apa pun, termasuk public. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat hak istimewa yang diberikan pada fungsi baca di aliran perubahan ke peran database saat ini, ke peran dengan peran database saat ini sebagai anggota, atau ke public.

routines

Tampilan yang difilter baris ini mencantumkan semua fungsi pembacaan aliran perubahan database. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat fungsi baca aliran data yang hak istimewa kontrol akses terperinci EXECUTE diberikan ke peran database saat ini, ke peran yang merupakan anggota dari peran database saat ini, atau ke public.

schemata

Tampilan information_schema.schemata berisi satu baris untuk setiap skema dalam database saat ini. Skema mencakup skema informasi dan skema default bernama public.

sequences

Tampilan information_schema.sequences berisi metadata sequences.

spanner_statistics

Tabel ini mencantumkan paket statistik pengoptimal kueri yang tersedia.

table_constraints

Tampilan ini berisi semua batasan yang dimiliki tabel yang dapat diakses pengguna saat ini (selain SELECT).

table_privileges

Tampilan yang difilter baris ini mencantumkan semua hak istimewa kontrol akses terperinci yang diberikan pada semua tabel dan tampilan untuk semua peran database, termasuk public. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua baris dalam tampilan ini. Semua akun utama lainnya hanya dapat melihat hak istimewa yang diberikan pada tabel dan tampilan untuk peran database saat ini, peran dengan anggota yang memiliki peran database saat ini, atau untuk public.

tables

Tampilan yang difilter baris ini mencantumkan semua tabel dan tampilan yang ada di database saat ini. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua tabel dan tampilan. Semua akun utama lainnya hanya dapat melihat tabel yang memenuhi salah satu persyaratan berikut:

• Hak istimewa kontrol akses terperinci SELECT, INSERT, UPDATE, atau DELETE diberikan dalam tabel ke peran database saat ini, ke peran dengan peran database saat ini sebagai anggota, atau ke public.
• Hak istimewa SELECT, INSERT, atau UPDATE diberikan di kolom tabel mana pun ke peran database saat ini, ke peran dengan peran database saat ini sebagai anggota, atau ke public.

table_synonyms

Tabel ini mencantumkan informasi sinonim untuk tabel tersebut.

views

Tampilan yang difilter baris ini mencantumkan semua tampilan di database saat ini. Principal yang memiliki izin IAM tingkat database dan akun utama yang telah diberi akses ke peran sistem spanner_info_reader atau kepada anggota peran tersebut dapat melihat semua tampilan. Semua akun utama lainnya hanya dapat melihat tampilan yang memiliki hak istimewa kontrol akses terperinci SELECT yang diberikan padanya ke peran database saat ini, ke peran dengan peran database saat ini sebagai anggota, atau ke public.

Contoh

Tampilkan informasi tentang setiap tabel dalam skema default:

SELECT
  t.table_catalog,
  t.table_name,
  t.parent_table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_schema = 'public'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name

Tampilkan nama semua tabel dan tampilan di information_schema untuk database dialek PostgreSQL:

SELECT table_name
FROM information_schema.tables
WHERE table_schema = "information_schema"

Tampilkan informasi tentang kolom di tabel pengguna my_table:

SELECT
  t.ordinal_position,
  t.column_name,
  t.data_type,
  t.spanner_type,
  t.is_nullable
FROM
  information_schema.columns AS t
WHERE
  t.table_schema = 'public'
  AND
  t.table_name = 'my_table'
ORDER BY
  t.ordinal_position

Tampilkan informasi tentang setiap indeks dalam skema default di database saat ini:

SELECT
  t.table_name,
  t.index_name,
  t.parent_table_name
FROM
  information_schema.indexes AS t
WHERE
  t.table_schema = 'public'
  AND
  t.index_type != 'PRIMARY_KEY'
ORDER BY
  t.table_schema,
  t.table_name,
  t.index_name

Tampilkan semua kolom yang menggunakan opsi selain default:

SELECT
  t.table_name,
  t.column_name,
  t.option_type,
  t.option_value,
  t.option_name
FROM
  information_schema.column_options AS t
WHERE
  t.table_schema = 'public'
ORDER BY
  t.table_schema,
  t.table_name,
  t.column_name,
  t.option_name

Tampilkan opsi database terkait pengoptimal saat ini:

SELECT
  s.option_name,
  s.option_value
FROM
  information_schema.database_options s
WHERE
  s.schema_name='public'
  AND s.option_name IN ('optimizer_version',
    'optimizer_statistics_package')

Menampilkan semua paket statistik yang tersedia:

SELECT *
FROM information_schema.spanner_statistics;

Langkah selanjutnya

• Pelajari alat Introspeksi yang tersedia untuk membantu Anda menyelidiki masalah database.