Partilhar via

TABLES

  • Artigo

Aplica-se a:assinalado como sim Databricks SQL assinalado como sim Databricks Runtime 10.4 LTS e superior assinalado como sim apenas Unity Catalog

INFORMATION_SCHEMA.TABLES Contém os metadados no nível do objeto para tabelas e exibições (relações) dentro do catálogo local ou todos os catálogos visíveis para o espaço de trabalho, se pertencerem 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:

Name Tipo de dados Pode ser nulo Standard Description
TABLE_CATALOG STRING Não Sim Catálogo que contém a relação.
TABLE_SCHEMA STRING Não Sim Esquema que contém a relação.
TABLE_NAME STRING Não Sim Nome da relação.
TABLE_TYPE STRING Não Sim Consulte Tipos de tabela.
IS_INSERTABLE_INTO STRING Não Sim 'YES' se a relação puder ser inserida, 'NO' caso contrário.
COMMIT_ACTION STRING Não Sim Sempre 'PRESERVE'. Reservado para uso futuro.
TABLE_OWNER STRING Não Não Usuário ou grupo (principal) atualmente proprietário da relação.
COMMENT STRING Sim Não Um comentário opcional que descreve a relação.
CREATED TIMESTAMP Não Não Carimbo de data/hora quando a relação foi criada.
CREATED_BY STRING Não Não Principal que criou a relação.
LAST_ALTERED TIMESTAMP Não Não Carimbo de data/hora quando a definição de relação foi alterada pela última vez de alguma forma.
LAST_ALTERED_BY STRING Não Não Principal que alterou a relação pela última vez.
DATA_SOURCE_FORMAT STRING Não Não Formato da fonte de dados, como PARQUET, ou CSV.
STORAGE_PATH STRING Sim Não URL raiz de armazenamento para tabelas gerenciadas e externas.
STORAGE_SUB_DIRECTORY STRING Sim Não Descontinuado. Sempre NULL.

Restrições

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

Classe Name Lista de colunas Description
Chave primária TABLES_PK TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME Identificador exclusivo para a relação.
Chave estrangeira TABLES_SCHEMATA_FK TABLE_CATALOG, TABLE_SCHEMA Referências SCHEMATA.

Tipos de tabela

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

  • VIEW: Uma tabela virtual que é 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 que é usada para streaming de dados.
  • MATERIALIZED_VIEW: Uma tabela que é uma visã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. ...