Colaborar com colegas usando o novo editor SQL

O editor SQL interno na interface do usuário do Azure Databricks foi reprojetado para aprimorar a colaboração e introduzir novos recursos para aumentar a velocidade de desenvolvimento do SQL. Grande parte da funcionalidade básica de consulta e visualização permanece a mesma do editor SQL clássico.

Este artigo explica como acessar o novo editor SQL, gerenciar consultas e permissões e usar os novos recursos disponíveis na interface do usuário. Para saber mais sobre a funcionalidade básica, como criação de consultas, navegação de dados disponíveis e criação de visualizações, consulte Escrever consultas e explorar dados no editor SQL.

Acesse o novo editor SQL

Se o novo editor de consultas estiver habilitado para seu espaço de trabalho, uma alternância Novo editor SQL será exibida à direita dos seletores suspensos de catálogo e esquema. Em exibições estreitas, é possível encontrar a alternância Novo editor SQL clicando no menu kebab à direita dos seletores de catálogo e esquema.

É possível habilitar o novo editor para qualquer consulta de sua propriedade. Para fazer isso, execute as seguintes etapas:

• Clique em Novo editor SQL: DESATIVADO. Uma janela emergente Novo editor SQL é aberto.
  • A caixa de seleção Aplicar a todas as minhas consultas está marcada por padrão. Mantenha essa configuração para habilitar o editor para todas as consultas que você possui.
  • Para habilitar o novo editor somente para a consulta ativa, desmarque a caixa de seleção Aplicar a todas as minhas consultas.
• Defina a alternância Novo editor SQL como ON.

O novo editor SQL não pode ser usado para todas as consultas. Não é possível alternar para o novo editor SQL para uma consulta se qualquer uma das seguintes condições for verdadeira:

• Você não é o proprietário da consulta.
• A consulta contém os tipos de parâmetro Lista suspensa baseada em consulta ou Intervalo, que não têm suporte. Confira Trabalhar com parâmetros de consulta.

Quando você ativa o novo editor SQL, sua consulta é reaberta na nova interface do usuário. O conjunto de resultados ficará vazio até que você execute a consulta.

Compartilhar uma consulta

As permissões para compartilhar consultas no novo editor permanecem praticamente inalteradas, com algumas diferenças para dar suporte à colaboração Live. Consulte Configurar permissões de consulta para saber mais sobre as configurações de credencial Executar como proprietário e Executar como visualizador. Consulte ACLs de consulta para saber como gerenciar o acesso ao objeto de consulta.

O novo editor SQL processa as permissões em duas partes:

Execução interativa: as consultas no novo editor SQL sempre são executadas usando as credenciais de Executar como visualizador. Os resultados da consulta podem ser acessados por qualquer pessoa que tenha acesso à consulta. Os usuários com permissões CAN EDIT ou superiores podem modificar o rascunho da consulta compartilhada. Além disso, as edições não salvas ficam visíveis para qualquer pessoa com permissões CAN VIEW ou superiores. Você deve ter pelo menos a permissão CAN USE em no depósito correspondente para executar consultas.

Configurações de credenciais As configurações de permissão para alertas, fluxos de trabalho e dashboards herdados são as mesmas do editor SQL clássico. Dependendo de suas preferências, esses ativos podem ser executados usando as credenciais do proprietário ou do visualizador.

Realizar controle do código-fonte de uma consulta

Os arquivos de consulta SQL do Databricks (extensão: .dbquery.ipynb) são compatíveis com pastas Git do Databricks. Você pode usar uma pasta Git para controlar os arquivos de consulta e compartilhá-los em outros workspaces com pastas Git que acessam o mesmo repositório Git. Se você optar por não usar o novo editor de SQL depois de confirmar ou clonar uma consulta em uma pasta Git do Databricks, exclua e reclone essa pasta Git para evitar comportamentos inesperados.

Salvar uma consulta

