Acessar e gerenciar consultas salvas

Este artigo descreve como usar a interface do usuário do Azure Databricks para acessar e gerenciar consultas.

Ver consultas

Você pode exibir consultas usando os seguintes métodos:

  • Clique em Ícone do espaço de trabalho Espaço de trabalho na barra lateral. As consultas são visíveis, por padrão, na pasta Início . Os usuários podem organizar consultas em pastas no navegador de espaço de trabalho junto com outros objetos Databricks.
  • Clique em Ícone de consultas Consultas na barra lateral. Os objetos nas janelas Consultas são classificados em ordem cronológica inversa por padrão. Você pode reordenar a lista clicando no cabeçalho da coluna Criado em . Digite na caixa de texto Filtrar consultas para filtrar por Nome, Marca ou Proprietário.

Organizar consultas em pastas no navegador de espaço de trabalho

Você pode organizar consultas em pastas no navegador de espaço de trabalho e outros objetos Databricks. Consulte Navegador de espaço de trabalho.

Transferir a propriedade de uma consulta

Você deve ser um administrador de espaço de trabalho para transferir a propriedade de uma consulta. Não é possível atribuir a propriedade de uma consulta às entidades de serviço e aos grupos. Você também pode transferir a propriedade usando a API de Permissões.

  1. Como administrador do espaço de trabalho, faça logon no seu espaço de trabalho do Azure Databricks.

  2. Na barra lateral, clique em Consultas.

  3. Clique em uma consulta.

  4. Clique no botão Compartilhar no canto superior direito para abrir a caixa de diálogo Compartilhamento .

  5. Clique no ícone de engrenagem no canto superior direito e clique em Atribuir novo proprietário.

    Atribuir novo proprietário

  6. Selecione o usuário ao qual atribuir a propriedade.

  7. Clique em Confirmar.

Configurar permissões de consulta

Os administradores do espaço de trabalho e o criador da consulta recebem automaticamente permissões para controlar quais usuários podem gerenciar e executar consultas. Você deve ter pelo menos a permissão CAN MANAGE em uma consulta para compartilhar consultas.

As consultas suportam dois tipos de configurações de compartilhamento:

  • Executar como visualizador: a credencial do visualizador é usada para executar a consulta. O visualizador também deve ter pelo menos permissões CAN USE no depósito. Os usuários só podem receber a permissão CAN EDIT quando a configuração de compartilhamento estiver definida como Executar como visualizador.
  • Executar como proprietário: a credencial do proprietário é usada para executar a consulta.

Para obter mais informações sobre níveis de permissão de consulta, consulte ACLs de consulta.

  1. Na barra lateral, clique em Consultas.

  2. Clique em uma consulta.

  3. Clique no Botão Partilhar botão no canto superior direito para abrir a caixa de diálogo Compartilhamento .

    Gerenciar permissões de consulta

  4. Siga as etapas com base no tipo de permissão que você deseja conceder:

  5. Pesquise e selecione os grupos e usuários e atribua o nível de permissão.

  6. Clique em Adicionar.

  7. No campo Credenciais de configurações > de compartilhamento na parte inferior, selecione Executar como visualizador ou Executar como proprietário.

Você também pode copiar o link para a consulta na caixa de diálogo Compartilhamento.

Acesso de administrador a todas as consultas

Um usuário administrador do espaço de trabalho do Azure Databricks tem acesso de exibição a todas as consultas no espaço de trabalho. Quando a guia Todas as Consultas é selecionada, um administrador de espaço de trabalho pode exibir e excluir todas as consultas. No entanto, um administrador de espaço de trabalho não pode editar uma consulta quando as credenciais de configuração de compartilhamento estão definidas como Executar como proprietário.

Para ver todas as consultas:

  1. Clique em Ícone de consultas Consultas na barra lateral.
  2. Clique na guia Todas as consultas na parte superior da tela.

Criando consultas em outros ambientes

Você pode criar consultas sem usar a interface do usuário do Azure Databricks usando a API Rest, um conector JDBC/ODBC ou uma ferramenta de parceiro.

Consulte Conectores, bibliotecas, drivers, APIs e ferramentas SQL para executar comandos SQL e procurar objetos de banco de dados no Azure Databricks.

Você também pode criar uma consulta com o provedor Databricks Terraform e databricks_sql_query.

Consulte Parceiros de tecnologia para saber mais sobre as ferramentas de parceiros que você pode usar por meio do Partner Connect.