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. Instale a extensão.
  2. Defina as configurações da extensão.
  3. Consulte as orientações em Encontrar e explorar dados.

Criar um arquivo SQL

Você pode 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. Siga as etapas em Definir as configurações de 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 e 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 "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.

Definir as configurações de consulta

As configurações necessárias para sua consulta SQL variam de acordo com o Google Cloud serviço.

AlloyDB

  1. No editor SQL, clique em Abrir configurações de consulta.
  2. Selecione Bancos de dados.
  3. Selecione AlloyDB.
  4. Selecione um cluster.
  5. Selecione uma instância. Sua consulta será encaminhada para essa instância.
  6. Selecione um banco de dados.
  7. Clique em Salvar.

BigQuery

  1. No editor SQL, clique em Abrir configurações de consulta.
  2. Selecione BigQuery.
  3. Clique em Salvar.

Cloud SQL

  1. No editor SQL, clique em Abrir configurações de consulta.
  2. Selecione Bancos de dados.
  3. Selecione Cloud SQL.
  4. Selecione uma instância. Sua consulta será encaminhada para essa instância.
  5. Selecione um banco de dados para consultar.
  6. Clique em Salvar.

Spanner

  1. No editor SQL, clique em Abrir configurações de consulta.
  2. Selecione Bancos de dados.
  3. Selecione Spanner.
  4. Selecione uma instância. Sua consulta será encaminhada para essa instância.
  5. Selecione um banco de dados para consultar.
  6. Clique em Salvar.

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, você pode mudar as configurações.

  1. No editor, clique na fonte de dados exibida. O editor Configurações de consulta aparece.
  2. Siga as etapas em Definir as configurações de consulta.

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 prévia.

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