gerenciar conexões para a lakehouse Federation

Este artigo descreve como listar todas as conexões da Lakehouse Federation definidas em um metastore Unity Catalog, obter detalhes da conexão, conceder permissões de conexão e descartar conexões usando o Catalog Explorer e as instruções SQL no Notebook ou no editor de consultas Databricks SQL. Uma conexão é um objeto seguro no Unity Catalog que especifica um caminho e credenciais para acessar um sistema de banco de dados externo.

Consulte também Criar uma conexão.

Se o senhor preferir usar a API REST, consulte a documentação de referência da Databricks.

Listar conexões

Permissões necessárias : a lista de conexões retornadas depende de sua função e permissões. Usuários com o privilégio USE CONNECTION no metastore veem todas as conexões. Caso contrário, o senhor pode view apenas as conexões das quais é o proprietário do objeto de conexão ou tem algum privilégio.

Catalog Explorer

1. Em seu site Databricks workspace, clique em Catalog .

2. Na parte superior do painel Catálogo , clique no ícone de engrenagem e selecione Conexões no menu.

   Como alternativa, na página de acesso rápido , clique no botão External data (Dados externos ) > e vá para Connections (Conexões ) tab.

   As conexões que você tem permissão para ver estão listadas, junto com o URL, a data de criação, o proprietário e o comentário.

SQL

Execute o seguinte comando em um Notebook ou no editor de consultas Databricks SQL. Opcionalmente, substitua <pattern> por um predicadoLIKE.

SQL

SHOW CONNECTIONS [LIKE <pattern>];

Obtenha detalhes da conexão

Permissões necessárias : proprietário da conexão, privilégio USE CONNECTION na metastore ou algum privilégio na conexão.

Catalog Explorer

1. Em seu site Databricks workspace, clique em Catalog .

2. Na parte superior do painel Catálogo , clique no ícone de engrenagem e selecione Conexões no menu.

   Como alternativa, na página de acesso rápido , clique no botão External data (Dados externos ) > e vá para Connections (Conexões ) tab.

3. Localize a conexão e selecione-a para acessar view details.

SQL

Execute o seguinte comando em um notebook ou no editor de consultas SQL do Databricks.

SQL

DESCRIBE CONNECTION <connection-name>;

Conceder e revogar permissões em conexões

O senhor pode conceder permissão para usar uma conexão para criar catálogos estrangeiros ou para view detalhes sobre uma conexão:

• CREATE FOREIGN CATALOG concede a capacidade de criar um catálogo externo como um espelho somente leitura de um banco de dados na fonte de dados descrita pela conexão.
• USE CONNECTION Permite usar a conexão no pipeline declarativo LakeFlow Spark para ingerir dados da fonte de dados no Databricks. No entanto, se concedida no nível do metastore, ela permite apenas a visualização dos detalhes das conexões no metastore. Os usuários ainda precisam ter permissão USE CONNECTION em conexões individuais para usá-las.

Permissões necessárias : administrador do Metastore ou proprietário da conexão.

Catalog Explorer

Para conceder permissão para usar uma conexão:

1. Em seu site Databricks workspace, clique em Catalog .

2. Na parte superior do painel Catálogo , clique no ícone de engrenagem e selecione Conexões no menu.

   Como alternativa, na página de acesso rápido , clique no botão External data (Dados externos ) > e vá para Connections (Conexões ) tab.

3. Encontre a conexão e selecione-a.

4. Em Permissions (Permissões ) tab, clique em Grant (Conceder ).

5. Na caixa de diálogo Grant on <connection-name> , comece a digitar o nome do usuário ou do grupo ou clique no menu do usuário para procurar e selecionar usuários e grupos.

6. Selecione os privilégios que deseja conceder.

   Veja as descrições dos privilégios na introdução da seção.

7. Clique em Conceder .

Para revogar um privilégio de conexão:

1. Siga as passos anteriores para acessar a tab Permissões da conexão.
2. Selecione o usuário ou grupo cujo privilégio você deseja revogar.
3. Clique em Revoke (Revogar ) no site tab e na caixa de diálogo de confirmação.

SQL

Para conceder a capacidade de criar um catálogo externo usando uma conexão, execute o seguinte comando em um Notebook ou no editor de consultas Databricks SQL.

SQL

GRANT CREATE FOREIGN CATALOG ON CONNECTION <connection-name> TO <user-name>;

Para conceder a capacidade de view a conexão, execute o seguinte:

SQL

GRANT USE CONNECTION ON CONNECTION <connection-name> TO <user-name>;

Para revogar um privilégio, execute o seguinte, em que <privilege> é um dos privilégios na conexão concedida ao usuário:

SQL

REVOKE <privilege> ON CONNECTION <connection-name> FROM <user-name>;

Descarte conexões

Permissões necessárias : Proprietário da conexão

Catalog Explorer

1. Em seu site Databricks workspace, clique em Catalog .

2. Na parte superior do painel Catálogo , clique no ícone de engrenagem e selecione Conexões no menu.

   Como alternativa, na página de acesso rápido , clique no botão External data (Dados externos ) > e vá para Connections (Conexões ) tab.

3. Encontre a conexão e selecione-a.

4. Clique no menu kebab e selecione Excluir.

5. Na caixa de diálogo de confirmação, clique em Excluir .

SQL

Execute o seguinte comando em um notebook ou no editor de consultas SQL do Databricks.

SQL

DROP CONNECTION [IF EXISTS] <connection-name>;