ZINGG_ID

The Only Identifier You Always Needed But Never Had

Cross reference every entity across the enterprise with an ID that never changes, through new data, retraining and migrations.

Arriving In This Run3 records
crm.contactsTim Chen[email protected]
pos.loyaltyT. Chen1513 Menlo Dr, CA
crm.contactsMaria GarciaAustin, TX
Zingg
zingg.golden_recordsPersistent
ZINGG_ID · 8f3c-21abNew ID
Tim Chen
crm.contacts
ZINGG_ID · 5a7d-90e1New ID
T. Chen
pos.loyalty
ZINGG_ID · 2c19-8e40New ID
Maria Garcia
crm.contacts

First run: every resolved entity gets its own ZINGG_ID. Nothing links Tim Chen to T. Chen yet.

How It Works

Zingg Maintains The Identity Graph For You

Incremental runs resolve only new and updated records, and assign, merge and split clusters automatically, so the ID you stored yesterday still points to the same customer, supplier or product today. Incremental flow

New Records Join Existing IDs

When a new record matches an entity Zingg already knows, it joins that ZINGG_ID, with a cross reference back to its source record.

New Entities Get New IDs

A record with no existing match starts a new entity with a new ZINGG_ID. Nothing else in the graph changes.

Clusters Merge

When a new record matches two clusters, they merge into one entity with a single surviving ZINGG_ID.

Clusters Split

When an updated record no longer matches its cluster, Zingg moves it out, to a better-matching cluster or a ZINGG_ID of its own.

Reassign ZINGG_ID

The Same IDs Through Every Migration

Upgrade the model, change the schema or move platforms. Every downstream system still references the same ZINGG_ID it always did.

How it works

Mapped Back By Cluster Membership

Zingg maps the clusters from your new run back to your original cluster assignments by cluster similarity, and keeps the original ZINGG_ID wherever a match exists. A new ID is generated only when no match is found.

  • Model upgrades
  • Infrastructure migration
  • Schema evolution
  • Data migration
  • Platform upgrades
Reassign ZINGG_ID
--phase reassignZinggIdNew run, same IDs
record_pknew clusterZINGG_ID
S3301tmp-902azg-14f0 original
S3302tmp-902azg-14f0 original
S3305tmp-955czg-88b7 new
Original IDs kept wherever clusters overlapID stable
FAQ

ZINGG_ID Questions

What is a ZINGG_ID?

A globally unique, persistent identifier for each resolved entity. It stays stable as new and updated records arrive, so downstream systems can rely on it.

Does the ZINGG_ID change when new data arrives?

No. New records that match an existing entity join its ZINGG_ID. Only a new entity with no match gets a new one.

What happens to the ZINGG_ID when clusters merge or split?

Incremental runs assign, merge and split clusters automatically. A new record that matches two clusters merges them into one entity with a single surviving ZINGG_ID. An updated record that no longer fits its cluster moves to a better-matching cluster or gets a ZINGG_ID of its own.

What happens to the IDs when I retrain or change the model?

Run Reassign ZINGG_ID. Zingg maps the clusters from the new model back to your original assignments by cluster similarity and keeps the original ID wherever a match exists. A new ID is generated only when no match is found.

Can I see why records share a ZINGG_ID?

Yes. With Explainability you query a cluster by its ZINGG_ID and see which record pairs were compared, their similarity scores and how transitive matches chained records together.

Which edition has persistent ZINGG_IDs?

Zingg Enterprise. It adds incremental runs with persistent ZINGG_IDs, so new and updated records resolve without reprocessing everything.

One ID For Every Entity

Persistent ZINGG_IDs and incremental runs come with Zingg Enterprise, on your own data platform.