GitLab Query Language(GLQL)에서 필드는 다음 용도로 사용됩니다:

• GLQL 쿼리에서 반환되는 결과를 필터링합니다.
• 임베드된 뷰에 표시되는 세부 정보를 제어합니다.
• 임베드된 뷰에 표시되는 결과를 정렬합니다.

세 가지 임베드된 뷰 파라미터에서 필드를 사용합니다:

• query - 검색할 항목을 결정하는 조건을 설정합니다. query 파라미터는 <필드> <연산자> <값> 형식의 하나 이상의 표현식을 포함할 수 있습니다. 여러 표현식은 and로 연결됩니다. 예: group = "gitlab-org" and author = currentUser().

• fields - 뷰에 표시할 열과 세부 정보를 지정합니다. 필드 또는 필드 함수의 쉼표로 구분된 목록입니다. 예: fields: title, state, health, epic, milestone, weight, updated.

• sort - 특정 기준으로 항목을 정렬합니다. 정렬 순서(asc 또는 desc)가 뒤따르는 필드 이름입니다. 예: sort: updated desc.

데이터 소스#

지원되는 데이터 소스 및 해당 필드 목록은 GLQL 데이터 소스를 참조하세요.

문제 해결#

쿼리 타임아웃 오류#

다음 오류 메시지가 발생할 수 있습니다:

Embedded view timed out. Add more filters to reduce the number of results.

Query temporarily blocked due to repeated timeouts. Please try again later or try narrowing your search scope.

이러한 오류는 쿼리 실행 시간이 너무 길 때 발생합니다. 대용량 결과셋과 광범위한 검색은 타임아웃을 유발할 수 있습니다.

이 문제를 해결하려면 검색 범위를 제한하는 필터를 추가하세요:

• created, updated, closed와 같은 날짜 필드를 사용하여 결과를 특정 기간으로 제한하는 시간 범위 필터를 추가합니다. 예:

  ```glql
  display: table
  fields: title, labels, created
  query: type = Issue and group = "gitlab-org" and label = "group::knowledge" and created > "2025-01-01" and created < "2025-03-01"
  ```
  

• 최근 업데이트를 기준으로 필터링하여 활성 항목에 집중합니다:

  ```glql
  display: table
  fields: title, labels, updated
  query: type = Issue and group = "gitlab-org" and label = "group::knowledge" and updated > -3m
  ```
  

• 가능하면 그룹 전체 검색 대신 프로젝트별 쿼리를 사용합니다:

  ```glql
  display: table
  fields: title, state, assignee
  query: type = Issue and project = "gitlab-org/gitlab" and state = opened and updated > -1m
  ```
  

오류: 유효하지 않은 사용자 이름 참조#

GLQL 쿼리에서 숫자로 시작하는 사용자 이름과 함께 @ 기호를 사용할 때 Invalid username reference 오류가 발생할 수 있습니다. 예:

An error occurred when trying to display this embedded view:
* Error: Invalid username reference @123username

이 문제는 GLQL 임베드된 뷰 렌더러가 GitLab에서는 유효하더라도 숫자로 시작하는 사용자 이름에 대한 @ 멘션을 지원하지 않기 때문에 발생합니다.

해결 방법은 @ 기호를 제거하고 사용자 이름을 따옴표로 감싸는 것입니다. 예를 들어, assignee = @123username 대신 assignee = "123username"을 사용하세요.

자세한 내용은 이슈 583119를 참조하세요.