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
- SQL
-
Em seu site Databricks workspace, clique em
Catalog .
-
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.
Execute o seguinte comando em um Notebook ou no editor de consultas Databricks SQL. Opcionalmente, substitua <pattern>
por um predicadoLIKE
.
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
- SQL
-
Em seu site Databricks workspace, clique em
Catalog .
-
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.
-
Localize a conexão e selecione-a para acessar view details.
Execute o seguinte comando em um notebook ou no editor de consultas SQL do Databricks.
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
concede a capacidade de usar a conexão no DLT para ingerir dados da fonte de dados em Databricks. No entanto, se concedido no nível do metastore, ele só permite visualizar os detalhes das conexões no metastore. Os usuários ainda precisam receberUSE CONNECTION
em conexões individuais para usá-las.
Permissões necessárias : administrador do Metastore ou proprietário da conexão.
- Catalog Explorer
- SQL
Para conceder permissão para usar uma conexão:
-
Em seu site Databricks workspace, clique em
Catalog .
-
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.
-
Encontre a conexão e selecione-a.
-
Em Permissions (Permissões ) tab, clique em Grant (Conceder ).
-
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. -
Selecione os privilégios que deseja conceder.
Veja as descrições dos privilégios na introdução da seção.
-
Clique em Conceder .
Para revogar um privilégio de conexão:
- Siga as passos anteriores para acessar a tab Permissões da conexão.
- Selecione o usuário ou grupo cujo privilégio você deseja revogar.
- Clique em Revoke (Revogar ) no site tab e na caixa de diálogo de confirmação.
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.
GRANT CREATE FOREIGN CATALOG ON CONNECTION <connection-name> TO <user-name>;
Para conceder a capacidade de view a conexão, execute o seguinte:
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:
REVOKE <privilege> ON CONNECTION <connection-name> FROM <user-name>;
Descarte conexões
Permissões necessárias : Proprietário da conexão
- Catalog Explorer
- SQL
-
Em seu site Databricks workspace, clique em
Catalog .
-
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.
-
Encontre a conexão e selecione-a.
-
Clique no menu kebab e selecione Excluir.
-
Na caixa de diálogo de confirmação, clique em Excluir .
Execute o seguinte comando em um notebook ou no editor de consultas SQL do Databricks.
DROP CONNECTION [IF EXISTS] <connection-name>;