# Explorando dados com o SQL Workbench Use o SQL Workbench para solucionar problemas de dados e para desenvolver consultas SQL. Você pode explorar dados e validar SQL em tarefas preparadas e camadas de armazém de dados no contexto de um projeto. O SQL Workbench está disponível para projetos de pipeline de dados que usam um armazém de dados. Você executa consultas no armazém de dados conectado ao projeto. Nota informativaProjetos de replicação, projetos de pipeline de dados com o Qlik Cloud como destino e projetos Qlik Open Lakehouse não são suportados. Em projetos compatíveis, você pode visualizar e adicionar tarefas espelho em projetos do Qlik Open Lakehouse a montante. ## Limitações * Apenas consultas SQL somente leitura são suportadas. Instruções de modificação de dados são bloqueadas. * Zonas de aterrissagem no lake e datamarts de conhecimento não são suportados no navegador de objetos. * Macros não são suportadas. Se uma transformação incluir macros, a transformação de carregamento total será mostrada em Consulta de origem. ## Permissões necessárias * Para executar consultas, você deve ter Pode visualizar dados no espaço onde reside a conexão do projeto. * Para salvar, editar, renomear ou excluir scripts SQL, você deve ter Pode editar no espaço do projeto. Para obter mais informações sobre funções de espaço, consulte [Funções e permissões do espaço de dados](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataSpaces/permissions-data-space.htm). ## Abrindo o SQL Workbench Abra o SQL Workbench em um projeto de pipeline de dados. O SQL Workbench sempre é executado no contexto do projeto atual. * Clique em SQL Workbench no menu superior. Nota informativaSe você não vir o SQL Workbench, verifique o tipo de projeto e as permissões. ## Navegando por tabelas Tabelas lista as tabelas de tarefas preparadas em: * O projeto atual. * Projetos referenciados na mesma plataforma de dados. Somente tabelas físicas em esquemas externos são exibidas. Para projetos do Qlik Open Lakehouse, Tabelas lista tarefas espelho do projeto atual e de projetos referenciados. O SQL Workbench exibe apenas tarefas espelho que correspondem ao tipo de lakehouse do projeto: Snowflake, Redshift ou Databricks. Para cada tabela, você pode visualizar o banco de dados, esquema, colunas e tipos de dados. Nota informativaSe uma tarefa não estiver preparada, ela não será exibida em Tabelas. * Clique em Filtrar por tipo de tarefa para filtrar as tarefas. * Clique em Classificar e agrupar para organizar as tarefas e definir uma ordem de classificação. ### Adicionando mais projetos Desde o início, você verá apenas tarefas do projeto atual. Você pode adicionar mais projetos para poder usá-los em sua consulta. * Clique em the adicionar icon para adicionar mais projetos a serem disponibilizados. Você pode selecionar projetos que usam o mesmo armazém de dados. Selecione os projetos e clique em Aplicar. Todas as tarefas preparadas nos projetos selecionados estão agora disponíveis. Para projetos do Qlik Open Lakehouse, o SQL Workbench exibe apenas tarefas espelho que correspondem ao tipo de lakehouse do projeto. ## Criando consultas Você pode usar uma ou mais abas para escrever SQL e executar instruções selecionadas ou a instrução atual. Cada guia é executada em sua própria sessão, o que permite a execução paralela de consultas. Ao editar a consulta, você pode usar as seguintes ferramentas: * the Desfazer icon Desfazer a edição anterior * the Desfazer icon Refazer o que foi desfeito anteriormente * the Formatação automática icon Formatar automaticamente o código SQL * the Comentário icon Comentar/remover comentário na linha atual * the Pesquisar icon Pesquisar e substituir texto no código ### Adicionar uma instrução SELECT para uma tabela Você pode adicionar uma instrução SELECT que retorna todos os campos de uma tabela. * Clique em the mais icon na tabela em Tabelas e clique em Adicionar instrução SELECT. Uma instrução SELECT que retorna todos os campos da tabela selecionada é adicionada ao editor de consultas. ### Adicionando uma consulta de um conjunto de dados de transformação Você pode adicionar a consulta de origem de um conjunto de dados criado em uma tarefa de transformação. * Clique em the mais icon no conjunto de dados em Tabelas e clique em Adicionar consulta de origem. A consulta que foi usada para criar o conjunto de dados selecionado é adicionada ao editor de consultas. ## Executando consultas Você pode executar a consulta inteira ou uma instrução selecionada clicando em Executar consulta. * Se você não selecionou nada no editor de consultas, a consulta inteira é executada. * Se você selecionou uma instrução no editor, essa instrução é executada. Quando a consulta é executada, você pode verificar o resultado em: * Resultados Dados de amostra retornados pela consulta. Nota informativaVocê deve ter a função Pode visualizar dados no espaço de conexão. Além disso, Visualizando dados na Integração de Dados deve estar ativado no seu locatário. * Metadados Lista colunas com informações sobre tipos de dados e Nulidade. ## Salvando e gerenciando scripts SQL Você pode salvar scripts SQL no SQL Workbench para reutilização clicando em Salvar. Scripts são salvos no projeto e podem ser visualizados por todos os usuários do projeto. Você pode listar, abrir, renomear e excluir scripts em Scripts salvos. Nota informativaOs scripts salvos do SQL Workbench não são incluídos na exportação de um projeto. Para obter mais informações, consulte [Exportando e importando pipelines de dados](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Introduction/Data-project-export-import.htm). * Para excluir um script, clique em the Mais icon no script e depois em Excluir. * Para renomear um script, clique em the Mais icon no script e depois em Editar. 1. 1) ## Solução de problemas * Se a execução da consulta falhar com erros de permissão, verifique se você tem as funções necessárias no espaço do projeto e no espaço de conexão. * Se estiverem faltando objetos, verifique se as tarefas de origem estão preparadas. * Se uma instrução estiver bloqueada, verifique se é SQL somente leitura. Para solução de problemas gerais, consulte [Solução de problemas com tarefas de dados](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Deploying/Troubleshooting-data-assets.htm).