Partilhar via

Gerenciar conexões para Lakehouse Federation

  • Artigo

Este artigo descreve como listar todas as conexões Lakehouse Federation definidas em um metastore do 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 em blocos de anotações ou o editor de consultas Databricks SQL. Uma conexão é um objeto protegível no Unity Catalog que especifica um caminho e credenciais para acessar um sistema de base de dados externo.

Consulte também Criar uma conexão.

Se preferir usar a API REST, consulte a 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ê pode exibir apenas as conexões para as quais você é o proprietário do objeto de conexão ou tem algum privilégio.

Explorador de Catálogos

  1. No seu espaço de trabalho do Azure Databricks, clique em CatálogoCatálogo.

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

    Como alternativa, na página Acesso rápido, clique no botão Dados externos > e vá para o separador Conexões.

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

SQL

Execute o seguinte comando em um bloco de anotações ou no editor de consultas Databricks SQL. Opcionalmente, substitua <pattern> por um LIKE predicado.

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 de Catálogos

  1. No seu espaço de trabalho do Azure Databricks, clique no ícone do CatálogoCatálogo.

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

    Como alternativa, na página Acesso rápido, clique no botão Dados externos > e vá para o separador Conexões.

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

SQL

Execute o seguinte comando em um bloco de anotações ou no editor de consultas 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 exibir detalhes sobre uma conexão:

  • CREATE FOREIGN CATALOG concede a possibilidade de criar um catálogo externo como uma cópia de leitura única de um banco de dados na fonte de dados descrita pela conexão.
  • USE CONNECTION concede a capacidade de usar a conexão em DLT para ingerir dados da fonte de dados no Azure Databricks. No entanto, se concedido no nível do metastore, ele só permite visualizar os detalhes das conexões no metastore. Os utilizadores ainda devem receber USE CONNECTION em conexões individuais para usá-las.

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

Explorador de Catálogos

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

  1. No seu espaço de trabalho do Azure Databricks, clique no ícone do CatálogoCatálogo.

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

    Como alternativa, na página Acesso rápido, clique no botão Dados externos > e vá para o separador 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 ao <connection-name>, comece a digitar o nome do utilizador ou do grupo, ou clique no menu do utilizador para procurar e selecionar utilizadores e grupos.

  6. Selecione os privilégios que deseja conceder.

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

  7. Clique Conceder.

Para revogar um privilégio de conexão:

  1. Siga as etapas anteriores para chegar ao separador 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 estrangeiro usando uma conexão, execute o seguinte comando em um bloco de anotações ou no editor de consultas Databricks SQL.

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>;

Desconectar conexões

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

Explorador de Catálogos

  1. No seu espaço de trabalho do Azure Databricks, clique no ícone do CatálogoCatálogo.

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

    Como alternativa, na página Acesso rápido, clique no botão Dados externos > e vá para o separador Conexões.

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

  4. Clique no menu Kebab menu kebab e selecione Excluir.

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

SQL

Execute o seguinte comando em um bloco de anotações ou no editor de consultas Databricks SQL.

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