> For the complete documentation index, see [llms.txt](https://docs.powermonitor.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powermonitor.com.br/es/power-monitor/mapeamento/ontologias.md).

# Ontologías

Siga, active y pause la recolección diaria de la estructura de las ontologías de Microsoft Fabric (entidades, relaciones, vínculos de datos, reglas y métricas).

La recolección de **Ontologías** lee, una vez al día, la definición de cada ontología de Microsoft Fabric de los workspaces monitoreados (entidades, relaciones, vínculos de datos, reglas y métricas) y señala los problemas encontrados. El resultado aparece en [Gobernanza › Ontologías](/es/power-monitor/governanca/dados-e-engenharia/ontologias.md); esta pantalla muestra el historial de la recolección y permite activarla o pausarla.

**Cómo acceder:** *Mapeo › Modelos e informes › Ontologías*. Solo los **Administradores** acceden a la pantalla y a las acciones. En la pantalla de datos, todos los perfiles con acceso ven la línea **Recolección** con la fecha de la última ejecución; el enlace **Ver/gestionar la recolección →**, que lleva hasta aquí, aparece solo para los administradores.

<figure><picture><source srcset="/files/tclcqgRe0s0mfBjagOWu" media="(prefers-color-scheme: dark)"><img src="https://4061945739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHiNRgoZ8eJ4rcnrLAoso%2Fuploads%2Fgit-blob-68cde734053114fd32013bcc366f5f1192d6609a%2Fpm-mapeamento-ontologias-es.png?alt=media" alt="Pantalla Ontologías del Mapeo con la tarjeta Qué se recolecta y la tarjeta Ejecuciones de la recolección"></picture><figcaption><p>Mapeo › Modelos e informes › Ontologías</p></figcaption></figure>

## Para qué sirve

* Mantener actualizadas la estructura y la lista de problemas usadas en [Gobernanza › Ontologías](/es/power-monitor/governanca/dados-e-engenharia/ontologias.md).
* Adelantar la recolección cuando acaba de crear o modificar una ontología y no quiere esperar al día siguiente.
* Confirmar que la recolección está corriendo e investigar ontologías que no pudieron leerse.

## Componentes de la pantalla

La pantalla tiene un encabezado (*Mapeo* y el subtítulo **Ejecuciones de la recolección de la estructura de las ontologías, activación manual y pausa.**) y dos tarjetas.

### Tarjeta Qué se recolecta

Describe la fuente, la frecuencia y dónde aparecen los datos (*Fuente, frecuencia y dónde aparecen los datos*) y trae, al pie, el enlace **Ver los datos recolectados en Ontologías →**, que lleva a la pantalla de datos.

### Tarjeta Ejecuciones de la recolección

La tarjeta **Ejecuciones de la recolección** (*Recolección diaria automática. Actívela manualmente si no quiere esperar.*) reúne los botones y el historial, como en las demás recolecciones del Mapeo (vea el detalle de cada elemento en [Sesiones de Spark](/es/power-monitor/mapeamento/sessoes-spark.md#tarjeta-ejecuciones-de-la-recoleccion)).

| Elemento                          | Para qué sirve                                                                                                                                                                                            |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ejecutar ahora** / **Reanudar** | Dispara una recolección manual. Cuando hay una ejecución **Pausada**, el botón pasa a llamarse **Reanudar** y continúa desde donde se detuvo. Funciona incluso con la recolección automática desactivada. |
| **Pausar**                        | Aparece solo durante una ejecución en curso; la ejecución se detiene al terminar la ontología actual.                                                                                                     |
| Tabla de ejecuciones              | Historial de la más reciente a la más antigua, con **Disparo**, **Inicio**, **Fin**, **Duración**, **Estado**, **Elementos procesados**, **Fallas** (con el enlace **Ver fallas**) y **Error**.           |

## Reglas y comportamiento

* **De dónde viene el dato:** API de Fabric, consultada con el Service Principal de la organización. Para cada workspace con ontologías, una consulta de la lista trae la generación (experiencia antigua o nueva); para cada ontología, la lectura de la definición trae la estructura. Se interpretan las dos experiencias.
* **Qué se lee:** las ontologías ya inventariadas por el [Escaneo de Inventario](/es/power-monitor/mapeamento/inventarios.md), no eliminadas, de workspaces **monitoreados** (vea [Gobernanza › Workspaces](/es/power-monitor/governanca/workspaces.md)).
* **Frecuencia:** automática, una vez al día, alrededor de la **01:31** (hora de Brasilia). Puede desactivarse o cambiarse a **Semanal** o **Mensual** en [Configuración › Monitoreo](/es/power-monitor/configuracoes/monitoramento.md#escaneos-y-recolecciones), sección **Escaneos y Recolecciones**, grupo **Inventario**, elemento **Estructura de las ontologías** (viene activado por defecto). **Ejecutar ahora** funciona incluso con el interruptor desactivado.
* **Límite por ejecución:** hasta **100 ontologías** por ejecución, empezando por las nunca leídas y luego por las leídas hace más tiempo. Las que sobran entran en las próximas ejecuciones.
* **Sin cambios, sin reprocesamiento:** cuando la definición no cambió desde la última lectura, solo se actualiza la fecha de la captura.
* **Permiso del Service Principal:** para listar las ontologías basta con ser **Visor** del workspace; para leer la definición, el Service Principal necesita **lectura y escritura** en el elemento (**Colaborador** o superior). Power Monitor recomienda el Service Principal como administrador de los workspaces, lo que ya cubre los dos casos. Vea [Permisos adicionales › Agregar Service Principal a los Workspaces](/es/power-monitor/configuracoes/permissoes-adicionais.md#agregar-service-principal-a-los-workspaces).
* **Ontologías que no se pueden leer:** sin acceso, con etiqueta de confidencialidad cifrada o cuando Fabric no permite leer la definición, la ontología queda con la situación **Sin acceso**, **Etiqueta cifrada** o **No compatible** y **no** cuenta como falla de la ejecución.
* **Fallas por elemento:** una falla en una ontología no tumba la recolección; se cuenta en **Fallas**, con el motivo (no se pudo leer la definición de la ontología, no se pudo interpretar la definición, no se pudo guardar la estructura o una falla inesperada al procesar la ontología). La ontología mantiene la última estructura conocida.
* **Límite de solicitudes de Fabric:** si Fabric limita las llamadas, la ejecución se pausa y se reanuda después, sin perder lo que ya se guardó.
* **Concurrencia:** solo existe una ejecución activa (en curso o pausada) por organización.

## Preguntas frecuentes

<details>

<summary>La recolección terminó, pero una ontología sigue como "Sin acceso".</summary>

El Service Principal no tiene permiso de lectura y escritura en la ontología. Hágalo **Colaborador** o superior (preferiblemente administrador) del workspace y vuelva a disparar la recolección.

</details>

<details>

<summary>Creé una ontología y no aparece en esta recolección.</summary>

La recolección solo lee las ontologías que ya están en el inventario. Espere el próximo Escaneo de Inventario (o dispare uno en [Inventario](/es/power-monitor/mapeamento/inventarios.md)) y después la recolección de ontologías.

</details>

<details>

<summary>¿La recolección consume capacidad de Fabric?</summary>

No. Solo lee la definición de las ontologías mediante la API de Fabric, sin consultar datos.

</details>

## Páginas relacionadas

* [Gobernanza › Ontologías](/es/power-monitor/governanca/dados-e-engenharia/ontologias.md)
* [Gobernanza › Ciencia de Datos](/es/power-monitor/governanca/dados-e-engenharia/ciencia-de-dados.md)
* [Configuración › Monitoreo](/es/power-monitor/configuracoes/monitoramento.md)
* [Permisos adicionales](/es/power-monitor/configuracoes/permissoes-adicionais.md)
* [Mapeo](/es/power-monitor/mapeamento.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.powermonitor.com.br/es/power-monitor/mapeamento/ontologias.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
