Operación - DS Client

Objetivo

Documentar la información operativa del proceso DS Client, incluyendo consideraciones operativas, gobierno y trazabilidad, ejecución manual, detección de fallos, acciones básicas y escalamiento.

Alcance

Dentro del alcance

• Consideraciones operativas identificadas para el proceso NB_Silver_DS_Client.
• Validación de valores de widgets antes de ejecutar.
• Validación de permisos de escritura.
• Validación de existencia del catálogo y esquema destino.
• Revisión del volumen de comparación full join.
• Gobierno y trazabilidad identificados.
• Runbook L1 del proceso.
• Ejecución manual.
• Detección de fallos.
• Acciones básicas.
• Escalamiento.

Fuera del alcance

• Diseño funcional del proceso.
• Arquitectura técnica.
• Fuentes de datos detalladas.
• Reglas de negocio.
• Flujo paso a paso del pipeline.
• Modelo de datos completo.
• Validaciones no especificadas.

Contenido principal

Descripción general

Este documento concentra la información operativa del proceso DS Client, cuyo propósito es construir y/o actualizar la dimensión cat_master_alpura.sch_bronze_layer.snw_dim_clientes.

La operación contempla validación de widgets, permisos de escritura, existencia del catálogo y esquema destino, así como revisión del volumen de comparación full join. También se documentan las indicaciones del Runbook L1 para ejecución manual, detección de fallos, acciones básicas y escalamiento.

Consideraciones Operativas

• Validar valores de widgets antes de ejecutar:
  • w_StartDate
  • w_EndDate
  • w_catalog
  • w_schema origin
  • w_schema destiny
• Validar permisos de escritura y existencia del catálogo / esquema destino antes de ejecutar saveAsTable.
• Revisar volumen de comparación full join para evitar degradación de performance.

Gobierno y Trazabilidad

• La trazabilidad se basa en el DBC exportado.
• Validar owner técnico y permisos sobre fuentes y outputs.
• No documentar ni exponer lógica no presente en el DBC.

Runboook L1

Campo	Valor
Nombre del proceso	NB_Silver_DS_Client
Qué hace	Construir y/o actualizar la dimensión DS Client en Databricks, tomando como base únicamente la lógica definida en el DBC y persistiendo el resultado en cat_master_alpura.sch_bronze_layer.snw_dim_clientes.
Workflow asociado	No especificado en el DBC.
Frecuencia	No especificada en el DBC.
Cómo ejecutarlo manual	Ejecutar el notebook manualmente en Databricks, capturando widgets cuando aplique y validando que las fuentes estén disponibles.
Cómo detectar fallo	Revisar estado del job/notebook, errores de SQL/PySpark, permisos de lectura/escritura, conteo de registros y discrepancias en llaves.
Acciones básicas	Validar parámetros, disponibilidad de fuentes, permisos sobre catálogo/esquema, existencia de tablas destino y reintentar la ejecución controladamente.
Escalamiento	Escalar a Data Engineering / Arquitectura de Datos si falla la lectura fuente, el join de homologación, la escritura Delta o la validación de negocio.

Artefactos relacionados

Artefacto	Descripción
Diseño Funcional - DS_Client	Describe el objetivo funcional, alcance y descripción general del proceso
Diseño Técnico - DS_Client	Documenta arquitectura, modelo de datos dependencias y consideraciones técnicas.
Fuentes - DS_Client	Documenta las fuentes de datos utilizadas por el proceso.
Pipelines - DS_Client	Describe la secuencia de ejecución del proceso.
Reglas de Negocio - DS_Client	Contiene las reglas identificadas para el procesamiento.
Tablas - DS_Client	Documenta dimensión principal, objetos relacionados y llaves identificadas.
Validaciones - DS_Client	Describe menciones relacionadas con validaciones, revisión de fallos y acciones básicas.

Próximos pasos

• Validar owner técnico.
• Validar permisos sobre fuentes y outputs.