ContextQMD
Back to Gitlabhq

GLQL data sources

doc/user/glql/data_sources/_index.md

19.0.01.4 KB
Original Source

GLQL can query the following data sources:

Data sourcetype valuesDescription
Work itemsIssue, Incident, TestCase, Requirement, Task, Ticket, Objective, KeyResult, EpicIssues, epics, and other work item types. Default when type is omitted.
Merge requestsMergeRequestCode review and merge workflow.
PipelinesPipelineCI/CD pipelines.
JobsJobCI/CD jobs within pipelines.
ProjectsProjectProjects within a namespace.

Each data source has its own set of supported fields for filtering, display, and sorting.

Specify the data source in your query by using the type field. For example, type = Issue or type = MergeRequest. For data sources that support multiple types, use the in operator to query across types. For example, type in (Issue, Task).

Scopes

Each data source requires a scope to define where to query data from. The allowed scopes vary by data source and are documented on each data source page.

Define the scope in your query. For example:

yaml
query: type = issue and project = "gitlab-org/gitlab"

If you don't specify a scope, GLQL infers it from where the query is embedded:

  • In a project context (such as an issue or merge request description), GLQL uses the current project.
  • In a group context (such as an epic description), GLQL uses the current group.