Consultar dados

Com o editor SQL unificado da extensão do IDE do Google Cloud Data Agent Kit, é possível executar consultas SQL nos seus dados do Google Cloud diretamente do IDE.

Se você estiver usando o plug-in Data Agent Kit com um agente de programação compatível, poderá executar consultas SQL no agente ou usar comandos em linguagem natural para gerar consultas SQL.

Fontes de dados compatíveis

Com o Data Agent Kit, é possível consultar tabelas e visualizações nos seguintes serviços de dados doGoogle Cloud :

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

No Cloud SQL, são compatíveis consultas que usam a autenticação de banco de dados do Identity and Access Management (IAM) e a autenticação de banco de dados integrada (com senhas armazenadas como secrets regionais no Secret Manager). Para mais informações sobre como o Cloud SQL autentica usuários integrados com o Secret Manager, consulte Executar instruções SQL usando a API Data para Cloud SQL para MySQL e Cloud SQL para PostgreSQL. No AlloyDB, só há suporte para consultas que usam a autenticação de banco de dados do IAM.

Antes de começar

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

  1. Instale a extensão.
  2. Definir configurações de extensões.
  3. Confira as orientações em Encontrar e analisar dados.

Criar um arquivo SQL

Você pode abrir o editor SQL de várias maneiras.

Crie 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. Conclua as etapas em Configurar 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 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.

Configurar as definições de consulta

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

AlloyDB

  1. No editor de 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 é encaminhada para essa instância.
  6. Selecione um banco de dados.
  7. Clique em Salvar.

BigQuery

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

Bigtable

  1. No editor de SQL, clique em Abrir configurações de consulta.
  2. Selecione Bancos de dados.
  3. Selecione Bigtable.
  4. Selecione uma instância.
  5. Opcional: para usar um perfil de aplicativo diferente do padrão, selecione-o.
  6. Crie sua consulta.
  7. Clique em Salvar.

Cloud SQL

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

  6. Em Método de autenticação, selecione como autenticar:

    • Autenticação do banco de dados do IAM: autentique usando sua conta do Google Cloud .

    • Autenticação de banco de dados integrada: autentique-se como um usuário de banco de dados integrado cuja senha é armazenada como um secret regional no Secret Manager.

      1. Na lista Usuário, selecione um usuário do banco de dados. Se a lista não puder ser carregada, insira o nome de usuário no campo Usuário. No Cloud SQL para MySQL, o usuário root padrão não é compatível.
      2. Na lista Senha (armazenada no Secret Manager), selecione o secret regional que armazena a senha do usuário. Se você ainda não tiver um secret, selecione Criar novo secret na região REGION, insira um Nome e a Senha e clique em Criar secret. O secret é criado na mesma região da sua instância.
      3. Opcional: na lista Versão do secret, selecione uma versão específica. Por padrão, a opção latest é selecionada, que sempre usa a versão mais recente do secret.

      Para mais informações sobre os requisitos de usuário e de chaves regionais integrados, consulte Executar instruções SQL usando a API Data para Cloud SQL para MySQL e Cloud SQL para PostgreSQL.

  7. Clique em Salvar.

Spanner

  1. No editor de SQL, clique em Abrir configurações de consulta.
  2. Selecione Bancos de dados.
  3. Selecione Spanner.
  4. Selecione uma instância. Sua consulta é 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 de Configurações de consulta aparece.
  2. Conclua as etapas em Configurar 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 de SQL

Nem todos os recursos do editor de SQL são compatíveis com todos os tipos de fontes de dados. A tabela a seguir lista os recursos do editor de SQL compatíveis com cada tipo de fonte de dados durante a prévia.

Recurso

BigQuery

Bigtable

Spanner

Cloud SQL

AlloyDB para PostgreSQL

Resultados da consulta

✅

✅

✅

✅

✅

Informações sobre ocupação

Não relevante

Não relevante

Não relevante

Não relevante

Não relevante

Detalhes da execução

✅

✅

Tempo decorrido

❌

Sem suporte

❌

Sem suporte

❌

Sem suporte

Visualização

✅

✅

✅

✅

✅

Configurações de consulta

✅

✅

✅

✅

✅

Suporte a consultas de várias instruções

✅

✅

✅

✅

✅

Catálogo: inserir nome do recurso no editor

✅

✅

✅

✅

✅

A seguir