O conteúdo da consulta no novo editor SQL tem salvamento automático continuamente. O botão Salvar controla se o conteúdo da consulta de rascunho deve ser aplicado a ativos relacionados, como painéis herdados, fluxos de trabalho ou alertas. Se a consulta for compartilhada com a credencial Executar como proprietário, somente o proprietário da consulta poderá usar o botão Salvar para propagar as alterações. Se a credencial estiver definida como Executar como visualizador, qualquer usuário com pelo menos a permissão CAN MANAGE poderá salvar a consulta.

Colaborar em consultas em tempo real

Depois de compartilhar a consulta, é possível cocriar ou depurar consultas ao vivo por meio da edição colaborativa. Os editores também podem comentar em linhas de código individuais para fazer perguntas ou adicionar sugestões.

Orientação

Esta seção destaca as principais diferenças na interface do usuário e explica como localizar e usar os recursos disponíveis.

1. Acessar o sistema de arquivo de espaço de trabalho: você pode acessar e organizar seus objetos do espaço de trabalho diretamente do editor SQL.
2. Usar o Assistente do Databricks integrado: converse com o assistente para ajudar você a escrever, refinar ou entender consultas. Execute o código gerado pelo assistente no painel lateral.
3. Recolher seções de código: clique na seta de recolhimento à esquerda de um bloco de código para ocultar e expandir seletivamente as seções de código. Isso pode facilitar o trabalho com arquivos grandes.
4. Abrir a paleta de comandos: a paleta de comandos inclui ações comuns, atalhos de teclado, temas personalizados e links para ajudar você a encontrar rapidamente o que precisa. Depois de abri-lo, use a barra de pesquisa para procurar ferramentas e atalhos específicos.
5. Comentar no código: adicione comentários ao código para aprimorar a colaboração.
6. Examinar o histórico de versões: examine as alterações recentes em sua consulta.

Usar atalhos de teclado

O novo editor do SQL inclui muitos atalhos de teclado internos para ajudá-lo a trabalhar rapidamente. A tabela a seguir identifica atalhos de teclado comumente usados.

Explorar todos os resultados

É possível comparar a saída de cada instrução com várias instruções de resultado. Ao executar várias instruções SQL em uma única janela de edição, você pode usar a interface do usuário no painel Saída próximo à parte inferior da tela para rolar pelos diferentes conjuntos de resultados.

Alterações de sintaxe de parâmetro

As consultas que usam chaves duplas ({{}}) para indicar parâmetros devem ser modificadas para serem executadas no novo editor SQL. O novo editor SQL usa a mesma sintaxe de parâmetro que outras ferramentas do Databricks, como dashboards de IA/BI, IA/BI Genie e notebooks.

Os parâmetros no novo editor SQL são definidos usando a sintaxe de parâmetro nomeado. Parâmetros nomeados são parâmetros em uma consulta prefixados com dois-pontos, por exemplo :parameter_name.

Consulte Marcadores de parâmetro nomeados para obter a documentação de referência do SQL. Consulte Exemplos de sintaxe de parâmetro nomeado para obter exemplos de conversão de sintaxe de parâmetro do editor SQL clássico para marcadores de parâmetro nomeado.

Desabilitar o novo editor SQL

Para desabilitar o novo editor SQL, execute as seguintes etapas:

• Clique em Novo editor SQL: ATIVADO. Uma janela emergente Novo editor SQL é aberto.
• Defina a alternância Novo Editor SQL como OFF.
• Na caixa de diálogo de confirmação, opte por desabilitar o novo editor somente para a consulta ativa ou para todas as consultas qualificadas.
  • A opção Desabilitar para todas as consultas qualificadas não está marcada. Mantenha essa configuração se quiser desabilitar o novo editor apenas para a consulta ativa.
  • Para desabilitar o novo editor SQL para todas as suas consultas, marque a caixa de seleção Desabilitar para todas as consultas qualificadas.

Os administradores do espaço de trabalho podem desativar a visualização no nível do espaço de trabalho visitando o portal de visualização. Consulte Gerenciar Versões Prévias do Azure Databricks.