DESCRIBE TABLE

Descreve as colunas em uma tabela ou os valores atuais, assim como os valores padrão, para as propriedades de estágio de uma tabela.

DESCRIBE pode ser abreviado como DESC.

Consulte também:

DROP TABLE , ALTER TABLE , CREATE TABLE , SHOW TABLES

DESCRIBE VIEW

Sintaxe

DESC[RIBE] TABLE <name> [ TYPE =  { COLUMNS | STAGE } ]

Parâmetros

name

Especifica o identificador da tabela a ser descrita. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

TYPE = COLUMNS | STAGE

Especifica se devem ser exibidas as colunas para a tabela ou as propriedades do estágio (incluindo seus valores atuais e padrão) para a tabela.

Padrão: TYPE = COLUMNS

Notas de uso

  • Este comando não mostra os parâmetros do objeto para uma tabela. Em vez disso, use SHOW PARAMETERS IN TABLE ….

  • DESC TABLE e DESCRIBE VIEW são intercambiáveis. Ou o comando recupera os detalhes da tabela ou exibição que corresponde aos critérios da instrução; no entanto, TYPE = STAGE não se aplica às exibições porque elas não têm propriedades de estágio.

  • A saída inclui uma coluna POLICY NAME para indicar a política de mascaramento Segurança em nível de coluna definida na coluna.

    Se uma política de mascaramento não for definida na coluna ou se a conta Snowflake não for Enterprise Edition ou superior, o Snowflake retorna NULL.

  • Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.

Exemplos

Criar uma tabela de exemplo:

CREATE TABLE emp (id NUMBER NOT NULL PRIMARY KEY, fname VARCHAR(50), lname VARCHAR(50), location VARCHAR(100));

Descrever as colunas na tabela:

DESC TABLE emp;

Descrever as propriedades do estágio para a tabela:

DESC TABLE emp TYPE = STAGE;

Determinar as políticas de mascaramento definidas nas colunas da tabela:

desc table ssn_record;

---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+
      name     |    type     |  kind  | null? | default | primary key | unique key | check  | expression | comment |       policy name          |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+
EMPLOYEE_SSN_1 | VARCHAR(32) | COLUMN | Y     | [NULL]  | N           | N          | [NULL] | [NULL]     | [NULL]  | MY_DB.MY_SCHEMA.SSN_MASK_1 |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+