GitLab connector reference
This feature is in Beta. To use it, a workspace admin must turn on Lakeflow Connect for GitLab from the Previews page. See Manage Databricks previews.
This page has reference information for the managed GitLab connector, including supported source tables and destination table schemas.
Supported source tables
The GitLab connector supports the following source tables, all under the default source schema:
Source table | Primary key | Description | Sync mode | Cursor field |
|---|---|---|---|---|
|
| GitLab groups that the authenticating user is a member of. | Full refresh only | |
|
| GitLab projects that the authenticating user is a member of. | Full refresh only | |
|
| Issues across the member projects. | Incremental |
|
|
| Merge requests across the member projects. | Incremental |
|
|
| Repository commits for each member project. | Incremental |
|
|
| CI/CD pipelines for each project. | Incremental |
|
|
| Members of each project. | Full refresh only | |
|
| Repository branches for each project. | Full refresh only | |
|
| Repository tags for each project. | Full refresh only | |
|
| Releases for each project. | Full refresh only | |
|
| Deployments for each project. | Incremental |
|
|
| CI/CD jobs for each pipeline. | Full refresh only | |
|
| Labels defined in each project. | Full refresh only | |
|
| Milestones for each project. | Incremental |
|
|
| Users with access to each project. | Full refresh only | |
|
| Labels defined in each group. | Full refresh only | |
|
| Milestones for each group. | Incremental |
|
|
| Members of each group. | Full refresh only | |
|
| Issue boards for each group. | Full refresh only | |
|
| Epics for each group. Requires a GitLab Premium or Ultimate group. | Incremental |
|
|
| Commits on each merge request. | Full refresh only | |
|
| Issues linked to each epic. Requires a GitLab Premium or Ultimate group. | Full refresh only | |
|
| Extended detail for each pipeline. | Full refresh only | |
|
| Iterations for each group. Requires a GitLab Premium or Ultimate group. | Incremental |
|
|
| Epic boards for each group. Requires a GitLab Premium or Ultimate group. | Full refresh only | |
|
| Discussion threads on each merge request. | Full refresh only | |
|
| Security vulnerabilities for each project. Requires a GitLab Ultimate project. | Full refresh only | |
|
| Compliance frameworks for each group. Requires a GitLab Ultimate group. | Full refresh only |
Connector options
For usage, see Examples.
Option | Type | Scope | Required | Applies to | Description |
|---|---|---|---|---|---|
| string | Pipeline | No | All incremental tables | The earliest record timestamp to ingest on the first sync, in |
Destination table schemas
groups
Primary key: id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
projects
Primary key: id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
issues
Primary key: id
Cursor field: updated_at
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
merge_requests
Primary key: id
Cursor field: updated_at
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
commits
Primary key: id
Cursor field: created_at
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support SCD type 2 because it has VARIANT columns.
pipelines
Primary key: id
Cursor field: updated_at
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
project_members
Primary key: project_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
branches
Primary key: project_id, name
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
tags
Primary key: project_id, name
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
releases
Primary key: project_id, tag_name
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support SCD type 2 because it has VARIANT columns.
deployments
Primary key: id
Cursor field: updated_at
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support SCD type 2 because it has VARIANT columns.
jobs
Primary key: id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
project_labels
Primary key: project_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
project_milestones
Primary key: id
Cursor field: updated_at
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
users
Primary key: project_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
group_labels
Primary key: group_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
group_milestones
Primary key: id
Cursor field: updated_at
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
group_members
Primary key: group_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
group_issue_boards
Primary key: group_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
epics
Primary key: id
Cursor field: updated_at
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support SCD type 2 because it has VARIANT columns.
merge_request_commits
Primary key: project_id, merge_request_iid, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support SCD type 2 because it has VARIANT columns.
epic_issues
Primary key: group_id, epic_iid, epic_issue_id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This table does not support SCD type 2 because it has VARIANT columns.
pipelines_extended
Primary key: project_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
group_iterations
Primary key: group_id, id
Cursor field: updated_at
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
epic_boards
Primary key: group_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
merge_request_discussions
Primary key: project_id, merge_request_iid, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
This table does not support SCD type 2 because it has VARIANT columns.
vulnerabilities
Primary key: project_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
compliance_frameworks
Primary key: group_id, id
Sync mode: Full refresh only
Field | Data type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|