Conceptos básicos de incorporación

10 ejemplos para la incorporación del primer día: PostgreSQL 18.4 local, psql, hábito de EXPLAIN y política de acceso de solo lectura a producción, para que un nuevo compañero de equipo envíe un PR de consulta seguro antes del final de la primera semana.

Prerrequisitos

Clona el repositorio de la plataforma o aplicación y confirma el contrato de la pila.

git clone git@github.com:your-org/your-app.git
cd your-app
cat CONTRIBUTING.md | grep -i postgres

Pila local objetivo:

# docker-compose.yml (extracto)
services:
  postgres:
    image: postgres:18.4
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: app
      POSTGRES_DB: app_dev
    ports: ["5432:5432"]

Ejemplos básicos

1. Iniciar Postgres local

docker compose up -d postgres
docker compose ps
psql "postgresql://app:app@localhost:5432/app_dev" -c "SELECT version();"

Espera PostgreSQL 18.4 en la salida
Corrige conflictos de puertos con ss -tlnp | grep 5432 antes de cambiar los puertos de compose

2. Esenciales de psql

psql "postgresql://app:app@localhost:5432/app_dev"

\conninfo
\dt app.*
\d+ orders
\q

\d+ muestra índices y restricciones antes de escribir migraciones
Ver Conceptos básicos de psql

3. Ejecutar migraciones localmente

flyway -url=jdbc:postgresql://localhost:5432/app_dev \
  -user=app -password=app migrate

SELECT version, description, success
FROM flyway_schema_history ORDER BY installed_rank DESC LIMIT 3;

Misma ruta de comando que el trabajo de staging de CI
Nunca edites archivos de migración fusionados; añade una nueva versión hacia adelante

4. Hábito de EXPLAIN (Primer PR)

EXPLAIN (ANALYZE, BUFFERS)
SELECT id FROM orders WHERE tenant_id = $1 AND status = 'open' LIMIT 50;

Adjunta la salida al PR antes de solicitar una revisión
Staging requerido antes de producción; las tablas locales vacías mienten sobre los planes

Relacionado: Conceptos básicos de EXPLAIN

5. Política de producción de solo lectura

## Acceso a producción (semana 2+)
- Rol: app_readonly (solo SELECT)
- Compañero requerido las primeras 5 sesiones
- Sin DDL, sin pg_terminate_backend
- Usa solo VPN de bastión + psql (sin modo de escritura GUI)

-- Verificar rol
SELECT current_user, rolsuper, rolcreatedb FROM pg_roles WHERE rolname = current_user;

6. Datos de semilla para planes realistas

psql "$LOCAL_URL" -f db/seeds/dev_fixtures.sql
ANALYZE;

Mínimo 10k+ filas en las tablas que consultas en los PR
Copia una instantánea de estadísticas sanitizada de staging si el equipo la proporciona

7. Encontrar el mapa de documentación

docs/
├── database/
│   ├── CONTRIBUTING-db.md
│   └── runbooks/
site/postgresql/   # guías internas de SME

Marca Conceptos básicos de migraciones y Revisión de código para SQL

Ejemplos intermedios

8. Lista de verificación del compañero Semana uno

Día 1: postgres local + psql + primera tabla \d
Día 2: flyway migrate + SELECT de staging de solo lectura
Día 3: EXPLAIN en PR de muestra con comentario del compañero
Día 4: recorrido del script del paquete de incidentes (solo lectura)
Día 5: observar en espera de alerta no SEV1

9. Primera contribución segura

-- Buen primer PR: añadir índice parcial con CONCURRENTLY en staging
CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_orders_open_tenant
  ON orders (tenant_id) WHERE status = 'open';

Emparejar con la salida de Habilidad de seguridad de migración en el PR

10. Ruta de escalada

Consulta de aplicación lenta → EXPLAIN → #database Slack → Rotación de DBA
Base de datos SEV1 → PagerDuty → canal de incidentes → Habilidad de triaje de incidentes
Pregunta de diseño de esquema → horario de oficina martes 10:00

Preguntas frecuentes

¿La versión de Postgres local debe ser 18.4?

Coincide con el mayor.menor del equipo cuando sea posible. Local 18.x contra staging 18.4 es aceptable; evita PG 16 local contra staging 18 para pruebas de migración.

¿Herramientas GUI el primer día?

psql la primera semana. pgAdmin/DBeaver de solo lectura después de la sesión con el compañero. Escribe DDL solo a través de migraciones de git.

¿Cuándo obtener acceso de escritura a staging?

Después del primer PR de migración revisado y la capacitación de flyway, generalmente la semana 2-3. La escritura en producción es solo para el rol de guardia.

Relacionado

Camino de desarrollador de aplicaciones a DBA - progresión profesional
Matriz de habilidades - niveles de competencia
Mejores prácticas de equipo e incorporación - resumen de 25 elementos
Conceptos básicos de psql - flujos de trabajo del cliente
Conceptos básicos de Git para trabajo de base de datos - flujo de git de migración

