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

<!-- i18n: source=docs/reference/operations/profile_schema.md blob=8733b163e298cbd52443a5ffa68aaf5c4a6ab110 model=claude-sonnet-5-5 -->
> 이 페이지는 [영어 원문](https://clickhouse.github.io/loom/reference/operations/profile_schema/)을 기계 번역한 것이며, 영어 원문이 기준입니다.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/profile_schema/), which is authoritative.

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

# `profile_schema` 작업

각 `profile_schema.*` 작업이 받고 반환하는 정확한 필드입니다.

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

모든 op는 HTTP로는 `POST /v1/<op>`이고 MCP 도구로는 `loom_<op>`입니다. 전송 방식이 가능하면 ID 필드(`org`, `namespace`, `agent`, `user_id`, `session_id`)는 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, `code.*`와 `tracker.*`(해당 플레인의 값을 유지함)를 제외한 모든 op에서 설치의 org가 채워지고, [일부 op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)에서는 네임스페이스와 에이전트도 채워집니다. [ID와 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참고하세요. [작업 인덱스](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)에서 역할, 종류, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드는 처리되며 `ignored_args`에 이름이 표시됩니다.

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

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

## `profile_schema.clear`

스키마를 지웁니다. 이 네임스페이스에 대해 프로필을 새로 만들거나 다시 만들지 않으며, 읽기 요청은 `no_schema`로 응답합니다.

`POST /v1/profile_schema.clear` · MCP `loom_profile_schema_clear` · 역할 `admin` · 멱등 · 감사 대상 · MCP `all` 툴셋에 나열되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(ID 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `found` | `bool` | 네임스페이스에 프로필 스키마가 없으면 False. |
| `json_schema` | `dict[str, Any]` | 관리자가 설정한 그대로의 스키마이며 키 순서를 유지합니다. 찾지 못하면 {}. |
| `schema_sha256` | `str` | 스키마의 properties(제목이나 순서는 제외)에 대한 SHA-256이며, 각 프로필이 이 값을 가리킵니다. |
| `updated_by` | `str` | 마지막으로 스키마를 설정하거나 지운 행위자(`human:<subject>` 또는 `process:<subject>`). 찾지 못했거나 토큰이 한 사용자로 제한된 경우 비어 있습니다. |
| `updated_at` | `datetime \| None` | 마지막으로 설정하거나 지운 시각. 찾지 못하면 None. |

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

## `profile_schema.get`

네임스페이스의 프로필 스키마, 그 해시, 그리고 누가 언제 설정했는지를 반환합니다.

`POST /v1/profile_schema.get` · MCP `loom_profile_schema_get` · 역할 `viewer` · 읽기 · MCP `all` 툴셋에 나열되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(ID 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `found` | `bool` | 네임스페이스에 프로필 스키마가 없으면 False. |
| `json_schema` | `dict[str, Any]` | 관리자가 설정한 그대로의 스키마이며 키 순서를 유지합니다. 찾지 못하면 {}. |
| `schema_sha256` | `str` | 스키마의 properties(제목이나 순서는 제외)에 대한 SHA-256이며, 각 프로필이 이 값을 가리킵니다. |
| `updated_by` | `str` | 마지막으로 스키마를 설정하거나 지운 행위자(`human:<subject>` 또는 `process:<subject>`). 찾지 못했거나 토큰이 한 사용자로 제한된 경우 비어 있습니다. |
| `updated_at` | `datetime \| None` | 마지막으로 설정하거나 지운 시각. 찾지 못하면 None. |

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

## `profile_schema.set`

네임스페이스의 프로필 스키마를 설정합니다.

`POST /v1/profile_schema.set` · MCP `loom_profile_schema_set` · 역할 `admin` · 멱등 · 감사 대상 · MCP `all` 툴셋에 나열되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(ID 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스. |
| `json_schema` | `dict[str, Any]` | 필수 | 1~64개의 `properties`를 가진 JSON Schema 객체이며, 각 속성에는 `type`과 `description`이 있어야 합니다(최대 16 KiB). 네임스페이스의 스키마를 대체하며, properties가 변경되면 모든 프로필이 오래된 상태가 됩니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `found` | `bool` | 네임스페이스에 프로필 스키마가 없으면 False. |
| `json_schema` | `dict[str, Any]` | 관리자가 설정한 그대로의 스키마이며 키 순서를 유지합니다. 찾지 못하면 {}. |
| `schema_sha256` | `str` | 스키마의 properties(제목이나 순서는 제외)에 대한 SHA-256이며, 각 프로필이 이 값을 가리킵니다. |
| `updated_by` | `str` | 마지막으로 스키마를 설정하거나 지운 행위자(`human:<subject>` 또는 `process:<subject>`). 찾지 못했거나 토큰이 한 사용자로 제한된 경우 비어 있습니다. |
| `updated_at` | `datetime \| None` | 마지막으로 설정하거나 지운 시각. 찾지 못하면 None. |

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