히스토리

• GitLab 17.8에서 도입되었습니다.

허용 모드#

• 표준 모드(기본값): 머지 리퀘스트 레코드를 조회합니다.
• 분석 모드: 집계된 머지 리퀘스트 메트릭을 조회합니다. 자세한 내용은 머지 리퀘스트 분석을 참고합니다.

허용 범위#

자세한 내용은 범위를 참고합니다.

쿼리 필드#

query 매개변수에 다음 필드를 사용하여 결과를 필터링합니다.

사용자별 승인 {#mr-approved-by-user}#

히스토리

• GitLab 17.8에서 도입되었습니다.
• GitLab 18.0에서 별칭 approvedBy와 approvers가 도입되었습니다.
• GitLab 18.3에서 Nullable 값 지원이 도입되었습니다.

설명: 머지 리퀘스트를 승인한 한 명 이상의 사용자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• String
• User (예: @username)
• List (String 또는 User 값 포함)
• Nullable (null, none, any 중 하나)

담당자 {#mr-assignees}#

설명: 담당자로 지정된 한 명 이상의 사용자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• String
• User (예: @username)
• Nullable (null, none, any 중 하나)

참고:

• List 값과 in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

작성자 {#mr-author}#

설명: 작성자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• String
• User (예: @username)

참고:

• in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

종료 시각 {#mr-closed-at}#

설명: 닫힌 날짜를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• AbsoluteDate (YYYY-MM-DD 형식)
• RelativeDate (<sign><digit><unit> 형식이며, sign은 +, - 또는 생략, digit은 정수, unit은 d(일), w(주), m(월), y(년) 중 하나)

참고:

• = 연산자에서는 시간 범위를 사용자 표준 시간대의 00:00부터 23:59까지로 간주합니다.

생성 시각 {#mr-created-at}#

설명: 생성된 날짜를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• AbsoluteDate (YYYY-MM-DD 형식)
• RelativeDate (<sign><digit><unit> 형식이며, sign은 +, - 또는 생략, digit은 정수, unit은 d(일), w(주), m(월), y(년) 중 하나)

참고:

• = 연산자에서는 시간 범위를 사용자 표준 시간대의 00:00부터 23:59까지로 간주합니다.

드래프트 {#mr-draft}#

히스토리

• GitLab 17.8에서 도입되었습니다.

설명: 드래프트 상태를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• Boolean (true 또는 false)

배포 시각 {#mr-deployed-at}#

설명: 배포된 날짜를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• AbsoluteDate (YYYY-MM-DD 형식)
• RelativeDate (<sign><digit><unit> 형식이며, sign은 +, - 또는 생략, digit은 정수, unit은 d(일), w(주), m(월), y(년) 중 하나)

참고:

• = 연산자에서는 시간 범위를 사용자 표준 시간대의 00:00부터 23:59까지로 간주합니다.

환경 {#mr-environment}#

히스토리

• GitLab 17.8에서 도입되었습니다.

설명: 배포된 환경을 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String

ID {#mr-identifier}#

설명: ID를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• Number (양의 정수만 해당)
• List (Number 값 포함)

하위 그룹 포함 {#mr-include-subgroups}#

설명: 그룹의 전체 계층 구조에서 머지 리퀘스트를 조회합니다.

허용 값 유형:

• Boolean (true 또는 false)

참고:

• 이 필드는 group 범위에서만 사용할 수 있습니다.
• 이 필드의 기본값은 false 입니다.

레이블 {#mr-labels}#

설명: 연결된 레이블을 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• String
• Label (예: ~bug, ~"team::planning")
• Nullable (none 또는 any 중 하나)

참고:

• in 연산자는 머지 리퀘스트에서 지원되지 않습니다.
• 범위 지정 레이블이나 공백이 포함된 레이블은 따옴표로 묶어야 합니다.

머지 시각 {#mr-merged-at}#

히스토리

• GitLab 17.8에서 도입되었습니다.
• GitLab 18.0에서 별칭 mergedAt 이 도입되었습니다.
• GitLab 18.0에서 >=와 <= 연산자가 도입되었습니다.

설명: 머지된 날짜를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• AbsoluteDate (YYYY-MM-DD 형식)
• RelativeDate (<sign><digit><unit> 형식이며, sign은 +, - 또는 생략, digit은 정수, unit은 d(일), w(주), m(월), y(년) 중 하나)

참고:

• = 연산자에서는 시간 범위를 사용자 표준 시간대의 00:00부터 23:59까지로 간주합니다.

머지한 사용자 {#mr-merged-by-user}#

히스토리

• GitLab 17.8에서 도입되었습니다.
• GitLab 18.0에서 별칭 mergedBy가 도입되었습니다.

설명: 머지 리퀘스트를 머지한 사용자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• String
• User (예: @username)

마일스톤 {#mr-milestone}#

설명: 연결된 마일스톤을 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• String
• Milestone (예: %Backlog, %"Awaiting Further Demand")
• Nullable (none 또는 any 중 하나)

참고:

• in 연산자는 머지 리퀘스트에서 지원되지 않습니다.
• 공백이 포함된 마일스톤은 따옴표(")로 묶어야 합니다.

나의 반응 이모지 {#mr-my-reaction-emoji}#

설명: 현재 사용자가 남긴 이모지 반응을 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String

리뷰어 {#mr-reviewers}#

히스토리

• GitLab 18.0에서 별칭 reviewers와 reviewedBy가 도입되었습니다.

설명: 한 명 이상의 사용자가 리뷰한 머지 리퀘스트를 조회합니다.

허용 값 유형:

• String
• User (예: @username)
• Nullable (null, none, any 중 하나)

소스 브랜치 {#mr-source-branch}#

히스토리

• GitLab 18.2에서 도입되었습니다.

설명: 소스 브랜치를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String, List

참고:

• List 값은 in 및 != 연산자에서만 지원됩니다.

상태 {#mr-state}#

설명: 상태를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• Enum, opened, closed, merged, all 중 하나

참고:

• state 필드는 != 연산자를 지원하지 않습니다.

구독 여부 {#mr-subscribed}#

설명: 현재 사용자의 알림 설정 켜짐 여부를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: Boolean

대상 브랜치 {#mr-target-branch}#

히스토리

• GitLab 18.2에서 도입되었습니다.

설명: 대상 브랜치를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String, List

참고:

• List 값은 in 및 != 연산자에서만 지원됩니다.

업데이트 시각 {#mr-updated-at}#

설명: 마지막으로 업데이트된 시점을 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

• AbsoluteDate (YYYY-MM-DD 형식)
• RelativeDate (<sign><digit><unit> 형식이며, sign은 +, - 또는 생략, digit은 정수, unit은 d(일), w(주), m(월), y(년) 중 하나)

참고:

• = 연산자에서는 시간 범위를 사용자 표준 시간대의 00:00부터 23:59까지로 간주합니다.

표시 필드#

히스토리

• GitLab 17.8에서 도입되었습니다.
• GitLab 18.2에서 sourceBranch, targetBranch, sourceProject, targetProject 필드가 도입되었습니다.

정렬 필드#

예시#

• 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
  ```