Pular para o conteúdo principal

Explore 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 Unity Catalog. As instruções nesta página se concentram em retornar detalhes de objetos de banco de dados nos quais você 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.

Esta página inclui instruções para o Catalog Explorer e SQL. Selecione o ícone Catálogo Ícone de dados. do na workspace barra lateral do para acessar o Explorador do Catálogo. É possível executar o comando “ SQL ” a partir de um Notebook ou do editor de consultas anexado a compute. view Para acessar objetos de banco de dados no Catalog Explorer, é necessário ter pelo menos o privilégio " BROWSE " nos objetos. Para view objetos de banco de dados com SQL, é necessário ter pelo menos o privilégio SELECT no objeto, bem como USE CATALOG no catálogo pai e USE SCHEMA no esquema pai. É possível navegar pelos objetos do banco de dados gerenciados pelo Unity Catalog no Catalog Explorer sem o compute ativo. Para explorar os dados no hive_metastore e outros catálogos não regidos por Unity Catalog, é necessário anexar a compute com as permissões adequadas.

Filtrando objetos do banco de dados

Durante a exploração interativa de objetos de banco de dados com o Catalog Explorer, você pode usar a caixa de texto fornecida para filtrar os resultados. As correspondências de strings em nomes de objetos são destacadas, mas somente entre os objetos de banco de dados visíveis no momento. Para uma pesquisa completa de todos os objetos do banco de dados, consulte Search for workspace objects.

O SQL oferece funcionalidade semelhante ao especificar opcionalmente uma cláusula regex_pattern em conjunto com uma instrução SHOW, como a seguinte:

SQL
SHOW TABLES IN schema_name LIKE 'sales_*_fy23'

Solicitar privilégios em um objeto

info

Visualização

Este recurso está em pré-visualização pública.

Se os destinos da solicitação de acesso estiverem configurados no Unity Catalog, é possível solicitar privilégios em objetos nos quais você possui o privilégio " BROWSE " ou um URL direto para o objeto. Também é possível solicitar privilégios diretamente a partir dos erros de permissão negada no Notebook e no editor SQL.

  1. Em Databricks workspace, clique em Ícone de dados. Catalog .

  2. Selecione o objeto, como um catálogo, esquema, tabela ou um view.

  3. Clique em Solicitar permissões .

  4. Selecione os diretores para os quais você está solicitando acesso. É possível solicitar acesso para si mesmo, para uma entidade de serviço, para grupos e para outros usuários.

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

    Se um URL de redirecionamento estiver configurado, você não verá esse formulário. Em vez disso, você é redirecionado para o URL especificado para concluir sua solicitação.

    Solicite acesso a um objeto.

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

Explore os catálogos

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

Execute o comando a seguir para ver uma lista dos catálogos disponíveis para o senhor.

SQL
SHOW CATALOGS

Veja SHOW CATALOGS.

Execute o seguinte comando para definir seu catálogo ativo no momento.

SQL
USE CATALOG catalog_name

Veja USE CATALOG.

Execute o seguinte comando para descrever um catálogo.

SQL
DESCRIBE CATALOG catalog_name

Consulte DESCRIBE CATALOG.

Explore os esquemas

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

Execute o seguinte comando para ver uma lista de esquemas disponíveis para o senhor.

SQL
SHOW SCHEMAS IN catalog_name

Consulte SHOW SCHEMAS.

Selecione um esquema

Execute o seguinte comando para definir o esquema ativo no momento.

SQL
USE schema catalog_name.schema_name

Consulte USE SCHEMA.

Veja os detalhes do esquema

Execute o seguinte comando para descrever um esquema.

SQL
DESCRIBE SCHEMA schema_name

Consulte DESCRIBE SCHEMA.

Explore tabelas e visualize

As tabelas e visualizações estão contidas em esquemas. A maioria das tabelas no Unity Catalog é apoiada pelo Delta Lake, mas o senhor também pode ter acesso a tabelas registradas em dados externos. Consulte Quais dados o senhor pode consultar com o Databricks?

em Unity Catalog sempre fazem referência a dados em outra tabela.

Execute o seguinte comando para ver a lista de tabelas disponíveis para o senhor.

SQL
SHOW TABLES IN catalog_name.schema_name

Execute o seguinte comando para ver a lista de tabelas disponíveis para o senhor.

SQL
SHOW VIEWS IN catalog_name.schema_name

Consulte SHOW TABLES e SHOW VIEWS.

visualizar o conteúdo e os detalhes da tabela

O senhor pode acessar view a maioria dos detalhes da tabela com o Catalog Explorer ou SQL. Alguns detalhes só estão disponíveis na interface do usuário do Catalog Explorer.

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

Explore as colunas da tabela

nota

Os usuários que têm apenas o privilégio BROWSE em um objeto não podem explorar as colunas da tabela usando o comando SHOW COLUMNS SQL.

Execute o seguinte comando para view colunas da tabela.

SQL
SHOW COLUMNS IN table_name

Consulte SHOW COLUMNS.

visualizar dados de amostra

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

SQL
SELECT * FROM table_name LIMIT 1000;

Consulte Dados da consulta.

Explore a tabela uso de dados an LLM

info

Beta

Este recurso está em fase beta.

É possível fazer perguntas em linguagem natural sobre a amostra uso de dados Catalog Explorer. O Assistente gera o SQL com base no contexto dos metadados e nos padrões de uso da tabela. Após a geração da consulta, é possível validá-la e, em seguida, executá-la na tabela subjacente.

Selecione os dados de amostra “ tab ” e faça uma pergunta sobre os dados. É necessário ter acesso a um recurso compute ativo e habilitado. Databricks Assistant ativado.

Explore o uso de dados em LLM.

Veja os detalhes da tabela

nota

Os usuários que têm apenas o privilégio BROWSE em um objeto não podem view detalhes da tabela usando o comando DESCRIBE TABLE SQL .

Execute o seguinte comando para descrever uma tabela.

SQL
DESCRIBE TABLE table_name

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

SQL
SHOW TBLPROPERTIES table_name

Consulte DESCRIBE TABLE e SHOW TBLPROPERTIES.

visualizar histórico da tabela

O histórico da tabela está disponível em Delta tables. Todas as tabelas gerenciar Unity Catalog são tabelas Delta.

o senhor deve executar o seguinte comando para revisar o histórico da tabela.

SQL
DESCRIBE HISTORY table_name

Consulte DESCRIBE HISTORY.

visualizar consultas e usuários frequentes

Se a tabela estiver registrada em Unity Catalog, o senhor poderá view as consultas mais frequentes feitas na tabela e os usuários que acessaram a tabela nos últimos 30 dias usando o Catalog Explorer. Veja a visualização de consultas e usuários frequentes de uma tabela.

Exibir os relacionamentos key primário e key externo

Para tabelas com chave estrangeira definida, clique em view relationships (visualizar relacionamentos) botão visualizar relacionamentos no canto superior direito da página Columns (Colunas ) tab. O Diagrama de Relacionamento de Entidades (ERD) é aberto. O ERD exibe os relacionamentos primários key e externos key entre as tabelas em um gráfico, fornecendo uma representação clara e intuitiva de como as entidades de dados se conectam.

Diagrama de relacionamento entre entidades

Para obter mais informações sobre restrições de key primário e key estrangeiro, consulte Restrições em Databricks. Para obter mais informações sobre diagramas de entidade-relacionamento, consulte Visualizar o diagrama de entidade-relacionamento.