{"record":{"id":"03d0f607235f01e6","repo":"vitessio/vitess","slug":"no-vdiff-found-for-uuid-s-keyspace-s-and-workflo","errorCode":null,"errorMessage":"no vdiff found for UUID %s keyspace %s and workflow %s on tablet %s","messagePattern":"no vdiff found for UUID (.+?) keyspace (.+?) and workflow (.+?) on tablet (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"go/vt/vttablet/tabletmanager/vdiff/action.go","lineNumber":341,"sourceCode":"\t\t}\n\t}\n\tif vdiffUUID != \"\" {\n\t\tresp.VdiffUuid = vdiffUUID\n\t\tquery, err := sqlparser.ParseAndBind(sqlGetVDiffByKeyspaceWorkflowUUID,\n\t\t\tsqltypes.StringBindVariable(req.Keyspace),\n\t\t\tsqltypes.StringBindVariable(req.Workflow),\n\t\t\tsqltypes.StringBindVariable(vdiffUUID),\n\t\t\tsqltypes.StringBindVariable(vde.dbName),\n\t\t)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tif qr, err = dbClient.ExecuteFetch(query, 1); err != nil {\n\t\t\treturn err\n\t\t}\n\t\tswitch len(qr.Rows) {\n\t\tcase 0:\n\t\t\treturn fmt.Errorf(\"no vdiff found for UUID %s keyspace %s and workflow %s on tablet %s\",\n\t\t\t\tvdiffUUID, req.Keyspace, req.Workflow, topoproto.TabletAliasString(vde.thisTablet.Alias))\n\t\tcase 1:\n\t\t\trow := qr.Named().Row()\n\t\t\tvdiffID, _ := row[\"id\"].ToInt64()\n\t\t\tsummary, err := vde.getVDiffSummary(vdiffID, dbClient, req.GetOptions().GetReportOptions())\n\t\t\tresp.Output = summary\n\t\t\tif err != nil {\n\t\t\t\treturn err\n\t\t\t}\n\t\tdefault:\n\t\t\treturn fmt.Errorf(\"too many vdiffs found (%d) for UUID %s keyspace %s and workflow %s on tablet %s\",\n\t\t\t\tlen(qr.Rows), vdiffUUID, req.Keyspace, req.Workflow, topoproto.TabletAliasString(vde.thisTablet.Alias))\n\t\t}\n\t}\n\tswitch req.ActionArg {\n\tcase AllActionArg:\n\t\tquery, err := sqlparser.ParseAndBind(sqlGetMostRecentVDiffByKeyspaceWorkflow,\n\t\t\tsqltypes.StringBindVariable(req.Keyspace),","sourceCodeStart":323,"sourceCodeEnd":359,"githubUrl":"https://github.com/vitessio/vitess/blob/01a25a7d176f94613b8d59d799f438380a8760e4/go/vt/vttablet/tabletmanager/vdiff/action.go#L323-L359","documentation":"handleShowAction queries _vt.vdiff_tablet for the given UUID/keyspace/workflow; when zero rows are returned it errors that no vdiff matching those identifiers exists on this tablet. VDiff show is per-tablet, so this can occur even when the vdiff exists elsewhere in the workflow.","triggerScenarios":"vdiff show (or lastly show with a specific UUID) where the UUID+keyspace+workflow combination has no row on the queried tablet; omitting --tablet-uuid and hitting a tablet without the record.","commonSituations":"Querying show before any create; showing on the wrong tablet or before the vdiff propagated; typo in UUID; workflow renamed so the stored workflow no longer matches; tablet's _vt rows cleaned up after completion.","solutions":["List what exists: vtctldclient VDiff show (without UUID) for the workflow","Verify the UUID spelling and that the workflow/keyspace match the original create","Target the correct tablet via --tablet-uuid where the vdiff was created","Create the vdiff if it never existed on this workflow/tablet"],"exampleFix":"// before\nvtctldclient VDiff show --keyspace c --workflow w --uuid wrong-id\n// after: list available vdiffs first\nvtctldclient VDiff show --keyspace c --workflow w\nvtctldclient VDiff show --keyspace c --workflow w --uuid <listed-uuid>","handlingStrategy":"validation","validationCode":"qr, _ := dbClient.ExecuteFetch(\"SELECT id FROM _vt.vdiff_tablet WHERE uuid=? AND keyspace=? AND workflow=?\", 1, true)\nif len(qr.Rows) == 0 { return errors.New(\"no matching vdiff; run create first\") }","typeGuard":null,"tryCatchPattern":"if strings.Contains(err.Error(), \"no vdiff found for UUID\") {\n    // fall back to listing all vdiffs for the workflow\n}","preventionTips":["Run bare vdiff show to enumerate existing UUIDs before targeting one","Store the UUID returned by create for later show/resume/delete calls","Target the tablet that created the vdiff via --tablet-uuid","Confirm keyspace/workflow names match the original create"],"tags":["vdiff","missing-record","lookup"],"backgroundTag":"record-not-found","analyzedSha":"01a25a7d176f94613b8d59d799f438380a8760e4","analyzedAt":"2026-09-01T17:28:30.605Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}