Updated on 2023-10-23 GMT+08:00

Overview of System Catalogs and System Views

System catalogs store the structured metadata of GaussDB. They are the source of information used by GaussDB to control system running and are a core component of the database system.

System views provide ways to query the system catalogs and internal database status.

System catalogs and views are visible to either system administrators or all users. Some system catalogs and views have marked the need of administrator permissions, so they are accessible only to administrators.

You can delete and re-create system catalogs, add columns to them, and insert and update values in them, but doing so may make system information inconsistent and cause system faults. Generally, users should not modify system catalogs or system views, or rename their schemas. They are automatically maintained by the system.

  • You are not advised to modify the permissions on system catalogs or system views.
  • Do not add, delete, or modify system catalogs because doing so will result in exceptions or even cluster unavailability.
  • The gs_package system catalog is used only in a centralized system. It can be queried in a distributed system but is meaningless.
  • For details about field types in system catalogs and system views, see section Data Type.