Versiones de la pila: Esta página fue escrita para PostgreSQL 18.4, Flyway 10+ y desarrollo local con Docker Compose.

Prerrequisitos

Clona el repositorio de la plataforma o aplicación y confirma el contrato de la pila.

git clone git@github.com:your-org/your-app.git
cd your-app
cat CONTRIBUTING.md | grep -i postgres

Pila local objetivo:

# docker-compose.yml (extracto)
services:
  postgres:
    image: postgres:18.4
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: app
      POSTGRES_DB: app_dev
    ports: ["5432:5432"]

Ejemplos básicos

1. Iniciar Postgres local

docker compose up -d postgres
docker compose ps
psql "postgresql://app:app@localhost:5432/app_dev" -c "SELECT version();"

Espera PostgreSQL 18.4 en la salida
Corrige conflictos de puertos con ss -tlnp | grep 5432 antes de cambiar los puertos de compose

2. Esenciales de psql

psql "postgresql://app:app@localhost:5432/app_dev"

\conninfo
\dt app.*
\d+ orders
\q

\d+ muestra índices y restricciones antes de escribir migraciones
Ver Conceptos básicos de psql

3. Ejecutar migraciones localmente

flyway -url=jdbc:postgresql://localhost:5432/app_dev \
  -user=app -password=app migrate

SELECT version, description, success
FROM flyway_schema_history ORDER BY installed_rank DESC LIMIT 3;

Misma ruta de comando que el trabajo de staging de CI
Nunca edites archivos de migración fusionados; añade una nueva versión hacia adelante

4. Hábito de EXPLAIN (Primer PR)

EXPLAIN (ANALYZE, BUFFERS)
SELECT id FROM orders WHERE tenant_id = $1 AND status = 'open' LIMIT 50;

Adjunta la salida al PR antes de solicitar una revisión
Staging requerido antes de producción; las tablas locales vacías mienten sobre los planes

Relacionado: Conceptos básicos de EXPLAIN

5. Política de producción de solo lectura

## Acceso a producción (semana 2+)
- Rol: app_readonly (solo SELECT)
- Compañero requerido las primeras 5 sesiones
- Sin DDL, sin pg_terminate_backend
- Usa solo VPN de bastión + psql (sin modo de escritura GUI)

-- Verificar rol
SELECT current_user, rolsuper, rolcreatedb FROM pg_roles WHERE rolname = current_user;

6. Datos de semilla para planes realistas

psql "$LOCAL_URL" -f db/seeds/dev_fixtures.sql
ANALYZE;

Mínimo 10k+ filas en las tablas que consultas en los PR
Copia una instantánea de estadísticas sanitizada de staging si el equipo la proporciona

7. Encontrar el mapa de documentación

docs/
├── database/
│   ├── CONTRIBUTING-db.md
│   └── runbooks/
site/postgresql/   # guías internas de SME

Marca Conceptos básicos de migraciones y Revisión de código para SQL

Ejemplos intermedios

8. Lista de verificación del compañero Semana uno

Día 1: postgres local + psql + primera tabla \d
Día 2: flyway migrate + SELECT de staging de solo lectura
Día 3: EXPLAIN en PR de muestra con comentario del compañero
Día 4: recorrido del script del paquete de incidentes (solo lectura)
Día 5: observar en espera de alerta no SEV1

9. Primera contribución segura

-- Buen primer PR: añadir índice parcial con CONCURRENTLY en staging
CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_orders_open_tenant
  ON orders (tenant_id) WHERE status = 'open';

Emparejar con la salida de Habilidad de seguridad de migración en el PR

10. Ruta de escalada

Consulta de aplicación lenta → EXPLAIN → #database Slack → Rotación de DBA
Base de datos SEV1 → PagerDuty → canal de incidentes → Habilidad de triaje de incidentes
Pregunta de diseño de esquema → horario de oficina martes 10:00

Preguntas frecuentes

¿La versión de Postgres local debe ser 18.4?

Coincide con el mayor.menor del equipo cuando sea posible. Local 18.x contra staging 18.4 es aceptable; evita PG 16 local contra staging 18 para pruebas de migración.

¿Herramientas GUI el primer día?

psql la primera semana. pgAdmin/DBeaver de solo lectura después de la sesión con el compañero. Escribe DDL solo a través de migraciones de git.

¿Cuándo obtener acceso de escritura a staging?

Después del primer PR de migración revisado y la capacitación de flyway, generalmente la semana 2-3. La escritura en producción es solo para el rol de guardia.

Relacionado

Camino de desarrollador de aplicaciones a DBA - progresión profesional
Matriz de habilidades - niveles de competencia
Mejores prácticas de equipo e incorporación - resumen de 25 elementos
Conceptos básicos de psql - flujos de trabajo del cliente
Conceptos básicos de Git para trabajo de base de datos - flujo de git de migración

Versiones de la pila: Esta página fue escrita para PostgreSQL 18.4, Flyway 10+ y desarrollo local con Docker Compose.

Conceptos básicos de incorporación

Buscar en la documentación

Conceptos básicos de incorporación