On this page
The SHOW CONSTRAINTS
statement lists all named constraints as well as any unnamed CHECK
constraints on a table.
Required privileges
The user must have any privilege on the target table.
Aliases
SHOW CONSTRAINT
is an alias for SHOW CONSTRAINTS
.
Synopsis
Parameters
Parameter | Description |
---|---|
table_name | The name of the table for which to show constraints. |
Response
The following fields are returned for each constraint.
Field | Description |
---|---|
table_name | The name of the table. |
constraint_name | The name of the constraint. |
constraint_type | The type of constraint. |
details | The definition of the constraint, including the column(s) to which it applies. |
validated | Whether values in the column(s) match the constraint. |
Example
> CREATE TABLE orders ( id INT PRIMARY KEY, date TIMESTAMP NOT NULL, priority INT DEFAULT 1, customer_id INT UNIQUE, status STRING DEFAULT 'open', CHECK (priority BETWEEN 1 AND 5), CHECK (status in ('open', 'in progress', 'done', 'cancelled')), FAMILY (id, date, priority, customer_id, status) );
> SHOW CONSTRAINTS FROM orders;
+------------+------------------------+-----------------+--------------------------------------------------------------------------+-----------+ | table_name | constraint_name | constraint_type | details | validated | +------------+------------------------+-----------------+--------------------------------------------------------------------------+-----------+ | orders | check_priority | CHECK | CHECK (priority BETWEEN 1 AND 5) | true | | orders | check_status | CHECK | CHECK (status IN ('open':::STRING, 'in progress':::STRING, | true | | | | | 'done':::STRING, 'cancelled':::STRING)) | | | orders | orders_customer_id_key | UNIQUE | UNIQUE (customer_id ASC) | true | | orders | primary | PRIMARY KEY | PRIMARY KEY (id ASC) | true | +------------+------------------------+-----------------+--------------------------------------------------------------------------+-----------+ (4 rows)