Antes de começar
-
Faça login na sua conta do Google.
Se você ainda não tiver uma, inscreva-se.
-
No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
- Ative a BigQuery API.
-
Configurar a autenticação:
-
No Console do Cloud, acesse a página Criar chave da conta de serviço.
Acessar página "Criar chave da conta de serviço" - Na lista Conta de serviço, selecione Nova conta de serviço.
- No campo Nome da conta de serviço, insira um nome.
Na lista Papel, selecione Projeto > Proprietário.
- Clique em Criar. O download de um arquivo JSON que contém sua chave é feito no seu computador.
-
-
Defina a variável de ambiente
GOOGLE_APPLICATION_CREDENTIALS
como o caminho do arquivo JSON que contém a chave da conta de serviço. Essa variável só se aplica à sessão de shell atual. Dessa maneira, se você abrir uma nova sessão, defina a variável novamente.
Instalar a biblioteca de cliente
C#
Para mais informações sobre a configuração do ambiente de desenvolvimento do C#, consulte o Guia de configuração do ambiente de desenvolvimento do C#.
Install-Package Google.Cloud.BigQuery.V2 -Pre
Go
go get -u cloud.google.com/go/bigquery
Java
Para mais informações sobre a configuração do ambiente de desenvolvimento do Java, consulte o Guia de configuração do ambiente de desenvolvimento Java.
Se você estiver usando o Maven,
adicione o código abaixo ao arquivo pom.xml
. Para mais informações sobre
BOMs, consulte BOM das bibliotecas do Google Cloud Platform.
Se você estiver usando o Gradle, adicione isto às dependências:
Se você estiver usando o sbt, adicione o seguinte às suas dependências:
Caso você esteja usando o IntelliJ ou o Eclipse, poderá adicionar bibliotecas de cliente ao seu projeto usando estes plug-ins de ambiente de desenvolvimento integrado:
Os plug-ins também oferecem outras funcionalidades, como gerenciamento de chaves de contas de serviço. Consulte a documentação de cada plug-in para mais detalhes.
Node.js
Para mais informações sobre a configuração do ambiente de desenvolvimento do Node.js, consulte o Guia de configuração do ambiente de desenvolvimento do Node.js.
npm install --save @google-cloud/bigquery
PHP
composer require google/cloud-bigquery
Python
Para mais informações sobre a configuração do ambiente de desenvolvimento do Python, consulte o Guia de configuração do ambiente de desenvolvimento Python.
pip install --upgrade google-cloud-bigquery
Ruby
Para mais informações sobre a configuração do ambiente de desenvolvimento do Ruby, consulte o Guia de configuração do ambiente de desenvolvimento Ruby.
gem install google-cloud-bigquery
Importar as bibliotecas
C#
Para mais informações, consulte a documentação de referência da API BigQuery C#.
Go
Para mais informações, consulte a documentação de referência da API BigQuery em Go (em inglês).
Java
Para mais informações, consulte a documentação de referência da API BigQuery em Java (em inglês).
Node.js
Para mais informações, consulte a documentação de referência da API BigQuery Node.js (em inglês).
PHP
Para mais informações, consulte a documentação de referência da API BigQuery PHP.
Python
Para mais informações, consulte a documentação de referência da API Python para BigQuery.
Ruby
Para mais informações, consulte a documentação de referência da API BigQuery em Ruby.
Inicializar um cliente do BigQuery
C#
Use a função BigQueryClient.Create() para criar o cliente do BigQuery.
Go
Use a função bigquery.NewClient() para criar o cliente do BigQuery.
Java
Use a função BigQueryOptions.getDefaultInstance() para usar as opções de autenticação padrão. Use a função BigQueryOptions.getService() para criar o cliente do BigQuery.
Node.js
Instancie a classe BigQuery para criar o cliente do BigQuery.
PHP
Instancie a classe BigQueryClient para criar o cliente do BigQuery.
Python
Instancie a classe bigquery.Client para criar o cliente do BigQuery.
Ruby
Use a função Google::Cloud::Bigquery.new para criar o cliente do BigQuery.
Execução de consultas
Consulte o Conjunto de dados públicos do Stack Overflow para encontrar as perguntas mais visualizadas marcadas com google-bigquery
.
SELECT CONCAT( 'https://stackoverflow.com/questions/', CAST(id as STRING)) as url, view_count FROM `bigquery-public-data.stackoverflow.posts_questions` WHERE tags like '%google-bigquery%' ORDER BY view_count DESC LIMIT 10
Essa consulta usa a sintaxe SQL padrão, que está descrita no guia de referência da consulta. As bibliotecas de cliente são pré-determinadas para a sintaxe SQL padrão. Consulte Como trocar dialetos SQL para alterar os dialetos SQL.
Execução da consulta
Faça a consulta usando o cliente autenticado do BigQuery.
C#
Defina uma string de consulta e use a função client.ExecuteQuery() para enviar a consulta e receber os resultados.
Go
Use a função bigquery.Query() para definir uma consulta e a função Query.Read() para enviar a consulta e receber os resultados.
Java
Defina a consulta com uma instância do QueryJobConfiguration. Inicie o job de consulta com o método BigQuery.create().
Node.js
Use o método BigQuery.query() para iniciar a consulta.
PHP
Crie uma configuração de consulta e use o método BigQueryClient.startQuery() para iniciar a consulta.
Python
Use o método Client.query() para iniciar a consulta.
Ruby
Use a função Google::Cloud::BigQuery::Project.query para iniciar uma consulta e aguarde os resultados.
Para ver mais exemplos de como executar consultas do BigQuery, acesse:
- Visão geral da consulta de dados
- Como executar consultas interativas e em lote
- Como gravar resultados de consulta em uma tabela permanente
Exibição do resultado da consulta
Exiba os resultados da consulta.
C#
Go
Use a função RowIterator.Next() para carregar cada linha em um ponteiro de struct.
Java
Itere o QueryResponse para receber todas as linhas nos resultados. O iterador administra automaticamente a paginação. Cada FieldList expõe as colunas por índices numéricos ou nome de coluna.
Node.js
Os resultados da consulta são retornados como uma lista de linhas, em que cada uma é um dicionário.
PHP
Chame o método Job.queryResults() para aguardar o encerramento da consulta. Cada linha nos resultados da consulta é uma matriz associativa.
Python
Itere o RowIterator para receber todas as linhas nos resultados. O iterador administra automaticamente a paginação. Cada linha expõe as colunas por índice numérico, nome da coluna ou como atributos do Python.
Ruby
A classe Google::Cloud::BigQuery::Data expõe cada linha como um hash.
Saiba mais como trabalhar com linhas de dados no BigQuery:
Código-fonte completo
Veja o código-fonte completo para a amostra.
C#
Go
Java
Node.js
PHP
Python
Ruby
Como foi?
A seguir
Saiba mais sobre as bibliotecas de cliente da API BigQuery.