Explore objetos de banco de dados

Este artigo detalha como o senhor pode descobrir e explorar catálogos, esquemas, tabelas e outros objetos de banco de dados no Databricks. As instruções deste artigo concentram-se em retornar detalhes de objetos de banco de dados nos quais o senhor tem pelo menos o privilégio BROWSE ou SELECT.

Para obter informações gerais sobre os privilégios do site Unity Catalog, consulte Unity Catalog privileges and securable objects. Para obter informações sobre como definir a propriedade e as permissões do esquema, consulte gerenciar a propriedade do objeto Unity Catalog e gerenciar privilégios em Unity Catalog.

A maior parte do acesso a objetos de banco de dados é governada pelo Unity Catalog, mas sua empresa pode usar outra abordagem de governança de dados ou combinar o Unity Catalog com outras ACLs de tabela herdadas. Este artigo se concentra na descrição do comportamento de objetos governados pelo Unity Catalog, mas a maioria dos métodos descritos neste artigo também funcionam para objetos de banco de dados que não são governados pelo Unity Catalog.

Este artigo inclui instruções para o Catalog Explorer e o SQL. Selecione o ícone Catalog na barra lateral workspace para acessar o Catalog Explorer. O senhor pode executar o comando SQL em um site Notebook ou no editor de consultas anexado ao compute. Para view objetos de banco de dados com o Catalog Explorer, o senhor deve ter pelo menos o privilégio BROWSE nos objetos. Para view objetos de banco de dados com SQL, o senhor deve ter pelo menos o privilégio SELECT no objeto, bem como USE CATALOG no catálogo pai e USE SCHEMA no esquema pai.

Observação

Você pode navegar em objetos de banco de dados controlados pelo Unity Catalog no Catalog Explorer sem compute ativa. Para explorar dados no hive_metastore e em outros catálogos não regidos pelo Unity Catalog, você deve anexar para compute com os privilégios apropriados.

Filtrando objetos de banco de dados

Durante a exploração interativa de objetos de banco de dados com o Catalog Explorer, é possível usar a caixa de texto fornecida para filtrar resultados. As strings correspondentes nos nomes dos objetos são destacadas, mas apenas entre os objetos de banco de dados atualmente visíveis. Para uma pesquisa completa de todos os objetos de banco de dados, consulte Pesquisar objetos workspace .

O SQL fornece funcionalidade semelhante especificando opcionalmente uma cláusula regex_pattern em conjunto com uma instrução SHOW , como a seguir:

SHOW TABLES IN schema_name LIKE 'sales_*_fy23'

Explorar catálogos

Os catálogos representam o nível superior de governança de dados em cada metastore Unity Catalog .

execute o seguinte comando para ver uma lista de catálogos disponíveis para você.

SHOW CATALOGS

Consulte SHOW CATALOGS.

Ao acessar o Catalog Explorer, você verá uma lista de catálogos disponíveis para você.

Selecione um catálogo

execute o seguinte comando para definir seu catálogo atualmente ativo.

USE CATALOG catalog_name

Veja USE CATALOG.

Clique no nome de um catálogo para selecioná-lo.

Veja detalhes do catálogo

execute o seguinte comando para descrever um catálogo.

DESCRIBE CATALOG catalog_name

Consulte DESCRIBE CATALOG.

Selecione a Detalhes tab para revisar os detalhes do catálogo.

Explorar esquemas

Esquemas são coleções de tabelas, view, volumes, funções e modelos no Unity Catalog. Os esquemas estão contidos em catálogos.

execute o seguinte comando para ver uma lista de esquemas disponíveis para você.

SHOW SCHEMAS IN catalog_name

Consulte SHOW SCHEMAS.

Ao selecionar um catálogo no Catalog Explorer, você verá uma lista de esquemas disponíveis.

Selecione um esquema

execute o seguinte comando para definir seu esquema atualmente ativo.

USE schema catalog_name.schema_name

Consulte USE SCHEMA.

Clique no nome de um esquema para selecioná-lo.

Veja detalhes do esquema

execute o seguinte comando para descrever um esquema.

DESCRIBE SCHEMA schema_name

Consulte DESCRIBE SCHEMA.

Selecione a Detalhes tab para revisar os detalhes do esquema.

Explorar tabelas e view

Tabelas e view estão contidas em esquemas. A maioria das tabelas no Unity Catalog são apoiadas pelo Delta Lake, mas você também pode ter acesso a tabelas registradas em dados externos. Consulte Quais dados você pode consultar com Databricks?.

view no Catálogo do Unity sempre faz referência a dados em outra tabela.

execute o seguinte comando para ver uma lista de tabelas disponíveis para você.

SHOW TABLES IN catalog_name.schema_name

execute o seguinte comando para ver uma lista de tabelas disponíveis para você.

SHOW VIEWS IN catalog_name.schema_name

Consulte SHOW TABLES e SHOW VIEWS.

Ao selecionar um esquema no Catalog Explorer, você verá uma lista de tabelas e view disponíveis.

Observação

Se o esquema tiver outros objetos de banco de dados, como volumes, talvez seja necessário clicar em Tabelas para expandir a lista de tabelas e view.

Ver conteúdo e detalhes da tabela

Você pode view a maioria dos detalhes da tabela com o Catalog Explorer ou SQL. Alguns detalhes estão disponíveis apenas na UI do Catalog Explorer.

Selecione uma tabela no Catalog Explorer para explorar os detalhes da tabela.

Explorar colunas da tabela

execute o seguinte comando para view as colunas da tabela.

SHOW COLUMNS IN table_name

Consulte SHOW COLUMNS.

Selecione a Colunas para as colunas tab view da tabela.

Ver dados de amostra

execute o seguinte comando para view 1000 registros de uma tabela.

SELECT * FROM table_name LIMIT 1000;

Consulte Consultar dados.

Selecione a Dados tab de view amostra para dados de amostra. Você deve ter acesso à compute ativa para amostrar dados.

Veja detalhes da tabela

execute o seguinte comando para descrever uma tabela.

DESCRIBE TABLE table_name

Execute o seguinte comando para exibir as propriedades de uma tabela.

SHOW TBLPROPERTIES table_name

Consulte DESCRIBE TABLE e SHOW TBLPROPERTIES.

Selecione a Detalhes tab para revisar os detalhes da tabela, incluindo as propriedades da tabela.

Ver tabela história

A tabela história está disponível para tabelas Delta. Todas as tabelas de gerenciamento do Catálogo Unity são tabelas Delta.

execute o seguinte comando para revisar a tabela história.

DESCRIBE HISTORY table_name

Consulte DESCRIBE HISTORY.

Selecione a história tab para revisar a tabela história.

Ver query e usuários frequentes

Se a tabela estiver cadastrada no Unity Catalog, você poderá view a query mais frequente feita na tabela e os usuários que acessaram a tabela nos últimos 30 dias usando o Catalog Explorer. Veja view query frequentes e usuários de uma tabela.

Visualizar relacionamentos de chave primária e chave estrangeira

Para tabelas com key estrangeira definida, clique em Visualizar relacionamentos no canto superior direito da Colunas tab. O Diagrama Entidade-Relacionamento (ERD) é aberto. O ERD exibe os relacionamentos key primária e key estrangeira entre tabelas em um gráfico, fornecendo uma representação clara e intuitiva de como as entidades de dados se conectam.

Para obter mais informações sobre restrições key primária e key estrangeira, consulte Restrições em Databricks.