Skip to main content
Version: 3.2

2.2 Queue Jobs

Queue Jobs is where DCH runs and tracks its data-processing jobs. Every time a Build runs, or a Workflow is executed, DCH creates a job here and works through it in the background. This page lets you follow each job's progress, inspect its stages, and cancel or restart it.

The Queue Jobs list: status tabs across the top and a table of jobs with their status, involved entities, and per-row actions

Jobs are picked up from a queue and processed a few at a time, so a job may wait as Queued before it starts.

Job list​

Each row represents one job and shows:

  • ID: the job's unique identifier.
  • Status: where the job is in its lifecycle (see Status).
  • Involved entities: the Target Entities the job processes.
  • Involved data sources: the data sources the job imports from.
  • Started at: when the job began.

Choose Refresh to reload the list. You can sort by ID or Started at.

Status​

A job moves through these statuses:

  • Queued: waiting in the queue to be picked up.
  • Processing: currently running.
  • Finished: completed successfully.
  • Error: stopped because a step failed.
  • Canceled: stopped because you canceled it.

The tabs above the table filter the list by status: All, Queued, Processing, Finished, Error, and Canceled.

Find a job​

The filter row narrows the list:

  • Search: match jobs by text.
  • Filter by date: restrict to a date range, with quick options such as Today and the last few minutes.
  • Filter by target entity: show only jobs involving the entities you pick.
  • Filter by data source: show only jobs importing from the data sources you pick.

Job stages​

Every job is broken into stages that run in order:

  • Preparation: DCH gets the job ready to run.
  • Import: one step per entity and Data Import Configuration, loading rows into the staging layer.
  • Processing: the staged data is processed into the knowledge graph, including rebuilding the entity's relationships. This stage runs only when the job writes to the graph.

Each step reports its own status (Pending, In Progress, Completed, Failed, or Canceled) along with counts such as rows and batches.

Inspect a job​

You can look at a job in two ways, with different levels of detail.

Expand the row. Choose the chevron on a job to expand it in place. This shows the job's timing (start time, time of completion, processing time), the account that ran it, and a Stages bar summarizing its progress.

An expanded job row showing its start time, completion time, processing time, and the Preparation and Processing stages

View details. For the full picture, choose View details to open the job in a dialog with three tabs:

  • Overview: a status banner and a card for each involved Target Entity, showing its import and processing options.
  • Stages: every stage and the steps inside it, each step with its status, start and completion times, elapsed time, and record counts. This is where you see exactly which step a job reached, or where it failed.
  • Raw: the underlying job data.

The View details dialog on its Stages tab: the Preparation and Processing stages listed on the left, and the selected stage's steps with their status and timing on the right

Cancel or restart a job​

From a job's Actions:

  • Cancel job: stop a job that is still Queued or Processing. DCH asks you to confirm.
  • Restart job: run a job again. This re-queues the same build as a new job. It is available once a job has reached Finished, Error, or Canceled.