Pesquisar os objetos de banco de dados
Este artigo detalha como você pode descobrir e explorar catálogos, esquemas, tabelas e outros objetos de banco de dados no Azure Databricks. As instruções neste artigo se concentram no retorno de detalhes para objetos de banco de dados nos quais você tem pelo menos o privilégio BROWSE ou SELECT ativo.
Para obter informações gerais sobre os privilégios do Catálogo do Unity, confira Privilégios do Catálogo do Unity e objetos protegíveis. Para obter informações sobre como definir a propriedade e as permissões do esquema, consulte Gerenciar a propriedade de objetos do Catálogo do Unity e Gerenciar privilégios no Catálogo do Unity.
A maioria dos acessos a objetos de banco de dados é governada pelo Catálogo do Unity, mas sua empresa pode usar outra abordagem de governança de dados ou combinar o Catálogo do Unity com outras ACLs de tabela herdadas. Este artigo se concentra em descrever o comportamento de objetos regidos pelo Catálogo do Unity, mas a maioria dos métodos descritos neste artigo também funcionam para objetos de banco de dados que não são regidos pelo Catálogo do Unity.
Este artigo inclui instruções para o Explorador de Catálogo e SQL. Selecione o ícone do 
Catálogo na barra lateral do workspace para acessar o Explorador de Catálogos. Você pode executar comandos SQL de um notebook ou do editor de consultas anexado à computação. Para exibir objetos de banco de dados com o Explorador de Catálogos, você precisa ter pelo menos o privilégio BROWSE nos objetos. Para exibir objetos de banco de dados com SQL, você precisa 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 pelos objetos de banco de dados controlados pelo Catálogo do Unity no Explorador de Catálogos sem computação ativa. Para explorar dados no hive_metastore e em outros catálogos não regidos pelo Catálogo do Unity, você deve anexar à computação com privilégios apropriados.
Filtragem de objetos de banco de dados
Durante a exploração interativa de objetos de banco de dados com o Explorador de Catálogos, você pode usar a caixa de texto fornecida para filtrar os resultados. Cadeias de caracteres correspondentes em nomes de objeto são realçadas, mas apenas entre os objetos de banco de dados visíveis no momento. Para obter uma pesquisa completa de todos os objetos de banco de dados, confira Pesquisar objetos de workspace.
O SQL fornece funcionalidade semelhante, especificando opcionalmente uma cláusula regex_pattern juntamente com uma instrução SHOW, como a seguinte:
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 do Catálogo do Unity.
SQL
Execute o comando a seguir para ver uma lista de catálogos disponíveis para você.
SHOW CATALOGS
Confira SHOW CATALOGS.
Explorador do Catálogo
Ao acessar o Explorador de Catálogos, você verá uma lista de catálogos disponíveis para você.
Selecionar um catálogo
SQL
Execute o comando a seguir para definir seu catálogo atualmente ativo.
USE CATALOG catalog_name
Consulte USAR O CATÁLOGO.
Explorador do Catálogo
Clique em um nome de catálogo para selecioná-lo.
Conferir os detalhes do catálogo
SQL
Execute o comando a seguir para descrever um catálogo.
DESCRIBE CATALOG catalog_name
Confira DESCRIBE CATALOG.
Explorador do Catálogo
Selecione a guia Detalhes para examinar os detalhes do catálogo.
Explorar esquemas
Esquemas são coleções de tabelas, exibições, volumes, funções e modelos no Catálogo do Unity. Esquemas estão contidos em catálogos.
SQL
Execute o comando a seguir para ver uma lista de esquemas disponíveis para você.
SHOW SCHEMAS IN catalog_name
Veja SHOW SCHEMAS.
Explorador do Catálogo
Ao selecionar um catálogo no Explorador de Catálogos, você verá uma lista de esquemas disponíveis.
Selecione um esquema
SQL
Execute o comando a seguir para definir seu esquema atualmente ativo.
USE schema catalog_name.schema_name
Veja USE SCHEMA.
Explorador do Catálogo
Clique em um nome de esquema para selecioná-lo.
Confira os detalhes do esquema
SQL
Execute o comando a seguir para descrever um esquema.
DESCRIBE SCHEMA schema_name
Confira DESCRIBE SCHEMA.
Explorador do Catálogo
Selecione a guia Detalhes para examinar os detalhes do esquema.
Explore as tabelas e exibições
Tabelas e exibições estão contidas em esquemas. A maioria das tabelas no Catálogo do Unity tem o suporte do Delta Lake, mas você também pode ter acesso a tabelas registradas em dados externos. ConfiraQuais dados você pode consultar com o Azure Databricks?.
Exibições no Catálogo do Unity sempre fazem referência a dados em outra tabela.
SQL
Execute o comando a seguir para ver uma lista de esquemas disponíveis para você.
SHOW TABLES IN catalog_name.schema_name
Execute o comando a seguir para ver uma lista de esquemas disponíveis para você.
SHOW VIEWS IN catalog_name.schema_name
Confira SHOW TABLES e SHOW VIEWS.
Explorador do Catálogo
Ao selecionar um esquema no Explorador de Catálogos, você verá uma lista de tabelas e exibições disponíveis.
Observação
Se o esquema tiver outros objetos de banco de dados, como volumes presentes, talvez seja necessário clicar em Tabelas para expandir a lista de tabelas e exibições.
Exibir conteúdo e detalhes da tabela
Você pode exibir a maioria dos detalhes da tabela com o Explorador de Catálogos ou o SQL. Alguns detalhes só estão disponíveis na interface do usuário do Explorador de Catálogo.
Selecione uma tabela no Explorador de Catálogos para explorar os detalhes da tabela.
Explorar colunas da tabela
SQL
Execute o seguinte comando para exibir as colunas da tabela.
SHOW COLUMNS IN table_name
Veja SHOW COLUMNS.
Explorador do Catálogo
Selecione a guia Colunas para exibir colunas de tabela.
Exibir dados de exemplo
SQL
Execute o seguinte comando para exibir 1.000 registros de uma tabela.
SELECT * FROM table_name LIMIT 1000;
Confira Consultar dados.
Explorador do Catálogo
Clique na guia Dados de Exemplo para exibir dados de exemplo. Você deve ter acesso à computação ativa para dados de exemplo.
Confira os detalhes da tabela
SQL
Execute o comando a seguir para descrever uma tabela.
DESCRIBE TABLE table_name
Execute o comando a seguir para exibir as propriedades de uma tabela.
SHOW TBLPROPERTIES table_name
Confira DESCRIBE TABLE e SHOW TBLPROPERTIES.
Explorador do Catálogo
Selecione a guia Detalhes para examinar os detalhes da tabela, incluindo as propriedades da tabela.
Exibir histórico de tabelas
O histórico de tabelas está disponível para tabelas Delta. Todas as tabelas gerenciadas do Catálogo do Unity são tabelas Delta.
SQL
Execute o seguinte comando para examinar as restrições.
DESCRIBE HISTORY table_name
Confira DESCRIBE HISTORY.
Explorador do Catálogo
Selecione a guia Histórico para exibir o histórico da tabela.
Exibir usuários e consultas frequentes
Se a tabela estiver registrada no Unity Catalog, você poderá exibir as consultas mais frequentes feitas na tabela e os usuários que acessaram a tabela nos últimos 30 dias usando o Explorador de Catálogo. Consulte Exibir usuários e consultas frequentes de um tabela.
Exibir relações de chave primária e chave estrangeira
Para tabelas com chaves estrangeiras definidas, clique em Exibir relações
no canto superior direito da guia Colunas. O Diagrama de Relacionamento de Entidades (ERD) está aberto. O ERD exibe as relações de chave primária e chave estrangeira entre tabelas em um grafo, fornecendo uma representação clara e intuitiva de como as entidades de dados se conectam.
Para obter mais informações sobre restrições de chave primária e chave estrangeira, confira Restrições no Azure Databricks.