Executar e compartilhar consultas no novo editor do SQL

Esta página explica como executar consultas, compartilhá-las com colaboradores e editá-las em conjunto em tempo real.

Executar uma única consulta ou consultas com várias instruções

Você pode escrever consultas múltiplas em uma única guia do editor de consultas. Para usar várias consultas em uma única guia, encerre cada consulta com um ponto-e-vírgula (;).

Para executar uma única consulta:

1. Selecione um SQL warehouse.
2. Realçar uma consulta no Editor SQL (se várias consultas estiverem no painel de consulta).
3. Pressione Ctrl/Cmd + Enter ou clique em Executar (1000) para exibir os resultados como uma tabela no painel de resultados.

Note

Por padrão, execute todas as instruções e o Limite 1000 estão selecionados.

• Para executar apenas a instrução ativa, desmarque Executar todas as instruções.
• Se uma consulta for salva com a configuração Limite 1000 , essa configuração se aplicará a todas as execuções de consulta. Para retornar todas as linhas (até 64.000 linhas ou 10 MB, o que for menor), limpe LIMIT 1000 do menu suspenso Executar (1000). Para especificar um limite diferente no número de linhas, adicione uma LIMIT cláusula em sua consulta.

Encerrar uma consulta

Para encerrar uma consulta enquanto ela estiver em execução, clique em Cancelar. Um administrador pode interromper uma consulta em execução iniciada por outro usuário exibindo a consulta Encerrar uma execução.

Copiar a ID da consulta herdada

Para obter a ID de consulta herdada de uma consulta que você migrou para o novo editor do SQL, copie-a do menu Arquivo . A ID de consulta herdada pode ser útil para chamadas à API ou outras integrações que fazem referência a ela.

1. Abra a consulta no novo editor do SQL.
2. Clique no ícone do Na parte superior do editor.
3. Clique em Arquivo> e Copiar ID de consulta herdada.

Abra uma consulta a partir do ID de consulta legado

Se você tem um ID de consulta legado, pode abrir a consulta diretamente no editor SQL anexando o ID à URL do seu espaço de trabalho:

https://<databricks-instance>/editor/queries/uuid/<legacy-query-id>

Substitua <databricks-instance> pela URL do seu espaço de trabalho e <legacy-query-id> pelo ID de consulta antigo. O Databricks resolve o ID e abre a consulta.

Note

Se a consulta ainda não estiver ativada para o novo editor SQL, ela abre no editor SQL legado. Use o botão do novo editor SQL para mudar para o novo editor.

Compartilhar uma consulta

O novo editor SQL lida com permissões em duas partes:

Execução interativa: as consultas no novo editor do SQL sempre são executadas usando as credenciais 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 são visíveis para qualquer pessoa com permissões CAN VIEW ou superior. Os usuários devem ter pelo menos a permissão CAN USE no warehouse associado para executar consultas.

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

Consulte Configurar permissões de consulta para saber mais sobre as configurações de credenciais Executar como proprietário e Executar como visualizador. Consulte ACLs de consulta para saber como gerenciar o acesso ao objeto de consulta.

Colaborar em consultas em tempo real

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