Compartilhar via


TABLES

Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 10.4 LTS e superior verificação marcada como sim Somente Catálogo do Unity

INFORMATION_SCHEMA.TABLES contém os metadados no nível do objeto para tabelas e exibições (relações) no catálogo local ou todos os catálogos visíveis para o espaço de trabalho, se pertencentes ao SYSTEM catálogo.

As linhas retornadas são limitadas às relações com as quais o usuário tem o privilégio de interagir.

Definição

A relação TABLES contém as seguintes colunas:

Nome Tipo de dados Nullable Standard Descrição
TABLE_CATALOG STRING No Sim O catálogo que contém a relação.
TABLE_SCHEMA STRING No Sim O esquema que contém a relação.
TABLE_NAME STRING No Sim O nome da relação.
TABLE_TYPE STRING No Sim Consulte Tipos de tabela.
IS_INSERTABLE_INTO STRING Não Sim 'YES' se a relação puder ser inserida, caso contrário, 'NO'.
COMMIT_ACTION STRING No Sim Sempre 'PRESERVE'. Reservado para uso futuro.
TABLE_OWNER STRING No No Usuário ou grupo (entidade de segurança) que atualmente possui a relação.
COMMENT STRING Sim No Um comentário opcional que descreve a relação.
CREATED TIMESTAMP No No Carimbo de data/hora da criação da relação.
CREATED_BY STRING No No A entidade de segurança que criou a relação.
LAST_ALTERED TIMESTAMP No No Carimbo de data/hora da última alteração na definição da relação.
LAST_ALTERED_BY STRING No No A entidade de segurança que alterou a relação por último.
DATA_SOURCE_FORMAT STRING No No O formato da fonte de dados, como PARQUET ou CSV.
STORAGE_SUB_DIRECTORY STRING Sim No Descontinuado. Sempre NULL.

Restrições

As seguintes restrições se aplicam à relação TABLES:

Classe Nome Lista de colunas Descrição
Chave primária TABLES_PK TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME Identificador exclusivo da relação.
Chave estrangeira TABLES_SCHEMATA_FK TABLE_CATALOG, TABLE_SCHEMA Faz referência a SCHEMATA.

Tipos de tabela

A TABLE_TYPE coluna na TABLES relação pode ter os seguintes valores:

  • VIEW: Uma tabela virtual definida por uma consulta.
  • FOREIGN: Uma tabela federada.
  • MANAGED: uma tabela regular para a qual o armazenamento é gerenciado pelo catálogo.
  • STREAMING_TABLE: uma tabela usada para transmitir dados.
  • MATERIALIZED_VIEW: Uma tabela que é uma exibição materializada.
  • EXTERNAL: Uma tabela para a qual o armazenamento é gerenciado fora do catálogo.
  • MANAGED_SHALLOW_CLONE: uma tabela que é um clone superficial de uma tabela gerenciada.
  • EXTERNAL_SHALLOW_CLONE: Uma tabela que é um clone superficial de uma tabela externa.

Exemplos

> SELECT *
    FROM information_schema.tables
    WHERE table_schema = 'information_schema'
      AND table_name = 'columns';
  table_catalog table_schema       table_name table_type is_insertable_into commit_action table_owner comment                                               ...
  ------------- ------------------ ---------- ---------- ------------------ ------------- ----------- ----------------------------------------------------- ...
  main          information_schema columns    VIEW       NO                 PRESERVE      System user Describes columns of tables and views in the catalog. ...