DESCRIBE DYNAMIC TABLE¶
Describes the columns in a dynamic table.
DESCRIBE can be abbreviated to DESC.
Syntax¶
DESC[RIBE] DYNAMIC TABLE <name>
Parameters¶
name
Specifies the identifier for the dynamic table to describe. If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.
Access control requirements¶
A role used to execute this operation must have the following privileges at a minimum:
Privilege |
Object |
Notes |
---|---|---|
SELECT |
The dynamic table that you want to describe. |
Some metadata is hidden if you don’t have the MONITOR privilege. For more information, see Privileges to view a dynamic table’s metadata. |
The USAGE privilege on the parent database and schema are required to perform operations on any object in a schema.
For instructions on creating a custom role with a specified set of privileges, see Creating custom roles.
For general information about roles and privilege grants for performing SQL actions on securable objects, see Overview of Access Control.
Usage notes¶
To DESCRIBE a dynamic table, you must be using a role that has MONITOR privilege on the table.
To post-process the output of this command, you can use the RESULT_SCAN function, which treats the output as a table that can be queried. You can also use the pipe operator to query the output of this command.
Examples¶
Describe the columns in the dynamic table named product
:
DESC DYNAMIC TABLE product;