Gerenciar conexões para a Federação Lakehouse

  • Artigo

Importante

Esse recurso está em uma versão prévia.

Este artigo descreve como listar todas as conexões da Federação de Lakehouse definidas em um metastore do Catálogo do Unity, obter detalhes de conexão, conceder permissões de conexão e remover conexões usando o Explorador do Catálogo e as instruções SQL em notebooks ou o editor de consultas do Databricks SQL.

Consulte também Criar uma conexão.

Listar conexões

Permissões necessárias: a lista de conexões retornadas 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ê poderá exibir apenas as conexões para as quais você é o proprietário do objeto de conexão ou tem algum privilégio.

Explorador do Catálogo

  1. No espaço de trabalho do Azure Databricks, clique em Catalog iconCatá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, juntamente com a URL, a data de criação, o proprietário e o comentário.

Sql

Execute o comando a seguir em um notebook ou no editor de SQL do Databricks. 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, USE CONNECTION privilégio no metastore ou algum privilégio na conexão.

Explorador do Catálogo

  1. No espaço de trabalho do Azure Databricks, clique em Catalog iconCatálogo.
  2. No painel esquerdo, expanda o menu Dados Externos e selecione Conexões.
  3. Localize a conexão e selecione-a para exibir detalhes.

Sql

Execute o comando a seguir em um notebook ou no editor de SQL do Databricks.

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 externos ou para exibir 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 exibir detalhes sobre a conexão.

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

Explorador do Catálogo

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

  1. No workspace do Azure Databricks, clique no Catalog iconCatálogo.

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

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

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

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

  6. Selecione os privilégios que você deseja conceder.

    Consulte as descrições de privilégios na introdução da seção.

  7. Clique em Conceder.

Para revogar um privilégio de conexão:

  1. Siga as etapas anteriores para acessar a guia Permissões da conexão.
  2. Selecione o usuário ou grupo cujo privilégio você deseja revogar.
  3. Clique em Revogar na guia 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 bloco de anotações ou no editor de consultas SQL do Databricks.

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

Para conceder a capacidade de exibir 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>;

Remover conexões

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

Explorador do Catálogo

  1. No espaço de trabalho do Azure Databricks, clique em Catalog iconCatá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 Kebab menu (também conhecido como menu de três pontos) e selecione Excluir.
  5. Na caixa de diálogo de confirmação, clique em Excluir.

Sql

Execute o comando a seguir em um notebook ou no editor de SQL do Databricks.

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