gerencia conexões para Lakehouse Federation

Visualização

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

Este artigo descreve como listar todas as conexões de Federação lakehouse 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 instruções SQL no Notebook ou no query Databricks SQL .

Consulte também Criar uma conexão.

Listar conexões

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

1. No seu workspace do Databricks, clique em Catálogo.

2. No painel esquerdo, expanda o menu Dados externos e selecione Conexões.

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

execução do seguinte comando em um Notebook ou no editor query Databricks SQL . Opcionalmente, substitua <pattern> por um predicado `LIKE`.

SHOW CONNECTIONS [LIKE <pattern>];

Obter detalhes da conexão

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

1. No seu workspace do Databricks, clique em Catálogo.

2. No painel esquerdo, expanda o menu Dados externos e selecione Conexões.

3. Encontre a conexão e selecione-a para view os detalhes.

execução do seguinte comando em um Notebook ou no editor query Databricks SQL .

DESCRIBE CONNECTION <connection-name>;

Conceder e revogar permissões em conexões

Você 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 view detalhes sobre a conexão.

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

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

1. No seu workspace do Databricks, clique em Catálogo.

2. No painel esquerdo, expanda o menu Dados externos e selecione Conexões.

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

4. Na tab Permissões , clique em Conceder .

5. Na caixa de diálogo Conceder em <connection-name> , comece a digitar o nome do usuário ou grupo ou clique no menu do usuário para navegar 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 Revogar na 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 query 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, onde <privilege> é um dos privilégios na conexão concedida ao usuário:

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

Descartar conexões

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

1. No seu workspace do Databricks, clique em Catálogo.

2. No painel esquerdo, expanda o menu Dados externos e selecione Conexões.

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

4. Clique no menu kebab (também conhecido como menu de três pontos) e selecione Excluir.

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

execução do seguinte comando em um Notebook ou no editor query Databricks SQL .

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