> Source: https://clickhouse.github.io/loom/es/reference/operations/profile_schema/ (Markdown: https://clickhouse.github.io/loom/es/reference/operations/profile_schema.md)

<!-- i18n: source=docs/reference/operations/profile_schema.md blob=8733b163e298cbd52443a5ffa68aaf5c4a6ab110 model=claude-sonnet-5-5 -->
> Esta página es una traducción automática de la [página en inglés](https://clickhouse.github.io/loom/reference/operations/profile_schema/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/profile_schema/), which is authoritative.

<a id="profile_schema-operations"></a>

# Operaciones de `profile_schema`

Los campos exactos que recibe y devuelve cada operación `profile_schema.*`.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

Cada op es `POST /v1/<op>` sobre HTTP y la herramienta MCP `loom_<op>`. Los campos de identidad (`org`, `namespace`, `agent`, `user_id`, `session_id`) se rellenan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se usa la org de la instalación en todas las ops salvo `code.*` y `tracker.*` (que conservan la de su plano), y en [algunas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) también su espacio de nombres y su agente; consulta [identidades y espacios de nombres](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). El [índice de operaciones](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica el rol, el tipo y el listado `all` de MCP. Los campos de entrada desconocidos se atienden y se nombran en `ignored_args`.

<!-- prettier-ignore-start -->

<a id="profile_schemaclear"></a>

## `profile_schema.clear`

Borra el esquema: no se construye ni se reconstruye ningún perfil para el espacio de nombres, y las lecturas responden `no_schema`.

`POST /v1/profile_schema.clear` · MCP `loom_profile_schema_clear` · rol `admin` · idempotente · auditada · no aparece en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `found` | `bool` | False cuando el espacio de nombres no tiene esquema de perfil. |
| `json_schema` | `dict[str, Any]` | El esquema tal como lo definió el administrador, en el orden de sus claves; {} cuando no se encuentra. |
| `schema_sha256` | `str` | SHA-256 de las propiedades del esquema (no de sus títulos ni de su orden), que cada perfil nombra. |
| `updated_by` | `str` | El actor (`human:<subject>` o `process:<subject>`) que lo definió o borró por última vez; vacío cuando no se encuentra, o para un token limitado a un usuario. |
| `updated_at` | `datetime \| None` | Cuándo se definió o borró por última vez; None cuando no se encuentra. |

<a id="profile_schemaget"></a>

## `profile_schema.get`

El esquema de perfil del espacio de nombres, su hash y quién lo definió y cuándo.

`POST /v1/profile_schema.get` · MCP `loom_profile_schema_get` · rol `viewer` · lectura · no aparece en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `found` | `bool` | False cuando el espacio de nombres no tiene esquema de perfil. |
| `json_schema` | `dict[str, Any]` | El esquema tal como lo definió el administrador, en el orden de sus claves; {} cuando no se encuentra. |
| `schema_sha256` | `str` | SHA-256 de las propiedades del esquema (no de sus títulos ni de su orden), que cada perfil nombra. |
| `updated_by` | `str` | El actor (`human:<subject>` o `process:<subject>`) que lo definió o borró por última vez; vacío cuando no se encuentra, o para un token limitado a un usuario. |
| `updated_at` | `datetime \| None` | Cuándo se definió o borró por última vez; None cuando no se encuentra. |

<a id="profile_schemaset"></a>

## `profile_schema.set`

Define el esquema de perfil del espacio de nombres.

`POST /v1/profile_schema.set` · MCP `loom_profile_schema_set` · rol `admin` · idempotente · auditada · no aparece en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |
| `json_schema` | `dict[str, Any]` | obligatorio | Un objeto JSON Schema con entre 1 y 64 `properties`, cada una con un `type` y una `description` (como máximo 16 KiB); reemplaza el esquema del espacio de nombres, y un cambio en sus propiedades deja obsoletos todos los perfiles. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `found` | `bool` | False cuando el espacio de nombres no tiene esquema de perfil. |
| `json_schema` | `dict[str, Any]` | El esquema tal como lo definió el administrador, en el orden de sus claves; {} cuando no se encuentra. |
| `schema_sha256` | `str` | SHA-256 de las propiedades del esquema (no de sus títulos ni de su orden), que cada perfil nombra. |
| `updated_by` | `str` | El actor (`human:<subject>` o `process:<subject>`) que lo definió o borró por última vez; vacío cuando no se encuentra, o para un token limitado a un usuario. |
| `updated_at` | `datetime \| None` | Cuándo se definió o borró por última vez; None cuando no se encuentra. |

<!-- prettier-ignore-end -->
