Consultar un conjunto de datos público con las bibliotecas de cliente de BigQuery
Consulta cómo hacer una consulta en un conjunto de datos público con las bibliotecas de cliente de BigQuery.
Para seguir las instrucciones paso a paso de esta tarea directamente en la consola, selecciona el lenguaje de programación que prefieras:Google Cloud
C#
Go
Java
Node.js
PHP
Python
Ruby
Antes de empezar
-
Create or select a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
Elige si quieres usar el entorno aislado de BigQuery sin coste económico o habilitar la facturación en tu Google Cloud proyecto.
Si no habilitas la facturación de un proyecto, trabajarás automáticamente en el entorno aislado de BigQuery. El entorno aislado de BigQuery te permite aprender a usar BigQuery con un conjunto limitado de funciones de BigQuery sin coste económico. Si no tienes previsto usar tu proyecto más allá de este documento, te recomendamos que uses el entorno aislado de BigQuery.
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/serviceusage.serviceUsageAdmin, roles/bigquery.jobUser
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Replace the following:
PROJECT_ID
: your project ID.USER_IDENTIFIER
: the identifier for your user account—for example,myemail@example.com
.ROLE
: the IAM role that you grant to your user account.
-
Enable the BigQuery API:
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles.gcloud services enable bigquery
En los proyectos nuevos, la API de BigQuery se habilita automáticamente.
-
In the Google Cloud console, activate Cloud Shell.
Activa tu Google Cloud proyecto en Cloud Shell:
gcloud config set project PROJECT_ID
Sustituye PROJECT_ID por el proyecto que has seleccionado para esta guía.
El resultado debería ser similar al siguiente:
Updated property [core/project].
En Cloud Shell, crea un proyecto y un archivo de C#:
dotnet new console -n BigQueryCsharpDemo
La salida es similar a la siguiente. Se han omitido varias líneas para simplificar el resultado.
Welcome to .NET 6.0! --------------------- SDK Version: 6.0.407 ... The template "Console App" was created successfully. ...
Este comando crea un proyecto de C# llamado
BigQueryCsharpDemo
y un archivo llamadoProgram.cs
.Abre el editor de Cloud Shell:
cloudshell workspace BigQueryCsharpDemo
Para abrir un terminal en el editor de Cloud Shell, haz clic en Abrir terminal.
Abre el directorio de tu proyecto:
cd BigQueryCsharpDemo
Instala la biblioteca de cliente de BigQuery para C#:
dotnet add package Google.Cloud.BigQuery.V2
La salida es similar a la siguiente. Se han omitido varias líneas para simplificar el resultado.
Determining projects to restore... Writing /tmp/tmpF7EKSd.tmp ... info : Writing assets file to disk. ...
Asigna el valor
GOOGLE_CLOUD_PROJECT
a la variableGOOGLE_PROJECT_ID
y exporta la variable:export GOOGLE_PROJECT_ID=$GOOGLE_CLOUD_PROJECT
Haz clic en Abrir editor.
En el panel Explorador, busca tu
BIGQUERYCSHARPDEMO
proyecto.Haz clic en el archivo
Program.cs
para abrirlo.Para crear una consulta en el conjunto de datos
bigquery-public-data.stackoverflow
que devuelva las 10 páginas de Stack Overflow más vistas y el número de vistas de cada una, sustituye el contenido del archivo por el siguiente código:Haz clic en Abrir terminal.
En el terminal, ejecuta la secuencia de comandos
Program.cs
. Si se te pide que autorices Cloud Shell y aceptes los términos, haz clic en Autorizar.dotnet run
El resultado es similar al siguiente:
Query Results: ------------ https://stackoverflow.com/questions/35159967: 170023 views https://stackoverflow.com/questions/22879669: 142581 views https://stackoverflow.com/questions/10604135: 132406 views https://stackoverflow.com/questions/44564887: 128781 views https://stackoverflow.com/questions/27060396: 127008 views https://stackoverflow.com/questions/12482637: 120766 views https://stackoverflow.com/questions/20673986: 115720 views https://stackoverflow.com/questions/39109817: 108368 views https://stackoverflow.com/questions/11057219: 105175 views https://stackoverflow.com/questions/43195143: 101878 views
En Cloud Shell, crea un proyecto y un archivo de Go:
mkdir bigquery-go-quickstart \ && touch \ bigquery-go-quickstart/app.go
Este comando crea un proyecto de Go llamado
bigquery-go-quickstart
y un archivo llamadoapp.go
.Abre el editor de Cloud Shell:
cloudshell workspace bigquery-go-quickstart
Para abrir un terminal en el editor de Cloud Shell, haz clic en Abrir terminal.
Abre el directorio de tu proyecto:
cd bigquery-go-quickstart
Crea un archivo
go.mod
:go mod init quickstart
El resultado debería ser similar al siguiente:
go: creating new go.mod: module quickstart go: to add module requirements and sums: go mod tidy
Instala la biblioteca de cliente de BigQuery para Go:
go get cloud.google.com/go/bigquery
La salida es similar a la siguiente. Se han omitido varias líneas para simplificar el resultado.
go: downloading cloud.google.com/go/bigquery v1.49.0 go: downloading cloud.google.com/go v0.110.0 ... go: added cloud.google.com/go/bigquery v1.49.0 go: added cloud.google.com/go v0.110.0
Haz clic en Abrir editor.
En el panel Explorador, busca tu
BIGQUERY-GO-QUICKSTART
proyecto.Haz clic en el archivo
app.go
para abrirlo.Para crear una consulta en el conjunto de datos
bigquery-public-data.stackoverflow
que devuelva las 10 páginas de Stack Overflow más vistas y el número de veces que se han visto, copia el siguiente código en el archivoapp.go
:Haz clic en Abrir terminal.
En el terminal, ejecuta la secuencia de comandos
app.go
. Si se te pide que autorices Cloud Shell y aceptes los términos, haz clic en Autorizar.go run app.go
El resultado es similar al siguiente:
https://stackoverflow.com/questions/35159967 : 170023 views https://stackoverflow.com/questions/22879669 : 142581 views https://stackoverflow.com/questions/10604135 : 132406 views https://stackoverflow.com/questions/44564887 : 128781 views https://stackoverflow.com/questions/27060396 : 127008 views https://stackoverflow.com/questions/12482637 : 120766 views https://stackoverflow.com/questions/20673986 : 115720 views https://stackoverflow.com/questions/39109817 : 108368 views https://stackoverflow.com/questions/11057219 : 105175 views https://stackoverflow.com/questions/43195143 : 101878 views
En Cloud Shell, crea un proyecto de Java con Apache Maven:
mvn archetype:generate \ -DgroupId=com.google.app \ -DartifactId=bigquery-java-quickstart \ -DinteractiveMode=false
Este comando crea un proyecto de Maven llamado
bigquery-java-quickstart
.La salida es similar a la siguiente. Se han omitido varias líneas para simplificar el resultado.
[INFO] Scanning for projects... ... [INFO] Building Maven Stub Project (No POM) 1 ... [INFO] BUILD SUCCESS ...
Hay muchos sistemas de gestión de dependencias que puedes usar además de Maven. Para obtener más información, consulta cómo configurar un entorno de desarrollo de Java para usarlo con bibliotecas de cliente.
Cambia el nombre del archivo
App.java
que crea Maven de forma predeterminada:mv \ bigquery-java-quickstart/src/main/java/com/google/app/App.java \ bigquery-java-quickstart/src/main/java/com/google/app/SimpleApp.java
Abre el editor de Cloud Shell:
cloudshell workspace bigquery-java-quickstart
Si se te pregunta si quieres sincronizar la ruta de clases o la configuración de Java, haz clic en Siempre.
Si no se te pide que lo hagas y se produce un error relacionado con la ruta de clases durante este proceso, haz lo siguiente:
- Haz clic en Archivo > Preferencias > Abrir ajustes (interfaz de usuario).
- Haz clic en Extensiones > Java.
- Desplázate hasta Configuración: actualizar configuración de compilación y selecciona automática.
En el panel Explorador, busca tu
BIGQUERY-JAVA-QUICKSTART
proyecto.Haz clic en el archivo
pom.xml
para abrirlo.Dentro de la etiqueta
<dependencies>
, añade la siguiente dependencia después de las que ya haya. No sustituyas ninguna dependencia.<dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-bigquery</artifactId> </dependency>
En la línea que sigue a la etiqueta de cierre (
</dependencies>
), añade lo siguiente:<dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>libraries-bom</artifactId> <version>26.1.5</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>
En el panel Explorador, en tu proyecto
BIGQUERY-JAVA-QUICKSTART
, haz clic en src > main/java/com/google/app > SimpleApp.java. El archivo se abre.Para crear una consulta en el conjunto de datos
bigquery-public-data.stackoverflow
, deje la primera línea del archivo (package com.google.app;
) y sustituya el resto del contenido del archivo por el siguiente código:La consulta devuelve las 10 páginas de Stack Overflow más vistas y el número de visualizaciones de cada una.
Haz clic con el botón derecho en SimpleApp.java y, luego, en Ejecutar Java. Si se te pide que autorices Cloud Shell y aceptes los términos, haz clic en Autorizar.
El resultado es similar al siguiente:
https://stackoverflow.com/questions/35159967 : 170023 views https://stackoverflow.com/questions/22879669 : 142581 views https://stackoverflow.com/questions/10604135 : 132406 views https://stackoverflow.com/questions/44564887 : 128781 views https://stackoverflow.com/questions/27060396 : 127008 views https://stackoverflow.com/questions/12482637 : 120766 views https://stackoverflow.com/questions/20673986 : 115720 views https://stackoverflow.com/questions/39109817 : 108368 views https://stackoverflow.com/questions/11057219 : 105175 views https://stackoverflow.com/questions/43195143 : 101878 views
En Cloud Shell, crea un proyecto y un archivo de Node.js:
mkdir bigquery-node-quickstart \ && touch \ bigquery-node-quickstart/app.js
Este comando crea un proyecto de Node.js llamado
bigquery-node-quickstart
y un archivo llamadoapp.js
.Abre el editor de Cloud Shell:
cloudshell workspace bigquery-node-quickstart
Para abrir un terminal en el editor de Cloud Shell, haz clic en Abrir terminal.
Abre el directorio de tu proyecto:
cd bigquery-node-quickstart
Instala la biblioteca de cliente de BigQuery para Node.js:
npm install @google-cloud/bigquery
El resultado debería ser similar al siguiente:
added 63 packages in 2s
Haz clic en Abrir editor.
En el panel Explorador, busca tu
BIGQUERY-NODE-QUICKSTART
proyecto.Haz clic en el archivo
app.js
para abrirlo.Para crear una consulta en el conjunto de datos
bigquery-public-data.stackoverflow
que devuelva las 10 páginas de Stack Overflow más vistas y el número de veces que se han visto, copia el siguiente código en el archivoapp.js
:Haz clic en Abrir terminal.
En el terminal, ejecuta la secuencia de comandos
app.js
. Si se te pide que autorices Cloud Shell y aceptes los términos, haz clic en Autorizar.node app.js
El resultado es similar al siguiente:
Query Results: url: https://stackoverflow.com/questions/35159967, 170023 views url: https://stackoverflow.com/questions/22879669, 142581 views url: https://stackoverflow.com/questions/10604135, 132406 views url: https://stackoverflow.com/questions/44564887, 128781 views url: https://stackoverflow.com/questions/27060396, 127008 views url: https://stackoverflow.com/questions/12482637, 120766 views url: https://stackoverflow.com/questions/20673986, 115720 views url: https://stackoverflow.com/questions/39109817, 108368 views url: https://stackoverflow.com/questions/11057219, 105175 views url: https://stackoverflow.com/questions/43195143, 101878 views
En Cloud Shell, crea un proyecto y un archivo PHP:
mkdir bigquery-php-quickstart \ && touch \ bigquery-php-quickstart/app.php
Este comando crea un proyecto de PHP llamado
bigquery-php-quickstart
y un archivo llamadoapp.php
.Abre el editor de Cloud Shell:
cloudshell workspace bigquery-php-quickstart
Para abrir un terminal en el editor de Cloud Shell, haz clic en Abrir terminal.
Abre el directorio de tu proyecto:
cd bigquery-php-quickstart
Instala la biblioteca de cliente de BigQuery para PHP:
composer require google/cloud-bigquery
La salida es similar a la siguiente. Se han omitido varias líneas para simplificar el resultado.
Running composer update google/cloud-bigquery Loading composer repositories with package information Updating dependencies ... No security vulnerability advisories found Using version ^1.24 for google/cloud-bigquery
Haz clic en Abrir editor.
En el panel Explorador, busca tu
BIGQUERY-PHP-QUICKSTART
proyecto.Haz clic en el archivo
app.php
para abrirlo.Para crear una consulta en el conjunto de datos
bigquery-public-data.stackoverflow
que devuelva las 10 páginas de Stack Overflow más vistas y el número de veces que se han visto, copia el siguiente código en el archivoapp.php
:Haz clic en Abrir terminal.
En el terminal, ejecuta la secuencia de comandos
app.php
. Si se te pide que autorices Cloud Shell y aceptes los términos, haz clic en Autorizar.php app.php
El resultado es similar al siguiente:
--- Row 1 --- url: https://stackoverflow.com/questions/35159967, 170023 views --- Row 2 --- url: https://stackoverflow.com/questions/22879669, 142581 views --- Row 3 --- url: https://stackoverflow.com/questions/10604135, 132406 views --- Row 4 --- url: https://stackoverflow.com/questions/44564887, 128781 views --- Row 5 --- url: https://stackoverflow.com/questions/27060396, 127008 views --- Row 6 --- url: https://stackoverflow.com/questions/12482637, 120766 views --- Row 7 --- url: https://stackoverflow.com/questions/20673986, 115720 views --- Row 8 --- url: https://stackoverflow.com/questions/39109817, 108368 views --- Row 9 --- url: https://stackoverflow.com/questions/11057219, 105175 views --- Row 10 --- url: https://stackoverflow.com/questions/43195143, 101878 views Found 10 row(s)
En Cloud Shell, crea un proyecto y un archivo de Python:
mkdir bigquery-python-quickstart \ && touch \ bigquery-python-quickstart/app.py
Este comando crea un proyecto de Python llamado
bigquery-python-quickstart
y un archivo llamadoapp.py
.Abre el editor de Cloud Shell:
cloudshell workspace bigquery-python-quickstart
Para abrir un terminal en el editor de Cloud Shell, haz clic en Abrir terminal.
Abre el directorio de tu proyecto:
cd bigquery-python-quickstart
Instala la biblioteca de cliente de BigQuery para Python:
pip install --upgrade google-cloud-bigquery
La salida es similar a la siguiente. Se han omitido varias líneas para simplificar el resultado.
Installing collected packages: google-cloud-bigquery ... Successfully installed google-cloud-bigquery-3.9.0 ...
Haz clic en Abrir editor.
En el panel Explorador, busca tu
BIGQUERY-PYTHON-QUICKSTART
proyecto.Haz clic en el archivo
app.py
para abrirlo.Para crear una consulta en el conjunto de datos
bigquery-public-data.stackoverflow
que devuelva las 10 páginas de Stack Overflow más vistas y el número de veces que se han visto, copia el siguiente código en el archivoapp.py
:Haz clic en Abrir terminal.
En el terminal, ejecuta la secuencia de comandos
app.py
. Si se te pide que autorices Cloud Shell y aceptes los términos, haz clic en Autorizar.python app.py
El resultado es similar al siguiente:
https://stackoverflow.com/questions/35159967 : 170023 views https://stackoverflow.com/questions/22879669 : 142581 views https://stackoverflow.com/questions/10604135 : 132406 views https://stackoverflow.com/questions/44564887 : 128781 views https://stackoverflow.com/questions/27060396 : 127008 views https://stackoverflow.com/questions/12482637 : 120766 views https://stackoverflow.com/questions/20673986 : 115720 views https://stackoverflow.com/questions/39109817 : 108368 views https://stackoverflow.com/questions/11057219 : 105175 views https://stackoverflow.com/questions/43195143 : 101878 views
En Cloud Shell, crea un proyecto y un archivo de Ruby:
mkdir bigquery-ruby-quickstart \ && touch \ bigquery-ruby-quickstart/app.rb
Este comando crea un proyecto de Ruby llamado
bigquery-ruby-quickstart
y un archivo llamadoapp.rb
.Abre el editor de Cloud Shell:
cloudshell workspace bigquery-ruby-quickstart
Para abrir un terminal en el editor de Cloud Shell, haz clic en Abrir terminal.
Abre el directorio de tu proyecto:
cd bigquery-ruby-quickstart
Instala la biblioteca de cliente de BigQuery para Ruby:
gem install google-cloud-bigquery
La salida es similar a la siguiente. Se han omitido varias líneas para simplificar el resultado.
23 gems installed
Haz clic en Abrir editor.
En el panel Explorador, busca tu
BIGQUERY-RUBY-QUICKSTART
proyecto.Haz clic en el archivo
app.rb
para abrirlo.Para crear una consulta en el conjunto de datos
bigquery-public-data.stackoverflow
que devuelva las 10 páginas de Stack Overflow más vistas y el número de veces que se han visto, copia el siguiente código en el archivoapp.rb
:Haz clic en Abrir terminal.
En el terminal, ejecuta la secuencia de comandos
app.rb
. Si se te pide que autorices Cloud Shell y aceptes los términos, haz clic en Autorizar.ruby app.rb
El resultado es similar al siguiente:
https://stackoverflow.com/questions/35159967: 170023 views https://stackoverflow.com/questions/22879669: 142581 views https://stackoverflow.com/questions/10604135: 132406 views https://stackoverflow.com/questions/44564887: 128781 views https://stackoverflow.com/questions/27060396: 127008 views https://stackoverflow.com/questions/12482637: 120766 views https://stackoverflow.com/questions/20673986: 115720 views https://stackoverflow.com/questions/39109817: 108368 views https://stackoverflow.com/questions/11057219: 105175 views https://stackoverflow.com/questions/43195143: 101878 views
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
En Cloud Shell, sube un directorio:
cd ..
Elimina la carpeta
BigQueryCsharpDemo
que has creado:rm -R BigQueryCsharpDemo
La marca
-R
elimina todos los recursos de una carpeta.En Cloud Shell, sube un directorio:
cd ..
Elimina la carpeta
bigquery-go-quickstart
que has creado:rm -R bigquery-go-quickstart
La marca
-R
elimina todos los recursos de una carpeta.En Cloud Shell, sube un directorio:
cd ..
Elimina la carpeta
bigquery-java-quickstart
que has creado:rm -R bigquery-java-quickstart
La marca
-R
elimina todos los recursos de una carpeta.En Cloud Shell, sube un directorio:
cd ..
Elimina la carpeta
bigquery-node-quickstart
que has creado:rm -R bigquery-node-quickstart
La marca
-R
elimina todos los recursos de una carpeta.En Cloud Shell, sube un directorio:
cd ..
Elimina la carpeta
bigquery-php-quickstart
que has creado:rm -R bigquery-php-quickstart
La marca
-R
elimina todos los recursos de una carpeta.En Cloud Shell, sube un directorio:
cd ..
Elimina la carpeta
bigquery-python-quickstart
que has creado:rm -R bigquery-python-quickstart
La marca
-R
elimina todos los recursos de una carpeta.En Cloud Shell, sube un directorio:
cd ..
Elimina la carpeta
bigquery-ruby-quickstart
que has creado:rm -R bigquery-ruby-quickstart
La marca
-R
elimina todos los recursos de una carpeta.- Consulta más información sobre el uso de las bibliotecas de cliente de BigQuery.
- Consulta más información sobre los conjuntos de datos públicos de BigQuery.
- Consulta cómo cargar datos en BigQuery.
- Consulta más información sobre cómo consultar datos en BigQuery.
- Consulta las novedades de BigQuery.
- Obtén más información sobre los precios de BigQuery.
- Consulta las cuotas y los límites de BigQuery.
Consultar un conjunto de datos público
Selecciona uno de los siguientes idiomas:
C#
Has consultado correctamente un conjunto de datos público con la biblioteca de cliente de C# de BigQuery.
Go
Has consultado correctamente un conjunto de datos público con la biblioteca de cliente de Go de BigQuery.
Java
Has consultado correctamente un conjunto de datos público con la biblioteca cliente de Java de BigQuery.
Node.js
Has consultado correctamente un conjunto de datos público con la biblioteca de cliente de Node.js de BigQuery.
PHP
Has consultado correctamente un conjunto de datos público con la biblioteca cliente de PHP de BigQuery.
Python
Has consultado correctamente un conjunto de datos público con la biblioteca de cliente de Python de BigQuery.
Ruby
Has consultado correctamente un conjunto de datos público con la biblioteca de cliente de Ruby de BigQuery.
Limpieza
Para evitar que se apliquen cargos en tu Google Cloud cuenta, elimina tu Google Cloud proyecto o los recursos que has creado en este tutorial.
Eliminar el proyecto
La forma más fácil de evitar que te cobren es eliminar el proyecto que has creado para el tutorial.
Para ello, sigue las instrucciones que aparecen a continuación:
Eliminar los recursos
Si has usado un proyecto que ya existía, elimina los recursos que hayas creado: