Partilhar via

Gerenciar connections para Lakehouse Federation

  • Artigo

Este artigo descreve como list todos os connections de Federação Lakehouse definidos em um metastore do Unity Catalog, detalhes de conexão get, permissões de conexão grant e soltar connections usando instruções Catalog Explorer e SQL em blocos de anotações ou o editor de consultas SQL Databricks. Uma ligação é um objeto seguro no Unity Catalog que especifica um caminho e credentials para aceder a 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.

List connections

Permissões necessárias: O list de connections retornado depende da sua função e das suas permissões. Os utilizadores com o privilégio de USE CONNECTION no metastore veem todos os connections. Caso contrário, você pode exibir apenas o connections para o qual você é o proprietário do objeto de conexão ou tem algum privilégio.

Catalog Explorer

  1. No seu espaço de trabalho do Azure Databricks, clique Catalog íconeCatalog.

  2. Na parte superior do painel Catalog, clique no ícone de engrenagem e, em seguida, no menu selectConnections.

    Como alternativa, na página de acesso rápido, clique no botão de dados externos > e vá para o separador Connections.

    Os connections que você tem permissão para ver são listados, 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>];

Detalhes da conexão Get

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

Catalog Explorer

  1. No seu espaço de trabalho do Azure Databricks, clique Catalog íconeCatalog.

  2. Na parte superior do painel Catalog, clique no ícone de engrenagem e selecione a opção selectConnections do menu.

    Como alternativa, na página de acesso rápido , clique no botão dados externos > e vá para o separador Connections.

  3. Encontre a conexão e select-la para ver detalhes.

SQL

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

DESCRIBE CONNECTION <connection-name>;

Permissões Grant e revoke no connections

Você pode grant permissão para usar uma conexão para criar catalogs estrangeiros ou para exibir detalhes sobre uma conexão:

  • CREATE FOREIGN CATALOG concede a possibilidade de criar um catalog externo como uma réplica de leitura apenas de um banco de dados na origem de dados descrita pela ligação.
  • USE CONNECTION concede a habilidade de usar a conexão no Delta Live Tables para importar dados de uma origem de dados para o Azure Databricks. No entanto, se concedido ao nível do metastore, isso só permite visualizar os detalhes do connections no metastore. Os usuários ainda devem receber USE CONNECTION em connections individuais para usá-los.

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

Catalog Explorer

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

  1. No seu espaço de trabalho do Azure Databricks, clique Catalog íconeCatalog.

  2. Na parte superior do painel Catalog, clique no ícone de engrenagem ícone de engrenagem e selectConnections no menu.

    Como alternativa, na página de acesso rápido, clique no botão dados externos > e vá para o separador Connections.

  3. Encontre a conexão e select-la.

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

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

  6. Select os privilégios que deseja grant.

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

  7. Clique em Grant.

Para revoke um privilégio de conexão:

  1. Siga as etapas anteriores para get para o separador Permissões da conexão.
  2. Select o usuário ou grupo cujo privilégio você deseja revoke.
  3. Clique Revoke tanto na guia como na caixa de diálogo de confirmação.

SQL

Para grant a capacidade de criar um catalog estrangeiro utilizando uma conexão, execute o seguinte comando num notebook ou no editor de consultas SQL do Databricks.

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

Para grant a capacidade de exibir a conexão, execute o seguinte:

GRANT USE CONNECTION ON CONNECTION <connection-name> TO <user-name>;

Para executar um privilégio revoke, siga o seguinte comando. where<privilege> é um dos privilégios na conexão concedida ao utilizador.

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

Soltar connections

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

Catalog Explorer

  1. No seu espaço de trabalho do Azure Databricks, clique Catalog íconeCatalog.

  2. Na parte superior do painel Catalog, clique no ícone de engrenagem ícone de engrenagem e selectConnections no menu.

    Como alternativa, na página de acesso rápido, clique no botão dados externos > e vá para o separador Connections.

  3. Encontre a conexão e select-la.

  4. Clique no menu Kebab menu kebab e selectExcluir.

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