Como gerenciar funções de banco de dados com o SQL Runner

O SQL Runner oferece uma maneira de acessar diretamente seu banco de dados e aproveitar esse acesso de várias maneiras. Com o SQL Runner, é fácil navegar pelas tabelas no esquema, usar uma Análise ad hoc de uma consulta SQL, executar consultas descritivas pré-escritas nos seus dados, consultar o histórico do SQL Runner, fazer o download dos resultados, compartilhar consultas, adicionar a um projeto do LookML como uma tabela derivada e realizar outras tarefas úteis.

Nesta página, descrevemos como modificar o esquema e os dados do banco de dados usando o SQL Runner, consultar o plano de execução do banco de dados para uma consulta com a instrução EXAMINE e como usar o SQL Runner para receber informações sobre o banco de dados. Consulte essas outras páginas de documentação para informações sobre:

Como modificar dados e esquema do banco de dados

Além de executar consultas no seu banco de dados, a guia Banco de dados no SQL Runner permite executar instruções de linguagem de definição de dados (DDL) e de linguagem de manipulação de dados (DML) no banco de dados. Você pode usar o SQL Runner para fazer alterações de esquema (como criar, descartar e alterar) e alterações de dados (como inserir, atualizar e excluir). Dialetos SQL têm suporte variável para instruções DDL e DML, portanto, consulte a documentação do banco de dados para descobrir quais instruções são compatíveis.

O Looker não controla a autorização de quais instruções SQL um usuário pode executar no banco de dados. Os usuários do Looker com a permissão use_sql_runner recebem acesso ao SQL Runner, mas o SQL Runner não limita quais comandos o usuário pode executar. Se o administrador do banco de dados quiser impedir que os usuários do SQL Runner modifiquem o esquema do banco de dados, ele precisará configurar as permissões de usuário para o próprio banco de dados.

Para executar uma instrução DDL ou DML no banco de dados no SQL Runner, siga estas etapas:

  1. Navegue até o SQL Runner.
  2. No SQL Runner, clique na guia Banco de dados.
  3. Insira a instrução DDL ou DML na caixa Consulta do SQL Runner. (Consulte a documentação do dialeto do banco de dados para obter suporte e sintaxe de instruções DDL e DML.)
  4. Clique em Executar para executar a instrução no seu banco de dados.

Se a instrução for executada com sucesso no banco de dados, a caixa Resultados do SQL mostrará uma confirmação.

Como analisar um plano de execução usando EXPLAIN

Além de executar consultas SQL no banco de dados, é possível usar o SQL Runner para executar uma função EXPLAIN para uma consulta. A função EXPLAIN, que é aceita pela maioria dos dialetos SQL, retorna o plano de execução do banco de dados para uma consulta.

  1. Em uma Análise, execute uma consulta e clique na guia SQL da área Dados para visualizar o comando SQL da consulta.

  2. Na guia SQL de "Explore", clique no botão Explain in SQL Runner (link em inglês).

    O Looker vai abrir o SQL Runner e carregar a consulta em uma função EXPLAIN.

  3. No SQL Runner, clique em Executar para executar a função EXPLAIN.

  4. Confira a saída da função EXPLAIN.

As informações e o formato exatos da resposta EXPLAIN dependem do seu dialeto específico. Consulte a documentação do seu dialeto para mais detalhes.

No exemplo anterior do MySQL, a função EXPLAIN retorna uma lista das etapas seguidas pelo banco de dados para concluir a consulta. Isso pode ser útil para consultas de execução lenta, pois você pode descobrir que seu banco de dados está verificando uma tabela inteira em uma consulta, quando talvez a tabela possa usar um índice para melhorar o desempenho.

Para conferir um exemplo detalhado de como usar EXPLAIN no SQL Runner para otimizar o SQL, consulte a postagem na Comunidade Como otimizar SQL com EXPLAIN .

Receber informações sobre o banco de dados

A guia Banco de dados no SQL Runner tem várias ferramentas para fornecer insights sobre seu banco de dados.

Receber informações de conexão do banco de dados

Quando você escolhe uma conexão no SQL Runner, o Looker mostra o dialeto do banco de dados para essa conexão à direita do banner CONSULTA SQL. Se você tiver acessado o SQL Runner selecionando Abrir no SQL Runner ou Explicar no SQL Runner, o Looker pré-seleciona a conexão apropriada e exibe o dialeto do banco de dados da conexão.

Clique no menu de engrenagem da conexão para conferir mais opções de conexão do banco de dados:

  • Selecione a opção Show Processes para exibir informações sobre consultas e processos em execução na conexão.
  • Selecione a opção Atualizar esquemas e tabelas para preencher novamente o painel de navegação esquerdo do SQL Runner com os esquemas e as tabelas no banco de dados.

Opções do menu de engrenagem do BigQuery

