Compartilhar via

Gerenciar conexões para a Federação Lakehouse

  • Artigo

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. Uma conexão é um objeto protegível no Catálogo do Unity que especifica um caminho e credenciais para acessar um sistema de banco de dados externo.

Consulte também Criar uma conexão.

Se preferir usar a API REST, consulte Documentação de referência do Azure Databricks.

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 workspace do Azure Databricks, clique em Ícone do catálogo Catálogo.

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

    Como alternativa, na página Acesso rápido, clique no botão Dados externos > e acesse a guia 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 workspace do Azure Databricks, clique em Ícone do catálogo Catálogo.

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

    Como alternativa, na página Acesso rápido, clique no botão Dados externos > e acesse a guia 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 usar a conexão no Delta Live Tables para ingerir dados da fonte de dados no Azure Databricks. No entanto, se concedido no nível do metastore, só será permitido exibir os detalhes das conexões no metastore. Os usuários ainda devem ter permissão de USE CONNECTION em conexões individuais para usá-los.

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 em Ícone do catálogo Catálogo.

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

    Como alternativa, na página Acesso rápido, clique no botão Dados externos > e acesse a guia 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 workspace do Azure Databricks, clique em Ícone do catálogo Catálogo.

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

    Como alternativa, na página Acesso rápido, clique no botão Dados externos > e acesse a guia Conexões.

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

  4. Clique no menu menu kebab kebab 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>;