Autorizar e executar consultas
Você pode inserir uma consulta no editor ou selecionar uma consulta salva na lista Queries (Consultas) e escolha Run (Executar).
Por padrão, é definido Limit 100 para limitar os resultados a 100 linhas. É possível desativar essa opção para retornar um conjunto de resultados maior. Se você desativar essa opção, poderá incluir a opção LIMIT na instrução SQL para evitar conjuntos de resultados muito grandes. Para obter mais informações, consulte cláusula ORDER BY no Guia do desenvolvedor de banco de dados do Amazon Redshift.
Para exibir um plano de consulta na área de resultados, ative Explain (Explicar). Ative Explain graph (Explicar grafo) para que os resultados também exibam uma representação gráfica do plano de explicação.
Para salvar uma consulta na pasta Queries (Consultas), escolha Save (Salvar).
Se a consulta for bem-sucedida, será exibida uma mensagem de sucesso. Se a consulta retornar informações, os resultados serão exibidos na seção Results (Resultados). Se o número de resultados exceder a área de exibição, os números serão visualizados na parte superior da área de resultados. É possível escolher os números para exibir sucessivas páginas de resultados.
Você pode filtrar e classificar Result (Resultado) para cada coluna. Para inserir critérios de filtro no cabeçalho da coluna de resultados, passe o mouse sobre a coluna para ver um menu (
) onde é possível inserir critérios para filtrar a coluna.
Se a consulta contiver um erro, o editor de consultas v2 exibirá uma mensagem de erro na área de resultados. A mensagem fornece informações sobre como corrigir a consulta.
Você pode exportar ou copiar os resultados da consulta usando o menu de contexto (clique com o botão direito do mouse) na área de resultados da seguinte forma:
Selecione Export result set (Exportar conjunto de resultados) e opte por JSON ou CSV para baixar todo o conjunto de resultados da linha em um arquivo. O número de linhas no conjunto de resultados pode ser limitado pela opção Limit (Limitar) ou pela cláusula
limitdo SQL na consulta. O tamanho máximo do conjunto de resultados baixado é de 5 MB.Se nenhuma linha estiver selecionada, escolha Export current page (Exportar página atual) e opte por JSON ou CSV para baixar as linhas da página atual em um arquivo.
Se as linhas estiverem selecionadas, escolha Export selected rows (Exportar linhas selecionadas) e opte por JSON ou CSV para baixar as linhas selecionadas em um arquivo.
Se as linhas estiverem selecionadas, escolha Copy rows (Copiar linhas) a fim de copiar as linhas selecionadas para a área de transferência.
Se as linhas estiverem selecionadas, escolha Copy rows with headers (Copiar linhas com cabeçalho) a fim de copiar as linhas selecionadas com os cabeçalhos de coluna para a área de transferência.
Você também pode usar o atalho Ctrl+C no Windows ou Cmd+C no macOS para copiar os dados da página de resultados atual para a área de transferência. Se nenhuma linha for selecionada, a célula com foco será copiada para a área de transferência. Se as linhas estiverem selecionadas, elas serão copiadas para a área de transferência.
Para adicionar uma nova guia de consulta, escolha o ícone
e Editor, que aparece na linha com as guias de consulta. A guia de consulta pode ou não estar usando uma Isolated session. Com uma sessão isolada, os resultados de um comando SQL que altera o banco de dados, como a criação de uma tabela temporária em uma guia do editor, não são visíveis em outra guia. Quando você abre uma guia no editor de consultas v2, o padrão é uma sessão isolada.
Para executar uma consulta
Na área de consulta, siga um destes procedimentos:
Insira uma consulta.
Cole uma consulta que você copiou.
Selecione a pasta Queries (Consultas) abra o menu de contexto (clique com o botão direito do mouse) em uma consulta salva e escolha Open query (Abrir consulta).
Confirme se escolheu o valor correto de Cluster ou Workgroup (Grupo de trabalho) e de Database (Banco de dados) para o SQL que você pretende executar.
Inicialmente, é possível escolher seu Cluster ou WorkGroup (Grupo de trabalho) na exibição de árvore. Selecione Database (Banco de dados) na exibição de árvore também.
Você pode alterar Cluster ou Workgroup (Grupo de trabalho) e Database (Banco de dados) dentro de cada guia do editor com o controle suspenso localizado próximo ao cabeçalho Isolated session (Sessão isolada) de cada guia do editor.
Em cada guia do editor, você escolhe se deseja executar SQL em uma sessão isolada. A sessão isolada tem sua própria conexão com um banco de dados. Use-a para executar SQL isolado de outras sessões do editor de consultas. Para obter mais informações sobre conexões, consulte Abrir o editor de consultas v2.
Escolha Executar.
A área Result (Resultado) é aberta e exibe os resultados da consulta.
Para exibir o plano de explicação de uma consulta
Selecione a consulta.
Ative Explain (Explicar).
Por padrão, Explain graph (Explicar gráfico) também está ativado.
Escolha Executar.
A consulta é executada, e o plano de explicação é exibido na área Result (Resultado) da consulta.
O editor de consultas v2 oferece suporte aos seguintes recursos:
É possível criar consultas com várias instruções SQL em uma guia de consulta. As consultas são executadas em série, e várias guias de resultados são abertas para cada consulta.
É possível criar consultas com variáveis de sessão e tabelas temporárias.
Você pode criar consultas com parâmetros substituíveis designados por
${. Crie sua consulta SQL com vários parâmetros substituíveis e usar o mesmo parâmetro em vários lugares na instrução SQL.parameter}Quando a consulta é executada, uma janela para inserção do valor do parâmetro é apresentada. Toda vez que você executa a consulta, a janela é exibida para a inserção dos valores dos parâmetros.
Para ver um exemplo, consulte Exemplo: vendas maiores que um parâmetro específico.
As consultas são versionadas automaticamente. É possível escolher uma versão anterior de uma consulta a ser executada.
Para continuar com seu fluxo de trabalho, não é necessário esperar que uma consulta seja concluída. Suas consultas continuam sendo executadas, mesmo se você fechar o editor de consultas.
Ao criar consultas, é possível usar o recurso de preenchimento automático de nomes de esquema, tabela e coluna.
O editor SQL é compatível com os seguintes recursos:
Os colchetes inicial e final usados no SQL têm cores correspondentes. Linhas verticais são mostradas no editor para ajudar a combinar os colchetes.
É possível recolher e expandir seções do SQL.
É possível pesquisar e substituir texto no SQL.
É possível usar teclas de atalho para várias tarefas comuns de edição.
Os erros de SQL são realçados no editor para localização conveniente das áreas problemáticas.
Para ver uma demonstração dos recursos do editor, assista ao vídeo a seguir.
Exemplos de consulta
A seguir, você encontra descrições dos vários tipos de consultas que é possível executar.
Os dados usados em várias dessas consultas são do esquema de exemplo tickit. Para obter mais informações sobre como carregar os dados de amostra de tickit, consulte Carregar dados de exemplo. Para obter informações sobre dados de amostra de tickit, consulte Banco de dados de exemplo no Guia do desenvolvedor de banco de dados do Amazon Redshift.
Ao executar essas consultas de exemplo, confirme se escolheu o banco de dados correto no editor, como sample_data_dev.
Tópicos
Exemplo: definir variáveis de sessão
O comando a seguir define o parâmetro de configuração do servidor search_path para público para a sessão. Para obter mais informações, consulte SET e search_path no Guia do desenvolvedor de banco de dados do Amazon Redshift.
set search_path to public;
Exemplo: principal evento por total de vendas
A consulta a seguir localiza o evento com mais vendas.
select eventname, count(salesid) totalorders, sum(pricepaid) totalsales from sales, event where sales.eventid=event.eventid group by eventname order by 3;
Veja a seguir uma lista parcial dos resultados.
eventname totalorders totalsales White Christmas 20 9352 Joshua Radin 38 23469 Beach Boys 58 30383 Linda Ronstadt 56 35043 Rascal Flatts 76 38214 Billy Idol 67 40101 Stephenie Meyer 72 41509 Indigo Girls 57 45399 ...
Exemplo: vendas maiores que um parâmetro específico
A consulta a seguir localiza vendas em que a quantidade vendida é maior que o parâmetro especificado por ${numberoforders}. Quando o valor do parâmetro é 7, o resultado é de 60 linhas. Quando você executa a consulta, o editor de consultas v2 exibe uma janela Run query form (Executar um formulário de consulta) para reunir o valor dos parâmetros na instrução SQL.
select salesid, qtysold from sales where qtysold > ${numberoforders} order by 2;
Veja a seguir uma lista parcial dos resultados.
salesid qtysold 20005 8 21279 8 130232 8 42737 8 74681 8 67103 8 105533 8 91620 8 121552 8 ...
Exemplo: criar uma tabela temporária
A instrução a seguir cria a tabela temporária eventsalestemp selecionando informações das tabelas sales e event.
create temporary table eventsalestemp as select eventname, count(salesid) totalorders, sum(pricepaid) totalsales from sales, event where sales.eventid=event.eventid group by eventname;
Exemplo: selecionar de uma tabela temporária
A declaração a seguir seleciona eventos, total de pedidos e total de vendas da tabela temporária eventsalestemp, ordenada pelo total de pedidos.
select eventname, totalorders, totalsales from eventsalestemp order by 2;
Veja a seguir uma lista parcial de resultados.
eventname totalorders totalsales White Christmas 20 9352 Joshua Radin 38 23469 Martina McBride 50 52932 Linda Ronstadt 56 35043 Indigo Girls 57 45399 Beach Boys 58 30383 ...
