gerencia conexões para Lakehouse Federation

Este artigo descreve como listar todas as conexões da 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 as instruções SQL no Notebook ou no editor de consultas Databricks SQL. Uma conexão é um objeto seguro no Unity Catalog que especifica um caminho e credenciais para acessar um sistema de banco de dados externo.

Consulte também Criar uma conexão.

Se o senhor preferir usar a API REST, consulte a documentação de referência da Databricks.

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

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

    Como alternativa, na página de acesso rápido, clique no botão External data > e vá para Connections tab.

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

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

    Como alternativa, na página de acesso rápido, clique no botão External data > e vá para Connections tab.

  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 usar a conexão em Delta Live Tables para ingerir dados da fonte de dados em Databricks. No entanto, se concedida no nível do metastore, ela só permite a visualização dos detalhes das conexões no metastore. Os usuários ainda devem receber USE CONNECTION em conexões individuais para usá-los.

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

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

    Como alternativa, na página de acesso rápido, clique no botão External data > e vá para Connections tab.

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

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

    Como alternativa, na página de acesso rápido, clique no botão External data > e vá para Connections tab.

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

  4. Clique no menu Menu Kebab kebab e selecione Delete (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>;