Background jobs

What runs in the background

Anything in Kenseme that takes more than a few seconds runs as a background job on the server. You start it, Kenseme hands it to the server, and you can keep working, open another page, or close the browser while it finishes.

[screenshot]
The Background Jobs tab in Organization Settings with a running description job, a succeeded Pipeline job, and a failed ontology import.

What runs in the background

  • Schema imports — loading a DDL or YAML file, or objects from a database connection, into a schema.
  • AI description generation — descriptions for schema objects, a whole schema, an ontology, or one class’s members.
  • Description import — applying descriptions from a file.
  • SQL object analysis — working out what a view, procedure, function, or script depends on and does.
  • Pipeline work — AI rename, generating load procedures, and finalizing a Pipeline.
  • Star schema design and build — the AI design run and the build of tables, views, and load procedures.
  • Schema duplication into another dialect — converting procedure bodies, views, and defaults.
  • Ontology work — the Ontology Generator, ontology file and standard imports, version deploys, Fabric sync, and binding suggestions for lakehouses and databases.
  • Process documents — reading, splitting, and indexing uploaded documents.
  • Data Agent question suggestions — preparing suggested questions for a bound ontology.

Kenseme also runs a few maintenance jobs on a schedule, such as refreshing usage figures and cleaning up expired data. You may see them in the job list.

For the names you’ll see in the job list, see Background job kinds.

What jobs have in common

  • They run on the server. Closing the browser or signing out doesn’t stop them.
  • They report progress. Most show a percentage and a message about what they’re doing now.
  • They end in a clear state. Succeeded (or completed), failed, or, for jobs you can stop, cancelled.
  • They’re scoped to your organization. You only see your own organization’s jobs.

Where to watch them

  • Organization Settings › Background Jobs lists your organization’s jobs from roughly the last day. Organization admins only.
  • Organization Settings › Schema Imports tracks schema imports, with cancel and resume.
  • Home shows an In progress card while something is running.
  • The screen where you started the job. The Ontology Generator, the Star Schema tab, and Pipeline dialogs show live progress of their own.

See Where to watch background jobs.

Tip: Closed the browser mid-import? When you come back, check Schema Imports or Home. The job has almost certainly finished or is still running.