DESCRIBE ICEBERG TABLE¶

Descreve as colunas em uma tabela Iceberg ou os valores atuais, bem como os valores padrão, para as propriedades de uma tabela Iceberg.

DESCRIBE pode ser abreviado como DESC.

Observe que este tópico se refere às tabelas Iceberg simplesmente como “tabelas”, exceto onde a especificação de tabelas Iceberg evita confusão.

Consulte também:: ALTER ICEBERG TABLE, DROP ICEBERG TABLE, CREATE ICEBERG TABLE, SHOW ICEBERG TABLES

Sintaxe¶

DESC[RIBE] [ ICEBERG ] 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

Requisitos de controle de acesso¶

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio	Objeto	Notas
SELECT	Tabela Iceberg
USAGE	Volume externo
USAGE	Integração (catálogo)	Obrigatório se a tabela Iceberg usar uma integração de catálogo.

Observe que operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema principais.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

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 ICEBERG TABLE, DESCRIBE TABLE e DESCRIBE VIEW são intercambiáveis. Qualquer um desses comandos 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 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.

Exemplo¶

Crie um exemplo de tabela Iceberg:

CREATE OR REPLACE ICEBERG TABLE my_iceberg_table
  CATALOG='my_catalog_integration'
  EXTERNAL_VOLUME='my_ext_volume'
  METADATA_FILE_PATH='path/to/metadata/v2.metadata.json';

Copy

Descrever as colunas na tabela:

DESC ICEBERG TABLE my_iceberg_table ;

Copy