언리얼 엔진 플러그인
박재완
jaewan.huey.park@gmail.com
플러그인
에디터 안에서 프로젝트 단위로
켜고 끌 수 있는 코드 및 데이터 모음
할 수 있는 일
- 런타임 게임플레이 기능 추가
- 엔진 기능 수정
- 새 에셋 유형 생성
- 에디터 메뉴, 툴바 명령 추가
엔진 시스템 중 일부도
플러그인으로 확장되어 있음
하고 싶은 일(오늘 해 볼 일)
데이터 테이블을 확장하여 좀 더 편하게 데이터 추출(json 또는 csv?)
작업 순서
- 새 플러그인 생성
- 데이터 테이블 확장 클래스 추가
- 팩토리 추가
- 액션 추가
- 팩토리에서 ConfigureProperties 가상함수 구현
- 액션에서 OpenAssetEditor 가상함수 구현
- 아이템 정보를 csv로 저장
- 에셋 저장시 csv도 자동저장
- 레벨 에디터 툴바에 버튼 추가
1. 새 플러그인 생성
Edit -> Plugins -> New Plugin
트랜잭션
몽고디비는 4.0버전(2018년)부터 여러 도큐먼트에 대한 트랜잭션을, 4.2버전(2019년) 부터는 샤딩된 컬렉션에 대한
분산 트랜잭션을 지원하고 있습니다.
여러 도큐먼트에 대한 ACID 트랜잭션 지원은 다양한 상황에서 개발자가 쉽게 대응할 수 있게 합니다. 스냅샷 격리수준과
아토믹한 실행은 샤딩된 클러스터에서도 트랜잭션이 필요한 워크로드를 제어할 수 있게 합니다.
- In version 4.0, MongoDB supports multi-document transactions on replica sets.
- In version 4.2, MongoDB introduces distributed transactions, which adds support for multi-document transactions on sharded clusters and incorporates the existing support for multi-document transactions on replica sets.
IMPORTANT: 대부분의 경우 멀티 도큐먼트 트랜잭션은 큰 부하를 일으키며, 효율적인 스키마를 대체하지 않아야 합니다.
대부분의 시나리오에서 비정규화된 데이터 모델(임베디드 도큐먼트 또는 배열)로 최적화 가능합니다.
인덱스
인덱스는 쿼리가 효율적으로 실행되게 돕습니다. 쿼리에 적절한 인덱스가 있으면 이를 사용해 조회할 도큐먼트 수를 줄일 수 있습니다.
인덱스는 특정 필드 또는 필드들을 값에 따라 정렬해 저장합니다.
정렬된 인덱스는 효율적인 레인지 쿼리를 지원합니다.
몽고디비 인덱스는 B-tree 자료구조를 사용합니다.

_id 인덱스
몽고디비는 _id 유니크 인덱스를 만듭니다.
_id 인덱스는 같은 _id 를 가진 도큐먼트가 두 개 생기는 것을 막습니다. _id 인덱스는 제거할 수 없습니다.
NOTE: 샤딩된 클러스터에서 _id 필드를 샤드 키로 사용하지 않으면 오류방지를 위해 애플리케이션이 _id 필드의
유니크성을 보장해야 합니다.
어그리게이션(Aggregation)
어그리게이션 작업은 데이터를 처리하여 계산된 결과를 반환합니다. 어그리게이션은 여러 도큐먼트의 값을 그룹화하고, 데이터에
다양한 작업을 수행한 후 단일 결과를 반환할 수 있습니다. MongoDB는 세 가지 어그리게이션을 제공합니다.
- Aggregation Pipeline
- Single Purpose Aggregation Operations
- Map-reduce
어그리게이션 파이프라인(Aggregation Pipeline)
Aggregation pipeline 은 파이프라인 이용해 데이터의 집계를 처리하는 프레임워크입니다. 여러 스테이지에 걸쳐 도큐먼트들을
집계된 결과로 변경합니다.
아래 예를 살펴봅시다:
db.orders.aggregate([
{ $match: { status: "A" } },
{ $group: { _id: "$custmor_id", total: { $sum: "$amount" } } }
])

쿼리 기준과 일치하는 도큐먼트에 대한 커서를 반환합니다.
파라미터
- query: 필터에 사용할 쿼리 연산자입니다.
- projection: 도큐먼트에서 반환할 필드를 지정합니다. 생략하면 모든 필드가 반환됩니다.
쿼리 기준과 일치하는 하나의 도큐먼트를 반환합니다.
여러 도큐먼트들이 쿼리를 만족하면 디스크에 저장된 순서에 따라 첫 도큐먼트를 반환합니다.
만약 대상이 없으면 null을 반환합니다.
readConcern 옵션을 사용해 읽기 작업의 일관성과 격리수준, 가용성을 제어할 수 있습니다.
4.4 버전부터 기본값의 전역 설정이 가능합니다. 세부정보는 setDefaultRWConcern에서 확인하십시오.
Read Concern Levels
- local
- 과반수에 기록되었음을 확인하지 않고 데이터를 반환합니다.(읽어온 데이터가 롤백될 수 있음)
- 사용가능:
causally consistent session 또는 트랜잭션에서 사용할 수 있습니다.
- available
- 과반수에 기록되었음을 확인하지 않고 데이터를 반환합니다.(읽어온 데이터가 롤백될 수 있음)
- 사용가능:
causally consistent session 또는 트랜잭션에서 사용할 수 없습니다.
- 샤딩된 클러스터에서 가장 낮은 레이턴시를 제공합니다. 하지만 샤드된 컬렉션에서 orphaned document를 반환할 수 있음을 유의하십시오.
- majority
- 과반수에 기록된 데이터를 반환합니다.
- 이를 충족하기 위해 각 레플리카 셋 멤버들이 메모리의
majority-commit point 반환해야 합니다. 따라서 위 두 설정에 비해 성능이 떨어집니다.
- 사용가능:
causally consistent session 또는 트랜잭션에서 사용할 수 있습니다.
- PSA 아키텍처를 사용할 때 이 설정을 쓰지 않게 설정할 수 있습니다. 하지만 이것은 Change Streams, 트랜잭션, 샤디드 클러스터에 영향을 줄 수 있습니다. 자세한 내용은 Disable Read Concern Majority에서 확인하십시오.
- linearizable
- 읽기를 시작하기 전에 완료된 쓰기에 대한 데이터만 반환합니다. 쿼리가 결과를 반환하기 전에 레플리카 셋 전체에 결과가 전파되길 기다립니다.
- 읽기 시작 후 레플리카 셋의 과반이 재시작되어도, 반환된 데이터는 유효합니다.(
writeConcernMajorityJournalDefault 을 false 로 변경하면 아닐 수 있음)
- 사용가능:
causally consistent session 또는 트랜잭션에서 사용할 수 없습니다.
- 프라이머리 노드에만 설정할 수 있습니다.
- 어그리게이션의 $out, $merge 스테이지에서 사용할 수 없습니다.
- 요구사항: 유니크하게 식별가능한 단일 도큐먼트에 읽기 작업에서만 보장됩니다.
- snapshot
- 트랜잭션이
causally consistent session 이 아니고 Write concern 이 majority 인 경우, 트랜잭션은 과반이 커밋된 데이터의 스냅샷에서 읽습니다.
- 트랜잭션이
causally consistent session 이고 Write concern 이 majority 인 경우, 트랜잭션 시작 직전에 과반이 커밋된 데이터의 스냅샷에서 읽습니다.
- 사용가능:
뭔가 묘한 일관성 옵션입니다. 잘 찾아보면 활용할 만 한 특수한 사용처가 있을지도 모릅니다.