# 7. MAP 명령 Map collection에 관한 명령은 아래와 같다. * [Map collection 생성: mop create](#mop-create) * Map collection 삭제: delete (기존 key-value item의 삭제 명령을 그대로 사용) Map element에 관한 명령은 아래와 같다. * [Map element 삽입: mop insert/upsert](#mop-insert-upsert) * [Map element 변경: mop update](#mop-update) * [Map element 삭제: mop delete](#mop-delete) * [Map element 조회: mop get](#mop-get) ## mop create 명령 Map collection을 empty 상태로 생성한다. ``` mop create [noreply]\r\n * : [] [unreadable] ``` * \ - 대상 item의 key string * \ - 설정할 item attributes. [Item Attribute 설명](/arcus-memcached/ascii-protocol/ch03-item-attributes.md)을 참조 바란다. * unreadable - 명시하면, readable 속성은 off로 설정됩니다. * noreply - 명시하면, response string을 전달받지 않는다. Response string과 그 의미는 아래와 같다. | Response String | 설명 | | --------------------------------------- | ----------------------------- | | "CREATED" | 성공 | | "EXISTS" | 동일 key string을 가진 item이 이미 존재 | | "NOT\_SUPPORTED" | 지원하지 않음 | | "CLIENT\_ERROR bad command line format" | protocol syntax 틀림 | | "SERVER\_ERROR out of memory" | 메모리 부족 | ## mop insert/upsert 명령 Map collection에 \로 구성된 하나의 element를 추가하는 명령으로 (1) 하나의 element를 삽입하는 mop insert 명령과 (2) 현재 삽입하는 field를 가진 element가 없으면 현재의 element를 삽입하고 그 field를 가진 element가 있으면 현재의 element로 대체시키는 mop upsert 명령이 있다. 이들 명령 수행에서 Map collection을 생성하면서 하나의 element를 삽입할 수도 있다. ``` mop insert [create ] [noreply|pipe]\r\n\r\n mop upsert [create ] [noreply|pipe]\r\n\r\n * : [] [unreadable] ``` * \ - 대상 item의 key string * \ - 삽입할 element의 field string * \ - 삽입할 element의 데이터 길이 (trailing 문자인 "\r\n"을 제외한 길이) * create \ - 해당 map collection 없을 시에 map 생성 요청. [Item Attribute 설명](/arcus-memcached/ascii-protocol/ch03-item-attributes.md)을 참조 바란다. * unreadable - 명시하면, readable 속성은 off로 설정됩니다. * noreply or pipe - 명시하면, response string을 전달받지 않는다. pipe 사용은 [Command Pipelining](/arcus-memcached/ascii-protocol/ch09-command-pipelining.md)을 참조 바란다. * \ - 삽입할 데이터 (최대 크기는 [기본제약사항](/arcus-memcached/ascii-protocol/ch01-arcus-basic-concept.md#basic-constraints)을 참고) Response string과 그 의미는 아래와 같다. | Response String | 설명 | | --------------------------------------- | -------------------------------------------- | | "STORED" | 성공 (field, element 삽입) | | "CREATED\_STORED" | 성공 (collection 생성하고 field, element 삽입) | | "REPLACED" | 성공 (element를 대체) | | "NOT\_FOUND" | key miss | | "TYPE\_MISMATCH" | 해당 item이 map collection이 아님 | | "OVERFLOWED" | overflow 발생 | | "ELEMENT\_EXISTS" | 동일 이름의 field가 이미 존재. map field uniqueness 위배 | | "NOT\_SUPPORTED" | 지원하지 않음 | | "CLIENT\_ERROR bad command line format" | protocol syntax 틀림 | | "CLIENT\_ERROR too large value" | 삽입할 데이터가 element value의 최대 크기보다 큼 | | "CLIENT\_ERROR bad data chunk" | 삽입할 데이터 길이가 \와 다르거나 "\r\n"으로 끝나지 않음 | | "CLIENT\_ERROR invalid prefix name" | 유효하지(존재하지) 않는 prefix 명 | | "SERVER\_ERROR out of memory" | 메모리 부족 | ## mop update 명령 Map collection에서 하나의 field에 대해 element 변경을 수행한다. 현재 다수 field에 대한 변경연산은 제공하지 않는다. ``` mop update [noreply|pipe]\r\n\r\n ``` * \ - 대상 item의 key string * \ - 대상 element의 field string * \ - 변경할 데이터 길이 (trailing 문자인 "\r\n"을 제외한 길이) * noreply or pipe - 명시하면, response string을 전달받지 않는다. pipe 사용은 [Command Pipelining](/arcus-memcached/ascii-protocol/ch09-command-pipelining.md)을 참조 바란다. * \ - 변경할 데이터 자체 Response string과 그 의미는 아래와 같다. | Response String | 설명 | | --------------------------------------- | ------------------------------------------ | | "UPDATED" | 성공 (element 변경) | | "NOT\_FOUND" | key miss | | "NOT\_FOUND\_ELEMENT" | field miss | | "TYPE\_MISMATCH" | 해당 item이 map collection이 아님 | | "NOT\_SUPPORTED" | 지원하지 않음 | | "CLIENT\_ERROR bad command line format" | protocol syntax 틀림 | | "CLIENT\_ERROR too large value" | 삽입할 데이터가 element value의 최대 크기보다 큼 | | "CLIENT\_ERROR bad data chunk" | 삽입할 데이터 길이가 \와 다르거나 "\r\n"으로 끝나지 않음 | | "SERVER\_ERROR out of memory" | 메모리 부족 | ## mop delete 명령 Map collection에서 하나 이상의 field 이름을 주어, 그에 해당하는 element를 삭제한다. ``` mop delete [drop] [noreply|pipe]\r\n [<"space separated fields">]\r\n ``` * \ - 대상 item의 key string * \ \ - field list 문자열 길이와 field 개수를 나타낸다. * 모두 0이면 map의 전체 field를 의미한다. * drop - 해당 field를 삭제하여 empty map이 될 경우, 그 map을 drop할 것인지를 지정한다. * noreply or pipe - 명시하면, response string을 전달받지 않는다. pipe 사용은 [Command Pipelining](/arcus-memcached/ascii-protocol/ch09-command-pipelining.md)을 참조 바란다. * <"space separated fields"> - 대상 map의 field list로, 스페이스(' ')로 구분한다. * 하위 호환성(1.10.X 이하 버전)을 위해 콤마(,)도 지원하지만 권장하지 않는다. Response string과 그 의미는 아래와 같다. | Response String | 설명 | | --------------------------------------- | -------------------------------------------------------- | | "DELETED" | 성공 (전체 또는 일부 field, element 삭제) | | "DELETED\_DROPPED" | 성공 (전체 또는 일부 field, element 삭제하고 collection을 drop한 상태) | | "NOT\_FOUND" | key miss | | "NOT\_FOUND\_ELEMENT" | field miss (삭제할 field, element가 없음. 모든 field가 없을 시에만 리턴) | | "TYPE\_MISMATCH" | 해당 item이 map collection이 아님 | | "NOT\_SUPPORTED" | 지원하지 않음 | | "CLIENT\_ERROR bad command line format" | protocol syntax 틀림 | ## mop get 명령 Map collection에서 하나 이상의 field 이름을 주어, 그에 해당하는 element를 조회한다. ``` mop get [delete|drop]\r\n [<"space separated fields">]\r\n ``` * \ - 대상 item의 key string * \ \ - field list 문자열 길이와 field 개수를 나타낸다. * 모두 0이면 map의 전체 field를 의미한다. * delete or drop - 해당 field의 값을 조회하면서 그 field를 delete할 것인지, 그리고 delete로 인해 empty map이 될 경우 그 map을 drop할 것인지를 지정한다. * <"space separated fields"> - 대상 map의 field list로, 스페이스(' ')로 구분한다. * 하위 호환성(1.10.X 이하 버전)을 위해 콤마(,)도 지원하지만 권장하지 않는다. 성공 시의 response string은 아래와 같다. VALUE 라인의 \는 조회된 field 개수를 의미한다. 마지막 라인은 END, DELETED, DELETED\_DROPPED 중의 하나를 가지며 각각 field 조회만 수행한 상태, field 조회하고 삭제한 상태, field 조회 및 삭제하고 map을 drop한 상태를 의미한다. ``` VALUE \r\n \r\n \r\n \r\n ... END|DELETED|DELETED_DROPPED\r\n ``` 실패 시의 response string과 그 의미는 아래와 같다. | Response String | 설명 | | ----------------------------------------------------- | ------------------------------------------------------- | | "NOT\_FOUND" | key miss | | "NOT\_FOUND\_ELEMENT" | field miss (주어진 field 이름들 중 하나라도 가진 element가 전혀 없는 상태임) | | "TYPE\_MISMATCH" | 해당 item이 map collection이 아님 | | "UNREADABLE" | 해당 item이 unreadable item임 | | "NOT\_SUPPORTED" | 지원하지 않음 | | "CLIENT\_ERROR bad command line format" | protocol syntax 틀림 | | "SERVER\_ERROR out of memory \[writing get response]" | 메모리 부족 | --- # Agent Instructions: 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: ``` GET https://jam2in.gitbook.io/arcus-memcached/ascii-protocol/ch07-command-map-collection.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.