> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/es/iot-query/schema-overview/transformation-layer.md). # Capa de transformación {% hint style="info" %} #### ¡Próximamente! La arquitectura de la capa de Transformación descrita en esta página se encuentra actualmente en desarrollo. Aunque las capacidades principales de transformación están operativas, los detalles de implementación pueden evolucionar antes del lanzamiento final. Si le interesa el acceso anticipado o tiene preguntas, póngase en contacto con . {% endhint %} ## Qué hace la capa de Transformación La **Capa de transformación** procesa los datos sin procesar de la **Capa de datos sin procesar** en entidades analíticas normalizadas y listas para consultar. Mientras que la capa de datos sin procesar contiene todo lo capturado de dispositivos y sistemas (puntos individuales, eventos y valores de campos útiles para la verificación y la resolución de problemas), la capa de Transformación convierte esos datos sin procesar en objetos significativos, como viajes, visitas a zonas y estados operativos. {% hint style="info" icon="lightbulb-exclamation" %} La capa de Transformación, en breve: la capa de datos sin procesar es todo lo recopilado; la capa de Transformación es con lo que usted puede trabajar. {% endhint %} Esta capa intermedia elimina la preparación manual repetitiva de datos y deja sus datos listos para análisis prácticos. Los operadores de flotas pueden responder a preguntas operativas comunes sin un procesamiento extenso de datos, y los integradores obtienen una base estable para crear soluciones escalables de informes y BI. Las transformaciones se pueden diseñar y configurar mediante [**Transformation Builder**](/docs/analytics/es/iot-query/schema-overview/transformation-layer/transformation-builder.md), una herramienta visual que le permite crear entidades analíticas personalizadas mediante una interfaz de flujo de trabajo de arrastrar y soltar. Para obtener más detalles sobre cómo crear y administrar transformaciones, consulte la documentación de Transformation Builder. Navixy proporciona un conjunto de transformaciones comunes predefinidas que se ejecutan automáticamente y rellenan el `processed_common_data` esquema sin ninguna configuración por su parte. Puede consultar estos datos inmediatamente después de conectarse a IoT Query. Cada transformación común también incluye una plantilla de flujo de trabajo que puede cargar en Transformation Builder para inspeccionar la lógica de procesamiento o adaptarla a su escenario específico. Consulte [Transformaciones comunes](/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations.md) para conocer las entidades disponibles y sus esquemas de salida. ## Cómo se organizan los datos La capa de Transformación utiliza un enfoque de esquema dinámico en el que las estructuras de base de datos se forman automáticamente en función de las transformaciones activas. A diferencia de la capa de datos sin procesar, con sus definiciones de esquema fijas, la capa de Transformación contiene solo las tablas que corresponden a las transformaciones que están activas actualmente. Las tablas disponibles y sus estructuras dependen de qué transformaciones estén configuradas en su **Consulta IoT** de su organización. Los datos de la capa de Transformación se organizan en dos esquemas de PostgreSQL: `processed_common_data` y `processed_custom_data`. ### processed\_common\_data La `processed_common_data` el esquema contiene transformaciones desarrolladas y mantenidas por Navixy. Este esquema se comparte entre todos los clientes y proporciona entidades analíticas estandarizadas que cubren casos de uso telemáticos comunes. Las tablas aparecen en este esquema a medida que Navixy implementa nuevas transformaciones para satisfacer requisitos analíticos de amplia aplicación. {% hint style="warning" %} La `processed_common_data` el esquema es **de solo lectura para clientes externos**. Puede consultar los datos libremente, pero no puede modificar tablas, insertar registros ni alterar estructuras en este esquema. Para crear sus propias entidades analíticas, utilice el `processed_custom_data` esquema a través de [Transformation Builder](/docs/analytics/es/iot-query/schema-overview/transformation-layer/transformation-builder.md). {% endhint %} ### processed\_custom\_data La `processed_custom_data` el esquema contiene transformaciones específicas del cliente creadas para responder a requisitos empresariales únicos. Cada cliente tiene una instancia aislada de este esquema, por lo que sus datos no son visibles para otras organizaciones. Las tablas de este esquema corresponden a las transformaciones que usted configura y administra a través de [Transformation Builder](/docs/analytics/es/iot-query/schema-overview/transformation-layer/transformation-builder.md). Usted tiene la plena propiedad de este esquema: decide qué transformaciones crear, cómo procesan los datos y cuándo se ejecutan. Transformation Builder genera la configuración y el SQL necesarios para producir sus entidades analíticas personalizadas. #### Qué ocurre cuando las transformaciones cambian Cuando activa una transformación, el sistema crea automáticamente la estructura de tabla correspondiente en el esquema adecuado. Cuando las transformaciones se desactivan o eliminan, sus tablas pueden archivarse o eliminarse según las políticas de retención de datos. Esta formación dinámica es la razón por la que la capa de Transformación no proporciona descripciones fijas del esquema como sí lo hace la capa de datos sin procesar. Las tablas disponibles y sus estructuras reflejan las transformaciones específicas configuradas para su instancia de IoT Query. ## Características del procesamiento de datos Las entidades de la capa de Transformación se mantienen automáticamente mediante procesos programados. Cuando consulte estos datos, tenga en cuenta las siguientes características de procesamiento. * **Actualizaciones programadas.** Cada transformación procesa nuevos registros de la capa de datos sin procesar según su programación configurada. Las actualizaciones suelen producirse cada hora o cada pocas horas, según la complejidad y la configuración de la transformación. * **Ventanas de procesamiento.** Las transformaciones operan sobre segmentos basados en el tiempo para procesar de forma eficiente porciones manejables de datos en lugar de examinar conjuntos de datos completos. Este enfoque equilibra el rendimiento del procesamiento con la frescura de los datos. * **Comportamiento de recalculado.** Cuando los cambios de configuración desencadenan un recálculo, los datos recientes pueden mostrar breves inconsistencias durante las ventanas de procesamiento activas. Estas inconsistencias se resuelven automáticamente una vez que finaliza el ciclo de procesamiento. * **Comportamiento específico del esquema.** Las transformaciones en `processed_common_data` se actualizan simultáneamente para todos los clientes que comparten ese esquema, ya que Navixy gestiona la programación de forma centralizada. Las transformaciones en `processed_custom_data` se ejecutan de forma independiente por cliente, lo que le permite personalizar la programación y la lógica de procesamiento para sus necesidades específicas. ## Qué tener en cuenta al consultar Al escribir consultas SQL sobre datos de la capa de Transformación, tenga en cuenta lo siguiente: * **Utilice el formato completo schema.table.** Haga referencia siempre a las tablas con el prefijo de su esquema para evitar ambigüedades: ```sql SELECT * FROM processed_common_data.table_name WHERE device_time >= CURRENT_DATE - INTERVAL '7 days'; ``` * **Incluya filtros de rango temporal.** Añada condiciones basadas en el tiempo en sus cláusulas `WHERE` para limitar el volumen de datos examinados. Esto mejora el rendimiento de la consulta y reduce el tiempo de ejecución. * **Compruebe los horarios de transformación.** Los datos en las tablas de la capa de Transformación reflejan el ciclo de procesamiento completado más reciente. Si necesita datos que tengan solo unos pocos minutos, la capa de datos sin procesar puede ser más adecuada hasta que se ejecute el siguiente ciclo de transformación. * **Recuerde que `processed_common_data` es de solo lectura.** Utilice este esquema para consultar entidades estandarizadas mantenidas por Navixy. Para crear sus propias entidades analíticas, configure transformaciones en el `processed_custom_data` esquema a través de [Transformation Builder](/docs/analytics/es/iot-query/schema-overview/transformation-layer/transformation-builder.md). ## Próximos pasos * [**Transformation Builder**](/docs/analytics/es/iot-query/schema-overview/transformation-layer/transformation-builder.md): Diseñe entidades analíticas personalizadas mediante la interfaz visual de flujo de trabajo. * [**Capa de datos sin procesar**](/docs/analytics/es/iot-query/schema-overview/bronze-layer.md): Explore los esquemas de origen (`raw_telematics_data` y `raw_business_data`) que alimentan las transformaciones. * [**SQL Recipe Book**](/docs/analytics/es/example-queries.md): Aprenda patrones de consulta y buenas prácticas para trabajar con tablas de la capa de Transformación en Dashboard Studio. * [**Transformaciones comunes**](/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations.md): Explore las entidades analíticas predefinidas disponibles en `processed_common_data`, incluidos los esquemas de salida, ejemplos de consultas y plantillas de Transformation Builder. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/analytics/es/iot-query/schema-overview/transformation-layer.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.