Operación - Dim Producto
Objetivo
Documentar la información operativa identificada para el proceso Dim Producto, incluyendo consideraciones de ejecución, aspectos de trazabilidad y elementos de soporte disponibles.
Alcance
Dentro del alcance
- Consideraciones operativas identificadas.
- Aspectos de gobierno y trazabilidad documentados.
- Información disponible en el Runbook L1.
- Observaciones relacionadas con la ejecución del proceso.
Fuera del alcance
- Diseño funcional.
- Arquitectura técnica.
- Reglas de negocio.
- Definición de fuentes.
- Configuración de pipelines.
Contenido principal
Descripción general
Este documento concentra la información operativa del proceso DIM PRODUCTOS, incluyendo consideraciones de ejecución, orden recomendado, detección de fallos, acciones básicas y escalamiento.
El proceso requiere ejecutar primero DIM_PRODUCTOS_PART_1, posteriormente las subdimensiones requeridas y al final DIM_PRODUCTOS_PARTE_2. No se identifica workflow, frecuencias ni SLA dentro del DBC.
Consideraciones Operativas
- El orden de ejecucion es critico:
MTL_PRODUCTOSdebe existir antes de ejecutar las subdimensiones yDIM_PRODUCTOS_PARTE_2. - Algunos notebooks de subdimension generan dataframes finales pero el DBC visible no muestra
saveAsTablefinal; se debe validar en Databricks si existen celdas ocultas o si falta persistencia. - La dimension final usa overwrite de Delta, por lo que un error en
query_productpuede impactar toda la tablasnw_dim_productos. - Los defaults de claves deben validarse con negocio, especialmente
CVE_PROCESO=27y claves0. - No se identifico workflow, frecuencia, SLA ni responsable operativo dentro de los DBC proporcionados.
Gobierno y trazabilidad
- La trazabilidad tecnica se basa en los DBC proporcionados y los objetos de Unity Catalog identificados.
- Se recomienda registrar en SharePoint el link definitivo de esta documentacion y agregarlo en la celda de resumen del notebook.
- Se recomienda versionar cambios de reglas de negocio y cambios de mapeos de producto.
- Se recomienda agregar controles de calidad: conteo de productos, duplicados por
ID_PRO/ID_PNVA, nulls en claves obligatorias y productos sin lookup dimensional.
Runbook Operativo
| Campo | Valor |
|---|---|
| Nombre del proceso | DIM_PRODUCTOS |
| Qué hace | Construye la dimensión maestra de productos integrando fuentes Oracle/AS400, subdimensiones comerciales y conversiones. Materializa snw_dim_productos y expone una vista Gold. |
| Workflow asociado | No identificado en DBC. |
| Frecuencia | No identificada en DBC. |
| Cómo ejecutarlo manual | Ejecutar primero DIM_PRODUCTOS_PART_1; después las subdimensiones requeridas; al final ejecutar DIM_PRODUCTOS_PARTE_2. |
| Cómo detectar fallo | Errores en CREATE/overwrite, falta de MTL_PRODUCTOS, fallos de joins contra lookups, incremento de nulls en CVE_* o duplicados en ID_PRO/ID_PNVA. |
| Acciones básicas | Validar existencia de MTL_PRODUCTOS, validar conteos de subdimensiones, validar query_product, revisar historial Delta de snw_dim_productos. |
| Escalamiento | Data Engineer L2 / Arquitecto de Datos. |
Soporte y Escalamiento
La documentación del Runbook L1 establece como punto de escalamiento a Data Engineer L2 y Arquitecto de Datos. Sin embargo, no se identifica explícitamente un responsable operativo primario del proceso.
Artefactos relacionados
| Artefacto | Descripción |
|---|---|
| Diseño Funcional - Dim Producto | Describe el objetivo funcional, alcance y flujo funcional del proceso. |
| Diseño Técnico - Dim Producto | Documenta la arquitectura técnica, componentes y dependencias del proceso. |
| Fuentes - Dim Producto | Documenta las fuentes de información consumidos por el proceso. |
| Pipelines - Dim Producto | Describe la secuencia de ejecución y procesamiento de datos. |
| Reglas de Negocio - Dim Producto | Describe las reglas apliacadas durante la conformación de la dimensión. |
| Tablas - Dim Producto | Documenta las tablas origen, intermedias y destino involucradas. |
| Validaciones - Dim Producto | Documenta controles y validaciones asociados al proceso. |
Próximos pasos
- Confirmar el workflow asociado al proceso.
- Validar la frecuencia de ejecución documentada.
- Identificar el responsable operativo primario del proceso.
- Formalizar procedimientos de recuperación ante fallos.