Merge requests
GitLab v19.1- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated 별칭 approvedBy와 approvers가 GitLab 18.0에서 도입됨. Nullable 값 지원이 GitLab 18.3에서 도입됨.
Merge requests#
-
Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
History
- GitLab 17.8에서 도입됨.
허용 범위#
| 범위 | 설명 |
|---|---|
| project | 특정 프로젝트의 머지 리퀘스트를 조회합니다. |
| group | 하위 그룹을 포함하여 그룹 내 모든 프로젝트의 머지 리퀘스트를 조회합니다. |
자세한 내용은 범위를 참조하세요.
쿼리 필드#
| 필드 | 이름 (및 별칭) | 연산자 |
|---|---|---|
| 사용자별 승인 | approver, approvedBy, approvers | =, != |
| 담당자 | assignee, assignees | =, != |
| 작성자 | author | =, != |
| 종료 시각 | closed, closedAt | =, >, <, >=, <= |
| 생성 시각 | created, createdAt, opened, openedAt | =, >, <, >=, <= |
| 드래프트 | draft | =, != |
| 환경 | environment | = |
| ID | id | =, in |
| 하위 그룹 포함 | includeSubgroups | =, != |
| 라벨 | label, labels | =, != |
| 머지 시각 | merged, mergedAt | =, >, <, >=, <= |
| 머지한 사용자 | merger, mergedBy | = |
| 마일스톤 | milestone | =, != |
| 나의 반응 이모지 | myReaction, myReactionEmoji | =, != |
| 리뷰어 | reviewer, reviewers, reviewedBy | =, != |
| 소스 브랜치 | sourceBranch | =, in, != |
| 상태 | state | = |
| 구독 여부 | subscribed | =, != |
| 타깃 브랜치 | targetBranch | =, in, != |
| 배포 시각 | deployed, deployedAt | =, >, <, >=, <= |
| 업데이트 시각 | updated, updatedAt | =, >, <, >=, <= |
사용자별 승인#
History
설명: 머지 리퀘스트를 승인한 한 명 이상의 사용자를 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형:
-
String -
User(예:@username) -
List(String또는User값 포함) -
Nullable(null,none,any중 하나)
담당자#
설명: 담당자로 지정된 한 명 이상의 사용자를 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형:
-
String -
User(예:@username) -
Nullable(null,none,any중 하나)
참고:
List값과in연산자는 머지 리퀘스트에서 지원되지 않습니다.
작성자#
설명: 작성자를 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형:
-
String -
User(예:@username)
참고:
in연산자는 머지 리퀘스트에서 지원되지 않습니다.
종료 시각#
설명: 머지 리퀘스트가 종료된 날짜를 기준으로 조회합니다.
허용 값 유형:
-
AbsoluteDate(YYYY-MM-DD형식) -
RelativeDate(<sign><digit><unit>형식, 여기서 sign은+,-, 또는 생략 가능,
digit은 정수이며, unit은 d(일), w(주), m(월), y(년) 중 하나입니다)
참고 사항:
-
=연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다. -
>=및<=연산자는 쿼리 대상 날짜를 포함하지만,>및<는 포함하지 않습니다.
생성일#
설명: 머지 리퀘스트가 생성된 날짜로 쿼리합니다.
허용 값 유형:
-
AbsoluteDate(YYYY-MM-DD형식) -
RelativeDate(<sign><digit><unit>형식으로, sign은+,-, 또는 생략 가능하며, digit은 정수이고,unit은d(일),w(주),m(월),y(년) 중 하나입니다)
참고 사항:
-
=연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다. -
>=및<=연산자는 쿼리 대상 날짜를 포함하지만,>및<는 포함하지 않습니다.
드래프트#
History
- GitLab 17.8에서 도입됨.
설명: 머지 리퀘스트를 드래프트 상태로 쿼리합니다.
허용 값 유형:
Boolean(true또는false)
배포일#
설명: 머지 리퀘스트가 배포된 날짜로 쿼리합니다.
허용 값 유형:
-
AbsoluteDate(YYYY-MM-DD형식) -
RelativeDate(<sign><digit><unit>형식으로, sign은+,-, 또는 생략 가능하며, digit은 정수이고,unit은d(일),w(주),m(월),y(년) 중 하나입니다)
참고 사항:
-
=연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다. -
>=및<=연산자는 쿼리 대상 날짜를 포함하지만,>및<는 포함하지 않습니다.
환경#
History
- GitLab 17.8에서 도입됨.
설명: 머지 리퀘스트가 배포된 환경으로 쿼리합니다.
허용 값 유형: String
ID#
설명: 머지 리퀘스트를 ID로 쿼리합니다.
허용 값 유형:
-
Number(양의 정수만 허용) -
List(Number값을 포함하는 목록)
하위 그룹 포함#
설명: 그룹의 전체 계층 구조에서 머지 리퀘스트를 쿼리합니다.
허용 값 유형:
Boolean(true또는false)
참고 사항:
-
이 필드는
group범위에서만 사용할 수 있습니다. -
이 필드의 기본값은
false입니다.
라벨#
설명: 머지 리퀘스트를 연관된 라벨로 쿼리합니다.
허용 값 유형:
-
String -
Label(예:~bug,~"team::planning") -
Nullable(none또는any)
참고 사항:
-
in연산자는 머지 리퀘스트에서 지원되지 않습니다. -
범위 지정 라벨 또는 공백이 포함된 라벨은 따옴표로 묶어야 합니다.
머지일#
History
설명: 머지 리퀘스트가 머지된 날짜로 쿼리합니다.
허용 값 유형:
-
AbsoluteDate(YYYY-MM-DD형식) -
RelativeDate(<부호><숫자><단위>형식, 부호는+,-또는 생략 가능, 숫자는 정수,단위는d(일),w(주),m(월),y(년) 중 하나)
참고 사항:
-
=연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00부터 23:59까지로 간주됩니다. -
>=및<=연산자는 조회 날짜를 포함하며,>및<는 포함하지 않습니다.
머지한 사용자#
History
설명: 머지 리퀘스트를 머지한 사용자를 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형:
-
String -
User(예:@username)
마일스톤#
설명: 연결된 마일스톤을 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형:
-
String -
Milestone(예:%Backlog,%"Awaiting Further Demand") -
Nullable(none또는any중 하나)
참고 사항:
-
in연산자는 머지 리퀘스트에서 지원되지 않습니다. -
공백이 포함된 마일스톤은 큰따옴표(
")로 감싸야 합니다.
나의 반응 이모지#
설명: 현재 사용자가 해당 머지 리퀘스트에 남긴 이모지 반응을 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형: String
리뷰어#
History
- 별칭
reviewers및reviewedBy가 GitLab 18.0에서 도입됨.
설명: 한 명 이상의 사용자가 리뷰한 머지 리퀘스트를 조회합니다.
허용 값 유형:
-
String -
User(예:@username) -
Nullable(null,none, 또는any중 하나)
소스 브랜치#
History
- GitLab 18.2에서 도입됨.
설명: 소스 브랜치를 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형: String, List
참고 사항:
List값은in및!=연산자에서만 지원됩니다.
상태#
설명: 상태를 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형:
Enum,opened,closed,merged, 또는all중 하나
참고 사항:
state필드는!=연산자를 지원하지 않습니다.
구독됨#
설명: 현재 사용자가 알림을 설정했는지 여부를 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형: Boolean
타깃 브랜치#
History
- GitLab 18.2에서 도입됨.
설명: 타깃 브랜치를 기준으로 머지 리퀘스트를 조회합니다.
허용 값 유형: String, List
참고 사항:
List값은in및!=연산자에서만 지원됩니다.
업데이트 날짜#
설명: 마지막으로 업데이트된 날짜를 기준으로 머지 리퀘스트를 쿼리합니다.
허용되는 값 유형:
-
AbsoluteDate(YYYY-MM-DD형식) -
RelativeDate(<부호><숫자><단위>형식, 부호는+,-, 또는 생략 가능, 숫자는 정수,단위는d(일),w(주),m(월),y(년) 중 하나)
참고 사항:
-
=연산자를 사용하는 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다. -
>=및<=연산자는 쿼리 대상 날짜를 포함하지만,>및<는 포함하지 않습니다.
표시 필드#
History
| 필드 | 이름 또는 별칭 | 설명 |
|---|---|---|
| Approved | approved | 머지 리퀘스트의 승인 여부를 Yes 또는 No로 표시 |
| Approved by user | approver, approvers, approvedBy | 머지 리퀘스트를 승인한 사용자 표시 |
| Assignees | assignee, assignees | 머지 리퀘스트에 할당된 사용자 표시 |
| Author | author | 머지 리퀘스트 작성자 표시 |
| Closed at | closed, closedAt | 머지 리퀘스트가 닫힌 이후 경과 시간 표시 |
| Created at | created, createdAt | 머지 리퀘스트가 생성된 이후 경과 시간 표시 |
| Description | description | 머지 리퀘스트의 설명 표시 |
| Draft | draft | 머지 리퀘스트가 초안 상태인지 여부를 Yes 또는 No로 표시 |
| ID | id | 머지 리퀘스트의 ID 표시 |
| Labels | label, labels | 머지 리퀘스트에 연결된 라벨 표시 |
| Last comment | lastComment | 머지 리퀘스트에 달린 마지막 댓글 표시 |
| Merged at | merged, mergedAt | 머지 리퀘스트가 머지된 이후 경과 시간 표시 |
| Merged by user | merger, mergedBy | 머지 리퀘스트를 머지한 사용자 표시 |
| Milestone | milestone | 머지 리퀘스트에 연결된 마일스톤 표시 |
| Project | project | 머지 리퀘스트가 속한 프로젝트 표시 |
| Reviewers | reviewer, reviewers | 머지 리퀘스트 리뷰에 할당된 사용자 표시 |
| Source branch | sourceBranch | 머지 리퀘스트의 소스 브랜치 표시 |
| Source project | sourceProject | 머지 리퀘스트의 소스 프로젝트 표시 |
| State | state | 상태를 나타내는 배지 표시. 값은 Open, Closed, Merged |
| Subscribed | subscribed | 현재 사용자의 구독 여부를 Yes 또는 No로 표시 |
| Target branch | targetBranch | 머지 리퀘스트의 타깃 브랜치 표시 |
| Target project | targetProject | 머지 리퀘스트의 타깃 프로젝트 표시 |
| Time estimate | timeEstimate | 머지 리퀘스트의 예상 소요 시간 표시 |
| Title | title | 머지 리퀘스트의 제목 표시 |
| Total time spent | totalTimeSpent | 머지 리퀘스트에 소요된 총 시간 표시 |
| Updated at | updated, updatedAt | 머지 리퀘스트가 마지막으로 업데이트된 이후 경과 시간 표시 |
정렬 필드#
| 필드 | 이름(및 별칭) | 설명 |
|---|---|---|
| Closed at | closed, closedAt | 닫힌 날짜 기준 정렬 |
| Created | created, createdAt | 생성 날짜 기준 정렬 |
| Merged at | merged, mergedAt | 머지 날짜 기준 정렬 |
| Milestone | milestone | 마일스톤 만료일 기준 정렬 |
| Popularity | popularity | 엄지 위 이모지 반응 수 기준 정렬 |
| Title | title | 제목 기준 정렬 |
| Updated at | updated, updatedAt | 마지막 업데이트 날짜 기준 정렬 |
예시#
gitlab-org 그룹에서 내가 생성한 모든 머지 리퀘스트를 머지 날짜(최신순) 기준으로 정렬하여 나열합니다:
```glql
display: table
fields: title, reviewer, merged
sort: merged desc
query: group = "gitlab-org" and type = MergeRequest and state = merged and author = currentUser()
limit: 10