SQL Academy · Lección

Bloques DO y código anónimo

Ejecute PL/pgSQL puntual con bloques DO, gestione el entrecomillado con signos de dólar y utilice bloques DO para migraciones puntuales.

Lección 3 de 413 pasos

Bloques DO y código anónimo es una lección gratuita de SQL Academy en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de SQL Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de SQL Academy incluye 4 lecciones en total.

¿Qué es un bloque DO?

Un bloque DO le permite ejecutar PL/pgSQL sin definir una función con nombre. Es perfecto para migraciones puntuales y scripts ad hoc.

Bloque DO básico

Sintaxis mínima:

DO $$
BEGIN
  RAISE NOTICE 'Hello from PL/pgSQL';
END;
$$ LANGUAGE plpgsql;

-- The language defaults to plpgsql, so you can omit it:
DO $$ BEGIN RAISE NOTICE 'Hi'; END $$;

Comillas de dólar

El delimitador $$ evita tener que escapar las comillas simples. Puede usar una etiqueta para anidar código:

DO $outer$
BEGIN
  EXECUTE $inner$ SELECT 'embedded \'quotes\'' $inner$;
END;
$outer$;

DDL condicional

Agregue una columna solo si no existe:

DO $$
BEGIN
  IF NOT EXISTS (
    SELECT 1 FROM information_schema.columns
    WHERE table_name='users' AND column_name='last_login'
  ) THEN
    ALTER TABLE users ADD COLUMN last_login TIMESTAMPTZ;
  END IF;
END $$;

Bucles para migraciones masivas

Actualice una tabla enorme por lotes:

DO $$
DECLARE
  rows_updated INT;
BEGIN
  LOOP
    UPDATE users SET tier = compute_tier(...)
    WHERE id IN (
      SELECT id FROM users WHERE tier IS NULL LIMIT 10000
    );
    GET DIAGNOSTICS rows_updated = ROW_COUNT;
    EXIT WHEN rows_updated = 0;
    COMMIT;
  END LOOP;
END $$;

SQL dinámico con EXECUTE

Construya cadenas SQL de forma segura con format() y EXECUTE:

DO $$
DECLARE
  tbl TEXT;
BEGIN
  FOR tbl IN SELECT tablename FROM pg_tables WHERE schemaname='public' LOOP
    EXECUTE format('ANALYZE %I;', tbl);
  END LOOP;
END $$;

Control de transacciones dentro de DO

PG antiguo: un bloque DO se ejecuta dentro de una única transacción implícita. PG 11+ permite COMMIT/ROLLBACK dentro de procedimientos (CALL), pero no en DO. Para migraciones por lotes con confirmaciones, use un procedimiento.

Procedimientos frente a DO

  • DO — anónimo, se ejecuta una vez, dentro de la transacción actual
  • PROCEDURE — con nombre, admite COMMIT/ROLLBACK y se invoca mediante CALL
CREATE PROCEDURE migrate_users() LANGUAGE plpgsql AS $$
BEGIN
  -- can COMMIT here
END $$;

CALL migrate_users();

Gestión de errores

Los bloques EXCEPTION funcionan igual que en las funciones con nombre:

DO $$
BEGIN
  ...
EXCEPTION
  WHEN OTHERS THEN
    RAISE NOTICE 'failed: %', SQLERRM;
END $$;

No use DO para tareas repetitivas

Si va a ejecutar la misma lógica más de una vez, defina una función o un procedimiento. DO es para ejecuciones puntuales.

Use DO en las migraciones

La mayoría de las herramientas de migración (Flyway, Sqitch) ejecutan SQL sin más. Los bloques DO le permiten incorporar control de flujo sin crear funciones independientes.

Recapitulación

Los bloques DO son PL/pgSQL ad hoc.

  • Una única ejecución anónima
  • Ideales para DDL condicional y migraciones
  • Preste atención a las comillas de dólar
  • Para controlar transacciones, use PROCEDURE

Comprobación rápida

Quiere ejecutar PL/pgSQL una vez durante una migración sin crear una función con nombre. ¿Qué construcción debe usar?

Gratis para empezar

Aprende SQL con un tutor de IA — gratis

Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.

Cursos
46
Lecciones
183

Preguntas frecuentes

¿La lección «Bloques DO y código anónimo» es gratis?

Sí — el texto completo de «Bloques DO y código anónimo» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de SQL Academy, actualiza a CoddyKit PRO. El curso de SQL Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Bloques DO y código anónimo»?

Ejecute PL/pgSQL puntual con bloques DO, gestione el entrecomillado con signos de dólar y utilice bloques DO para migraciones puntuales. Practicas SQL Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar SQL Academy?

No se requiere experiencia previa. SQL Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.

¿Cuánto tiempo toma la lección «Bloques DO y código anónimo»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de SQL Academy?

Sí. Cada lección de SQL Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Anatomía de los triggers: BEFORE/AFTER, FOR EACH ROW
  2. Conceptos básicos de las funciones PL/pgSQL
  3. Bloques DO y código anónimo
  4. Auditoría de tablas con triggers
← Volver a SQL Academy