Pular para o conteúdo principal

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 em 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 aos objetos do banco de dados é controlada 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 regidos por Unity Catalog, mas a maioria dos métodos descritos neste artigo também funciona para objetos de banco de dados que não são regidos por Unity Catalog.

Este artigo inclui instruções para o Catalog Explorer e o site SQL. Selecione o ícone Ícone de catálogo Catalog na barra lateral workspace para acessar o Catalog Explorer. O senhor pode executar o SQL comando a partir de um Notebook ou do 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.

nota

O senhor pode navegar pelos objetos de banco de dados administrados pelo Unity Catalog no Catalog Explorer sem estar ativo em compute. Para explorar dados no hive_metastore e em outros catálogos não regidos por Unity Catalog, o senhor deve se conectar a compute com os privilégios apropriados.

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'

Explore os catálogos​

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

Run the following command to see a list of catalogs available to you.

SQL
SHOW CATALOGS

See SHOW CATALOGS.

Run the following command to set your currently active catalog.

SQL
USE CATALOG catalog_name

See USE CATALOG.

Run the following command to describe a catalog.

SQL
DESCRIBE CATALOG catalog_name

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

Run the following command to see a list of schemas available to you.

SQL
SHOW SCHEMAS IN catalog_name

See SHOW SCHEMAS.

Selecione um esquema​

Run the following command to set your currently active schema.

SQL
USE schema catalog_name.schema_name

See USE SCHEMA.

Veja os detalhes do esquema​

Run the following command to describe a schema.

SQL
DESCRIBE SCHEMA schema_name

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

Run the following command to see a list of tables available to you.

SQL
SHOW TABLES IN catalog_name.schema_name

Run the following command to see a list of tables available to you.

SQL
SHOW VIEWS IN catalog_name.schema_name

See SHOW TABLES and 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​

Run the following command to view table columns.

SQL
SHOW COLUMNS IN table_name

See SHOW COLUMNS.

visualizar dados de amostra​

Run the following command to view 1000 records from a table.

SQL
SELECT * FROM table_name LIMIT 1000;

See Query data.

Veja os detalhes da tabela​

Run the following command to describe a table.

SQL
DESCRIBE TABLE table_name

Run the following command to display table properties for a table.

SQL
SHOW TBLPROPERTIES table_name

See DESCRIBE TABLE and 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.

Run the following command to review table history.

SQL
DESCRIBE HISTORY table_name

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

Última atualização em