Guia de início rápido: como usar bibliotecas de cliente
Veja nesta página como começar a usar a API BigQuery na sua linguagem de programação favorita.
Antes de começar
- Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Ative a BigQuery API.
-
Crie uma conta de serviço:
-
No Console do Google Cloud, acesse a página Criar conta de serviço.
Acesse "Criar conta de serviço" - Selecione o projeto.
-
No campo Nome da conta de serviço, insira um nome. O Console do Google Cloud preenche o campo ID da conta de serviço com base nesse nome.
No campo Descrição da conta de serviço, insira uma descrição. Por exemplo,
Service account for quickstart
. - Clique em Criar e continuar.
-
Para fornecer acesso ao projeto, conceda os seguintes papéis à conta de serviço: Projeto > Proprietário.
Na lista Selecionar um papel, escolha um.
Para papéis adicionais, clique em
Adicionar outro papel e adicione cada papel adicional. - Clique em Continuar.
-
Clique em Concluído para terminar a criação da conta de serviço.
Não feche a janela do navegador. Você vai usá-la na próxima etapa.
-
-
Crie uma chave de conta de serviço:
- No console do Google Cloud, clique no endereço de e-mail da conta de serviço que você criou.
- Clique em Chaves.
- Clique em Adicionar chave e em Criar nova chave.
- Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
- Clique em Fechar.
-
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. -
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Ative a BigQuery API.
-
Crie uma conta de serviço:
-
No Console do Google Cloud, acesse a página Criar conta de serviço.
Acesse "Criar conta de serviço" - Selecione o projeto.
-
No campo Nome da conta de serviço, insira um nome. O Console do Google Cloud preenche o campo ID da conta de serviço com base nesse nome.
No campo Descrição da conta de serviço, insira uma descrição. Por exemplo,
Service account for quickstart
. - Clique em Criar e continuar.
-
Para fornecer acesso ao projeto, conceda os seguintes papéis à conta de serviço: Projeto > Proprietário.
Na lista Selecionar um papel, escolha um.
Para papéis adicionais, clique em
Adicionar outro papel e adicione cada papel adicional. - Clique em Continuar.
-
Clique em Concluído para terminar a criação da conta de serviço.
Não feche a janela do navegador. Você vai usá-la na próxima etapa.
-
-
Crie uma chave de conta de serviço:
- No console do Google Cloud, clique no endereço de e-mail da conta de serviço que você criou.
- Clique em Chaves.
- Clique em Adicionar chave e em Criar nova chave.
- Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
- Clique em Fechar.
-
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.
Instale 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 mod init YOUR_MODULE_NAME go get 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 do 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:
Se você estiver usando o Visual Studio Code, o IntelliJ ou o Eclipse, poderá adicionar bibliotecas de cliente ao projeto usando estes plug-ins de IDE:
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 do 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 em C#.
Go
Para mais informações, consulte a documentação de referência da API BigQuery em Go.
Java
Para mais informações, consulte a documentação de referência da API BigQuery em Java.
Node.js
Para mais informações, consulte a documentação de referência da API BigQuery em Node.js.
PHP
Para mais informações, consulte a documentação de referência da API BigQuery em PHP.
Python
Para mais informações, consulte a documentação de referência da API BigQuery em Python.
Ruby
Para mais informações, consulte a documentação de referência da API BigQuery em Ruby.
Inicializar um cliente do BigQuery
Inicialize um cliente para fazer a autenticação e se conectar à API 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.
Consultar um conjunto de dados
A consulta a seguir recupera as perguntas mais marcadas com google-bigquery
do
conjunto de dados públicos do Stack Overflow.
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 do Google. As bibliotecas de cliente são pré-determinadas para a sintaxe SQL padrão do Google. Para mudar o dialeto SQL, consulte dialetos SQL do BigQuery.
Executar a consulta
Execute a consulta a seguir 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.
Saiba mais sobre consultas:
- Visão geral da consulta de dados
- Como executar consultas interativas e em lote
- Como gravar resultados de consulta em uma tabela permanente
Exibir o 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 sobre como trabalhar com tabelas 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.