Quando você escolhe uma conexão do BigQuery com suporte a vários bancos de dados, o Looker mostra opções específicas de dialetos no menu de engrenagem. O item de menu alterna entre Mostrar projetos disponíveis e Pesquisar projetos públicos, dependendo da opção selecionada no momento.

  • Selecione Refresh Schemas & Tables para preencher novamente o painel de navegação esquerdo do SQL Runner com os esquemas e as tabelas do banco de dados.
  • Quando os projetos disponíveis forem exibidos, haverá uma opção no menu de engrenagem para Pesquisar projetos públicos. Selecione esta opção para pesquisar conjuntos de dados públicos que não são visíveis no esquema de informações.
  • Quando projetos públicos são exibidos, há uma opção no menu de engrenagem para Mostrar projetos disponíveis. Selecione esta opção para reverter a exibição para projetos e tabelas do BigQuery específicos da conexão no painel de navegação esquerdo do SQL Runner.

Como pesquisar no banco de dados

O SQL Runner exibe uma caixa de pesquisa abaixo do Esquema (ou Conjunto de dados, para conexões do Google BigQuery).

A pesquisa do SQL Runner navega pelos nomes de todas as tabelas e colunas da tabela que contêm a string na caixa de pesquisa. Na figura a seguir, 'airport_name' é uma coluna e 'airport_remarks' é uma tabela.

Clique em um dos resultados da pesquisa para navegar até esse item no SQL Runner.

Como receber informações de tabelas

Por padrão, o SQL Runner pré-carrega todas as informações da tabela quando você seleciona uma conexão e um esquema. Para conexões com muitas tabelas ou tabelas muito grandes, um administrador pode desativar esse comportamento desmarcando a opção Pré-cache do SQL Runner na página Conexões.

O painel de navegação esquerdo do SQL Runner permite navegar pelos esquemas e tabelas nas suas conexões. Selecione uma conexão e um esquema para conferir todas as tabelas dele. Clique no nome de uma tabela para conferir os campos dela.

O SQL Runner tem algumas consultas pré-criadas para ajudar você a entender os dados. Para usar essas consultas, clique no ícone de engrenagem que aparece ao lado do nome de uma tabela ou coluna da tabela e selecione a consulta desejada. O Looker gera o SQL automaticamente na seção Consulta SQL, e a consulta é executada.

As consultas disponíveis variam de acordo com o dialeto do banco de dados.

Informações da tabela

O Looker mostra as seguintes opções quando você clica no ícone de engrenagem ao lado do nome de uma tabela:

  • Explore Table: abre uma nova guia do navegador para uma Análise do Looker da tabela.
  • Descrever: exibe os nomes das colunas na tabela subjacente, bem como os tipos de dados.
  • Mostrar índices: mostra informações sobre como a tabela é indexada.
  • Selecionar 10: retorna uma consulta das dez primeiras linhas da tabela. Essa é uma boa maneira de ter uma noção de como os dados realmente são.
  • Contagem: retorna uma consulta count(*) simples para consultar a contagem total de linhas da tabela.

Informações da coluna

Clique no nome de uma tabela para conferir as colunas nela. O Looker mostra as seguintes opções quando você clica no ícone de engrenagem ao lado do nome de uma coluna:

  • Valores mais comuns: retorna uma consulta dos valores mais comuns para essa coluna da tabela, com uma contagem do número de vezes que esse valor é encontrado na coluna.
  • Contagem aproximada de valores diferentes: exibe uma contagem aproximada do número de valores distintos encontrados na coluna.

Como receber informações do tipo de dados da coluna

Use o SQL Runner para receber informações sobre o tipo de dados da coluna seguindo estas etapas:

  1. No SQL Runner, selecione a conexão do banco de dados na lista suspensa Conexão.
  2. Selecione o esquema na lista suspensa Esquema. Para conexões do BigQuery, selecione Projeto e Conjunto de dados.
  3. O SQL Runner exibe a lista de tabelas desse esquema no banco de dados. Clique em uma tabela para ver as colunas dela.
  4. Cada nome de coluna tem um ícone para representar o tipo de dados. Passe o cursor sobre o nome de uma coluna para ver o tipo de dados dela.

Editar consultas SQL pré-criadas

Você pode editar qualquer consulta SQL na área Consulta, incluindo as consultas SQL predefinidas escolhidas nos menus da engrenagem de tabela e campo.

Por exemplo, é possível usar a consulta Count do SQL Runner para carregar um comando de contagem básico para um banco de dados e editar a consulta SQL. Então, se você achar que a coluna id na tabela public.users pode ser uma chave primária, poderá validar que não há valores duplicados editando a consulta de contagem desta forma:

SELECT id ,COUNT(*)
FROM public.users
GROUP BY 1
ORDER BY 2 DESC
LIMIT 10

Como a consulta é classificada pela contagem antes que os resultados sejam limitados a 10 linhas, os resultados incluirão os valores de contagem mais altos. Se essa consulta retornar uma contagem de 1 para cada valor id, então id provavelmente será a chave primária nesta tabela. No entanto, essa consulta especifica apenas as linhas na tabela no ambiente de execução da consulta. Como futuras inserções no banco de dados podem desqualificar id como chave primária, recomendamos implementar restrições no banco de dados para garantir que suas chaves primárias sejam exclusivas.