GS_BLOCKLIST_SQL

Updated on 2024-12-18 GMT+08:00

View PDF

GS_BLOCKLIST_SQL records job blocklist and exception information. This table uses sql_hash as the unique index to collect statistics on job exception information and record blocklist information. You can associate GS_BLOCKLIST_SQL with GS_WLM_SESSION_INFO to obtain the query column and execution information of a job.

GaussDB(DWS) also provides the GS_BLOCKLIST_SQL view for querying job blocklist and exception information. This view can directly display the query column. This view depends on GS_WLM_SESSION_INFO. If the GS_WLM_SESSION_INFO table is large, the query may take a long time.

This system catalog is supported only by clusters of version 9.1.0.200 or later.

**Table 1** GS_BLOCKLIST_SQL columns
Name	Type	Reference	Description
sql_hash	text	N/A	sql_hash generated based on the query parsing tree.
block_list	boolean	N/A	Check whether a job is in the blocklist.
except_num	integer	N/A	Query the number of job exceptions.
except_time	timestamp	N/A	Query the time when the last job exception occurred.

NOTE:

The schema of this system catalog is dbms_om.
This system catalog contains unique indexes, which are distributed on DNs in hash mode. The distributed column is sql_hash.
This system catalog can be queried only in the gaussdb database. If it is queried in other databases, an error will be reported.
The GS_BLOCKLIST_SQL view is stored in pg_catalog.
Generally, constant values are ignored during sql_hash calculation in DML statements. However, constant values cannot be ignored in DDL, DCL, and parameter setting statements. A sql_hash may correspond to one or more queries.