InfoGrab DocsInfoGrab Docs

GLQL 표시 유형

요약

- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated GitLab 17.4에서 glql_integration이라는 플래그와 함께 도입됨. GitLab 18.3에서 일반적으로 사용 가능해짐.

GLQL 표시 유형#

  - 
  Tier: Free, Premium, Ultimate

- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

History

표시 유형은 임베디드 뷰가 GLQL 쿼리 결과를 렌더링하는 방식을 제어합니다. 뷰 소스의 display 파라미터로 표시 유형을 설정합니다.

display 파라미터를 설정하지 않으면 결과는 목록으로 렌더링됩니다.

일부 표시 유형은 모든 쿼리에서 동작합니다. 다른 유형은 데이터를 차원과 메트릭으로 집계하는 분석 모드에서만 동작합니다.

다음 표시 유형은 모든 모드에서 사용할 수 있습니다:

표시 유형 display 값 설명
Table table 결과당 한 행, 필드당 한 칼럼으로 구성된 테이블.
List list 결과를 순서 없는 목록으로 표시.
Ordered list orderedList 결과를 번호 목록으로 표시.

다음 표시 유형은 분석 모드에서만 사용할 수 있습니다:

표시 유형 display 값 설명
Column chart columnChart 차원에서 정의한 카테고리별로 메트릭을 비교하는 차트.
Line chart lineChart 추세를 표시하기 위해 하나 이상의 메트릭을 차원에 따라 선으로 나타내는 차트.

Table#

테이블은 결과당 한 행, 필드당 한 칼럼으로 렌더링됩니다.

칼럼을 기준으로 테이블을 정렬하려면 칼럼 헤더를 선택하세요. 이 뷰는 전체 결과 집합이 아닌 뷰에 로드된 행의 순서를 변경합니다.

예시#

gitlab-org/gitlab 프로젝트에서 현재 사용자에게 할당된 처음 다섯 개의 열린 이슈를 title, state, health, epic, milestone, weight, updated 칼럼과 함께 테이블로 표시하려면:

