Pesquisar os objetos de banco de dados

Esta página detalha como você pode descobrir e explorar catálogos, esquemas, tabelas e outros objetos de banco de dados no Catálogo do Unity. As instruções nesta página se concentram no retorno de detalhes para objetos de banco de dados nos quais você tem pelo menos o privilégio ou BROWSE o SELECT privilégio.

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.

Esta página inclui instruções para o Gerenciador de Catálogos e o SQL. Selecione o Ícone de catálogo na barra lateral do workspace para acessar o Gerenciador 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. 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'

Solicitar privilégios em um objeto

Se os destinos de solicitação de acesso estiverem configurados no Catálogo do Unity, você poderá solicitar privilégios em objetos em que tenha o BROWSE privilégio ou uma URL direta para o objeto. Você também pode solicitar privilégios diretamente de erros de permissão negados em notebooks e no editor do SQL.

Se você tiver ALL PRIVILEGES em um objeto, não poderá solicitar acesso em nome de outras pessoas usando o Catalog Explorer. Em vez disso, use a API Criar Solicitações de Acesso.

1. No workspace do Azure Databricks, clique no Catálogo.

2. Selecione o objeto, como um catálogo, esquema, tabela ou exibição.

3. Clique em Solicitar permissões.

4. Selecione as entidades de segurança para as quais você está solicitando acesso. Você pode solicitar acesso para si mesmo, entidades de serviço, grupos e outros usuários.

5. Selecione os privilégios e, opcionalmente, adicione uma mensagem aos aprovadores.

   Se uma URL de redirecionamento estiver configurada, você não verá esse formulário. Em vez disso, você é redirecionado para a URL especificada para concluir sua solicitação.

   

6. Clique em Solicitação. Uma mensagem é enviada aos aprovadores configurados com sua solicitação de acesso.

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

Consulte 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 USE CATALOG.

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

Consulte 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

Consulte 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

Consulte 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

Consulte 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

Consulte 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.

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

Consulte 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;

Veja 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.

Explorar os dados de tabela usando uma LLM

Você pode fazer perguntas de linguagem natural sobre os dados de exemplo usando o Gerenciador de Catálogos. O Assistente gera o SQL com base no contexto de metadados e nos padrões de uso da tabela. Depois que a consulta for gerada, você poderá validar a consulta e executá-la na tabela subjacente.

Selecione a guia Dados de Exemplo e faça uma pergunta sobre os dados. Você deve ter acesso a um recurso de computação em funcionamento e recursos de IA impulsionados por parceiros habilitados.

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

Consulte 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

Consulte 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. Para obter mais informações sobre diagramas de relação de entidade, consulte Exibir o Diagrama de Relação de Entidade.