/setup-bigquery.es

description: "Lesson command"
duration: "~15 min"
prerequisites: ["Tener una cuenta de Google", "Navegador disponible"]
level: "beginner"
tags: ["setup", "bigquery", "gcp", "gcloud"]
nonInteractiveMode: incompatible

Configuración de autenticación BigQuery / GCP

Step 0: Verificar el progreso de configuración

**Lo que la IA ejecuta automáticamente:** 1. Ejecutar `uv run python tools/setup_progress.py show --current setup-bigquery` para mostrar el progreso 2. Detectar automáticamente la instalación existente de gcloud CLI:

• Ejecutar `gcloud --version`
• Si gcloud CLI ya está instalado y autenticado, saltar al Step 4 (prueba de conexión)
• Si no está instalado, comenzar desde el Step 1

Lo que hará en esta sesión

| Elemento | Contenido | |----------|-----------| | Objetivo | Instalar gcloud CLI, autenticarse con Application Default Credentials (ADC) y ejecutar consultas SQL en BigQuery | | Duración | ~15 minutos | | Requisitos previos | Tener una cuenta de Google y un navegador disponible | | Nivel de operación | Pocos comandos CLI + autenticación por navegador (la IA le guía en cada paso) |

**Flujo de la sesión:** 1. Instalar gcloud CLI (la IA le guía en cada paso) 2. Iniciar sesión con su cuenta de Google (el navegador se abre automáticamente) 3. Configurar un proyecto de GCP (la IA le guía) 4. Configurar Application Default Credentials (un solo comando) 5. Prueba de conexión con BigQuery (la IA lo ejecuta automáticamente)

> **Sobre los costos**: BigQuery ofrece hasta 1 TB de consultas gratuitas al mes. El curso utiliza conjuntos de datos públicos, por lo que los costos son prácticamente nulos. Google le notificará antes de superar el nivel gratuito. > > **Consejo**: Si la respuesta de la IA se detiene a mitad de camino, escriba "por favor continúe" o "se detuvo" para reanudar.

---

Verificación de preparación

**Configuración de AskQuestion:**

{
  "title": "Confirmación antes de la sesión",
  "questions": [{
    "id": "readiness",
    "prompt": "¿Está preparado/a?",
    "options": [
      {"id": "ready", "label": "¡Preparado/a! Comencemos"},
      {"id": "check_prereq", "label": "Quiero verificar los requisitos previos"},
      {"id": "different_lesson", "label": "Quiero ir a otra lección"}
    ]
  }]
}

(ready -> Ir al Step 1) (check_prereq -> Indicar: "Si puede iniciar sesión en un navegador con una cuenta de Google, está listo/a. BigQuery es gratuito hasta 1 TB de consultas al mes, por lo que el uso durante el curso es prácticamente gratuito.") (different_lesson -> Mostrar la lista de módulos)

---

Step 1: Instalación de gcloud CLI

**Lo que hace la IA:** 1. Detectar automáticamente el SO (Mac / Windows / Linux) 2. Ejecutar `gcloud --version` para verificar si ya está instalado 3. Si ya está instalado, saltar al Step 2 4. Si no está instalado, guiar al usuario con los pasos de instalación según el SO

**Mac (se recomienda Homebrew):**

brew install google-cloud-sdk

**Mac (si Homebrew no está disponible) / Windows:** Descargar el instalador a través del navegador:

# Mac:
open https://cloud.google.com/sdk/docs/install
# Windows:
start https://cloud.google.com/sdk/docs/install

**Verificación posterior a la instalación:**

gcloud --version

**Configuración de AskQuestion:**

{
  "title": "Step 1: Instalación de gcloud CLI",
  "questions": [{
    "id": "install_status",
    "prompt": "Indique el estado de su instalación de gcloud CLI:",
    "options": [
      {"id": "installed", "label": "Instalado (o ya lo tenía instalado)"},
      {"id": "homebrew_issue", "label": "No puedo usar Homebrew (Mac)"},
      {"id": "windows_help", "label": "Necesito ayuda con las instrucciones de Windows"},
      {"id": "install_error", "label": "Obtuve un error durante la instalación"}
    ]
  }]
}

(installed -> Verificar con `gcloud --version`, luego ir al Step 2) (homebrew_issue -> Indicar: "Abra https://cloud.google.com/sdk/docs/install en su navegador y descargue el instalador para macOS. Extraiga el archivo descargado y ejecute ./install.sh para instalarlo.") (windows_help -> Indicar: "Abra https://cloud.google.com/sdk/docs/install en su navegador y descargue el instalador de Windows (.exe). Haga doble clic en el archivo descargado y siga las instrucciones en pantalla. Después de la instalación, abra una nueva terminal WSL (Ubuntu).") (install_error -> Verificar el mensaje de error e identificar la causa. Si el PATH no está configurado, indicar al usuario que ejecute `source ~/.zshrc` o abra una nueva terminal)

---

Step 2: Configuración del proyecto GCP

**Lo que hace la IA:** 1. Ejecutar `gcloud auth login` para iniciar la autenticación de Google en el navegador 2. El navegador se abre automáticamente, solicitándole que inicie sesión con su cuenta de Google

gcloud auth login

**Instrucciones de autenticación por navegador para el usuario:**

El navegador se abrirá automáticamente. Siga estos pasos para autenticarse:

┌─────────────────────────────────────────────────────────────┐
│ 1. Seleccione su cuenta de Google e inicie sesión           │
│ 2. "Google Cloud SDK solicita acceso"                       │
│    → Haga clic en "Permitir"                                │
│ 3. Cuando aparezca "Autenticación completada", cierre el    │
│    navegador                                                │
│ 4. Regrese a la terminal para ver el mensaje de éxito       │
└─────────────────────────────────────────────────────────────┘

**Después de la autenticación, configure el proyecto:**

# Listar proyectos existentes
gcloud projects list

# Configurar el proyecto (reemplace PROJECT_ID con su ID real)
gcloud config set project PROJECT_ID

**Configuración de AskQuestion:**

{
  "title": "Step 2: Configuración del proyecto GCP",
  "questions": [{
    "id": "auth_status",
    "prompt": "¿Completó la autenticación de la cuenta de Google en el navegador?",
    "options": [