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

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