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 } ]
Copy

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.

  • Se a evolução do esquema da tabela estiver habilitada na tabela, a saída conterá uma coluna SchemaEvolutionRecord. Esta coluna foi introduzida com Pacote 2023_08 (geralmente ativado). Para obter mais informações, consulte Evolução do esquema da tabela.

  • A saída inclui uma coluna POLICY NAME para indicar a política de mascaramento 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));
Copy

Descrever as colunas na tabela:

DESC TABLE emp;
Copy

Descrever as propriedades do estágio para a tabela:

DESC TABLE emp TYPE = STAGE;
Copy

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          |  privacy domain  |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+------------------+
EMPLOYEE_SSN_1 | VARCHAR(32) | COLUMN | Y     | [NULL]  | N           | N          | [NULL] | [NULL]     | [NULL]  | MY_DB.MY_SCHEMA.SSN_MASK_1 |     [NULL]       |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+------------------+
Copy
Linguagem: Português