Consultar dados

A extensão do Google Cloud Data Agent Kit para o editor SQL unificado do Visual Studio Code permite executar consultas SQL nos seus Google Cloud dados diretamente no Visual Studio Code.

Fontes de dados compatíveis

A extensão permite consultar tabelas e visualizações nos seguintes Google Cloud serviços de dados:

  • BigQuery
  • Spanner
  • AlloyDB para PostgreSQL
  • Cloud SQL para MySQL
  • Cloud SQL para PostgreSQL

Para o AlloyDB e o Cloud SQL, as consultas que usam a autenticação do IAM são aceitas. Não é possível consultar bancos de dados configurados para usar o Auth Proxy ou a autenticação baseada em senha.

Antes de começar

Antes de consultar seus dados, faça o seguinte:

  1. Instalar a extensão
  2. Definir as configurações da extensão.
  3. Consulte as orientações em Encontrar e explorar dados.

Criar um arquivo SQL

É possível abrir o editor SQL de várias maneiras.

Criar um arquivo SQL no menu "Arquivo"

  1. Na barra de menus do VS Code, clique em Arquivo e em Novo arquivo de texto. Um arquivo sem título aparece no editor.
  2. Salve o novo arquivo com a extensão .sql.
  3. Clique em Selecionar conexão na guia do editor.
  4. No editor Configurações de consulta, selecione BigQuery ou Bancos de dados.
  5. Se você selecionar Bancos de dados, escolha o mecanismo de banco de dados, o banco de dados e a instância ou o cluster conforme solicitado.
  6. Clique em Salvar para salvar as configurações dessa consulta.

Criar uma consulta no catálogo

  1. Na guia Google Cloud Data Agent Kit na barra de atividades, expanda Catálogo para encontrar o conjunto de dados que você quer consultar.
  2. Clique com o botão direito do mouse ou pressione Ctrl + clique no nome do conjunto de dados e selecione Consulta para abrir um novo arquivo SQL pré-configurado para esse conjunto de dados.

Criar uma consulta na seção do BigQuery

  1. Na guia Google Cloud Data Agent Kit na barra de atividades, expanda BigQuery.
  2. Clique em + Nova consulta. Um arquivo SQL sem título configurado com o BigQuery como fonte de dados aparece no editor.

Mudar as configurações de consulta

As configurações de consulta são específicas para cada arquivo SQL. Depois de abrir um arquivo SQL, é possível mudar as configurações.

  1. No editor, clique na fonte de dados exibida. O editor Configurações de consulta aparece.
  2. Mude a fonte de dados e clique em Salvar.

Executar uma consulta

Depois de criar um arquivo de consulta e escrever a consulta, clique em ▷ Executar consulta.

A guia Resultados do painel Resultados da consulta mostra os resultados da consulta.

Para executar um subconjunto das instruções SQL no editor de consultas, destaque o subconjunto antes de clicar em ▷ Executar consulta.

Recursos do editor SQL

Nem todos os recursos do editor SQL são aceitos para todos os tipos de fonte de dados. A tabela a seguir lista os recursos do editor SQL que são aceitos por tipo de fonte de dados durante a visualização.

Recurso

BigQuery

Spanner

Cloud SQL

AlloyDB para PostgreSQL

Guias do painel "Resultados da consulta"

Resultados da consulta

✅

✅

✅

✅

Informações sobre o job

✅

Não aplicável

Não relevante

Não aplicável

Detalhes da execução

✅

❌

Indisponível

❌

Indisponível

❌

Indisponível

Visualização

✅

✅

✅

✅

Configuração do editor SQL

Configurações de consulta

✅

✅

✅

✅

Outros recursos

Suporte a consultas de várias instruções

✅

✅

✅

✅

Catálogo: inserir o nome do recurso no editor

✅

✅

✅

✅

A seguir