```glql
display: table
title: My open issues
fields: title, state, health, epic, milestone, weight, updated
limit: 5
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened


## List

목록은 결과를 순서 없는 목록으로 렌더링합니다. 목록은 기본 표시 유형입니다.

### 예시

`gitlab-org/gitlab` 프로젝트에서 현재 사용자에게 할당된 처음 다섯 개의 열린 이슈를
마감일이 가장 빠른 순서로 정렬하고 `title`, `health`, `due` 필드를 보여주는
목록으로 표시하려면:

  

display: list
fields: title, health, due
limit: 5
sort: due asc
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened


## Ordered list

순서 있는 목록은 결과를 번호 목록으로 렌더링합니다.
순위와 같이 결과의 순서가 의미 있는 경우 순서 있는 목록을 사용하세요.

### 예시

`gitlab-org/gitlab` 프로젝트에서 현재 사용자에게 할당된 처음 다섯 개의 열린 이슈를
마감일이 가장 빠른 순서로 정렬하고 `title`, `health`, `due` 필드를 보여주는
순서 있는 목록으로 표시하려면:

  

display: orderedList
fields: title, health, due
limit: 5
sort: due asc
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened


## Column chart

History
    
    

- GitLab 19.1에서 [도입됨](https://gitlab.com/groups/gitlab-org/-/epics/21212).

칼럼 차트는 [분석 모드](/19.1/user/glql/#analytics-mode)에서 집계된 데이터를 시각화합니다.
칼럼 차트를 사용하여 차원으로 정의한 카테고리 간의 메트릭을 비교하세요.

칼럼 차트에는 다음이 필요합니다:

- `mode: analytics`로 설정하는 분석 모드.

- 결과를 그룹화할 하나 또는 두 개의 `dimensions`.

- 플로팅할 메트릭이 하나 이상 필요합니다(`metrics` 파라미터 사용).

차원 및 메트릭 수에 따라 차트 렌더링 방식이 결정됩니다:

- 하나의 차원에 하나 이상의 메트릭이 있는 경우, 각 메트릭마다 칼럼이 그려집니다. 이 칼럼들을 쌓으려면
`displayConfig` 아래에 `stacked: true`를 설정하세요.

- 두 개의 차원에 하나의 메트릭이 있는 경우, 두 번째 차원으로 그룹화된 누적 칼럼 차트가 그려집니다.
두 개의 차원을 사용할 때는 메트릭을 하나만 사용할 수 있습니다.

### 예시

지난 30일간 언어별 Code Suggestions 사용량을 칼럼 차트로 표시하려면:

  

display: columnChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount


메트릭을 나란히 표시하는 대신 단일 칼럼으로 쌓으려면:

  

display: columnChart
displayConfig:
  stacked: true
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: acceptedCount, rejectedCount


## 라인 차트

History
    
    
- GitLab 19.1에서 [도입됨](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/240016).

라인 차트는 [분석 모드](/19.1/user/glql/#analytics-mode)에서 집계된 데이터를 하나 이상의
라인으로 시각화합니다. 라인 차트를 사용하여 시간 경과 등 차원에 따라 메트릭이 어떻게 변화하는지 보여주세요.

라인 차트에는 다음이 필요합니다:

- `mode: analytics`로 설정하는 분석 모드.

- x축에 사용할 정확히 하나의 `dimension`.

- 플로팅할 하나 이상의 `metric`. 각 메트릭은 별도의 라인으로 렌더링됩니다.

### 예시

지난 30일간 언어별 Code Suggestions 사용량을 라인 차트로 표시하되, 전체 제안 수와 수락된 제안 수를 각각 하나의 라인으로 표시하려면:

  

display: lineChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount, acceptedCount


## 페이지네이션 지원

모든 모드에서 사용 가능한 표시 유형은 결과의 첫 번째 페이지를 표시하고 추가 페이지를 가져오는 **더 불러오기**
액션을 제공합니다. 자세한 내용은 [페이지네이션](/19.1/user/glql/#pagination)을 참조하세요.

분석 모드 시각화는 페이지네이션을 지원하지 않습니다. 집계된 모든 결과를 한 번에 렌더링합니다.

GLQL 표시 유형

GitLab v19.1
원문 보기
요약

- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated GitLab 17.4에서 glql_integration이라는 플래그와 함께 도입됨. GitLab 18.3에서 일반적으로 사용 가능해짐.

GLQL 표시 유형#

  - 
  Tier: Free, Premium, Ultimate

- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

History

표시 유형은 임베디드 뷰가 GLQL 쿼리 결과를 렌더링하는 방식을 제어합니다. 뷰 소스의 display 파라미터로 표시 유형을 설정합니다.

display 파라미터를 설정하지 않으면 결과는 목록으로 렌더링됩니다.

일부 표시 유형은 모든 쿼리에서 동작합니다. 다른 유형은 데이터를 차원과 메트릭으로 집계하는 분석 모드에서만 동작합니다.

다음 표시 유형은 모든 모드에서 사용할 수 있습니다:

표시 유형 display 값 설명
Table table 결과당 한 행, 필드당 한 칼럼으로 구성된 테이블.
List list 결과를 순서 없는 목록으로 표시.
Ordered list orderedList 결과를 번호 목록으로 표시.

다음 표시 유형은 분석 모드에서만 사용할 수 있습니다:

표시 유형 display 값 설명
Column chart columnChart 차원에서 정의한 카테고리별로 메트릭을 비교하는 차트.
Line chart lineChart 추세를 표시하기 위해 하나 이상의 메트릭을 차원에 따라 선으로 나타내는 차트.

Table#

테이블은 결과당 한 행, 필드당 한 칼럼으로 렌더링됩니다.

칼럼을 기준으로 테이블을 정렬하려면 칼럼 헤더를 선택하세요. 이 뷰는 전체 결과 집합이 아닌 뷰에 로드된 행의 순서를 변경합니다.

예시#

gitlab-org/gitlab 프로젝트에서 현재 사용자에게 할당된 처음 다섯 개의 열린 이슈를 title, state, health, epic, milestone, weight, updated 칼럼과 함께 테이블로 표시하려면:

```glql
display: table
title: My open issues
fields: title, state, health, epic, milestone, weight, updated
limit: 5
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened


## List

목록은 결과를 순서 없는 목록으로 렌더링합니다. 목록은 기본 표시 유형입니다.

### 예시

`gitlab-org/gitlab` 프로젝트에서 현재 사용자에게 할당된 처음 다섯 개의 열린 이슈를
마감일이 가장 빠른 순서로 정렬하고 `title`, `health`, `due` 필드를 보여주는
목록으로 표시하려면:

  

display: list
fields: title, health, due
limit: 5
sort: due asc
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened


## Ordered list

순서 있는 목록은 결과를 번호 목록으로 렌더링합니다.
순위와 같이 결과의 순서가 의미 있는 경우 순서 있는 목록을 사용하세요.

### 예시

`gitlab-org/gitlab` 프로젝트에서 현재 사용자에게 할당된 처음 다섯 개의 열린 이슈를
마감일이 가장 빠른 순서로 정렬하고 `title`, `health`, `due` 필드를 보여주는
순서 있는 목록으로 표시하려면:

  

display: orderedList
fields: title, health, due
limit: 5
sort: due asc
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened


## Column chart

History
    
    

- GitLab 19.1에서 [도입됨](https://gitlab.com/groups/gitlab-org/-/epics/21212).

칼럼 차트는 [분석 모드](/19.1/user/glql/#analytics-mode)에서 집계된 데이터를 시각화합니다.
칼럼 차트를 사용하여 차원으로 정의한 카테고리 간의 메트릭을 비교하세요.

칼럼 차트에는 다음이 필요합니다:

- `mode: analytics`로 설정하는 분석 모드.

- 결과를 그룹화할 하나 또는 두 개의 `dimensions`.

- 플로팅할 메트릭이 하나 이상 필요합니다(`metrics` 파라미터 사용).

차원 및 메트릭 수에 따라 차트 렌더링 방식이 결정됩니다:

- 하나의 차원에 하나 이상의 메트릭이 있는 경우, 각 메트릭마다 칼럼이 그려집니다. 이 칼럼들을 쌓으려면
`displayConfig` 아래에 `stacked: true`를 설정하세요.

- 두 개의 차원에 하나의 메트릭이 있는 경우, 두 번째 차원으로 그룹화된 누적 칼럼 차트가 그려집니다.
두 개의 차원을 사용할 때는 메트릭을 하나만 사용할 수 있습니다.

### 예시

지난 30일간 언어별 Code Suggestions 사용량을 칼럼 차트로 표시하려면:

  

display: columnChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount


메트릭을 나란히 표시하는 대신 단일 칼럼으로 쌓으려면:

  

display: columnChart
displayConfig:
  stacked: true
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: acceptedCount, rejectedCount


## 라인 차트

History
    
    
- GitLab 19.1에서 [도입됨](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/240016).

라인 차트는 [분석 모드](/19.1/user/glql/#analytics-mode)에서 집계된 데이터를 하나 이상의
라인으로 시각화합니다. 라인 차트를 사용하여 시간 경과 등 차원에 따라 메트릭이 어떻게 변화하는지 보여주세요.

라인 차트에는 다음이 필요합니다:

- `mode: analytics`로 설정하는 분석 모드.

- x축에 사용할 정확히 하나의 `dimension`.

- 플로팅할 하나 이상의 `metric`. 각 메트릭은 별도의 라인으로 렌더링됩니다.

### 예시

지난 30일간 언어별 Code Suggestions 사용량을 라인 차트로 표시하되, 전체 제안 수와 수락된 제안 수를 각각 하나의 라인으로 표시하려면:

  

display: lineChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount, acceptedCount


## 페이지네이션 지원

모든 모드에서 사용 가능한 표시 유형은 결과의 첫 번째 페이지를 표시하고 추가 페이지를 가져오는 **더 불러오기**
액션을 제공합니다. 자세한 내용은 [페이지네이션](/19.1/user/glql/#pagination)을 참조하세요.

분석 모드 시각화는 페이지네이션을 지원하지 않습니다. 집계된 모든 결과를 한 번에 렌더링합니다.