{"record":{"id":"7194f92f81c64e89","repo":"mastra-ai/mastra","slug":"database-not-found-dbarg-list-databases-with","errorCode":null,"errorMessage":"Database not found: ${dbArg}. List databases with: mastra env db list","messagePattern":"Database not found: (.+?)\\. List databases with: mastra env db list","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/cli/src/commands/db/db.ts","lineNumber":201,"sourceCode":"\nfunction envVarNamesFor(kind: DatabaseKind): string {\n  const names = DB_ENV_VAR_NAMES[kind] ?? [];\n  return names.length > 0 ? names.join(', ') : '—';\n}\n\nfunction withScope(db: ProjectDatabase, environments: Environment[]) {\n  return {\n    ...db,\n    scope: formatScope(db, environments),\n    envVarNames: DB_ENV_VAR_NAMES[db.kind] ?? [],\n  };\n}\n\nasync function findDatabase(token: string, orgId: string, project: Project, dbArg: string): Promise<ProjectDatabase> {\n  const databases = await fetchDatabases(token, orgId, project.id);\n  const db = databases.find(d => d.id === dbArg || d.name === dbArg);\n  if (!db) {\n    throw new Error(`Database not found: ${dbArg}. List databases with: mastra env db list`);\n  }\n  return db;\n}\n\n/* ------------------------------------------------------------------ */\n/*  mastra env db list                                                 */\n/* ------------------------------------------------------------------ */\n\nasync function findEnvironment(token: string, orgId: string, project: Project, envArg: string): Promise<Environment> {\n  const environments = await fetchEnvironments(token, orgId, project.id);\n  const env = environments.find(e => e.id === envArg || e.name === envArg || e.slug === envArg);\n  if (!env) {\n    throw new Error(`Environment not found: ${envArg}. List environments with: mastra env list`);\n  }\n  return env;\n}\n\nasync function listDatabasesAction(envArg: string | undefined, options: { project?: string; json?: boolean }) {","sourceCodeStart":183,"sourceCodeEnd":219,"githubUrl":"https://github.com/mastra-ai/mastra/blob/75dd419e613fe9c39f846ffc500716141b74fda6/packages/cli/src/commands/db/db.ts#L183-L219","documentation":"findDatabase() fetches all databases for the resolved project and matches the dbArg by id or name; if nothing matches it throws with a hint to run `mastra env db list`. This guards all db subcommands (show/delete/etc.) against referencing a database that does not exist in that project.","triggerScenarios":"`mastra env db <cmd> <dbArg>` where dbArg is neither an existing database id nor name within the current org/project — wrong project scope, deleted database, or typo.","commonSituations":"Passing a database from another project (project not selected with --project), using a stale name after a rename, or confusing environments' scoped vs shared databases.","solutions":["Run `mastra env db list` and copy the exact id or name of the target database.","Confirm the correct project with `--project <name>` if the database lives in a different project.","Re-check spelling/case of the database name; names are matched exactly.","If the database was deleted, recreate it with `mastra env db create`."],"exampleFix":"// before\nmastra env db delete my-db\n// after\nmastra env db list\nmastra env db delete prod-main-db","handlingStrategy":"validation","validationCode":"const dbs = await listDatabases(); // or parse `mastra env db list --json`\nif (!dbs.some(d => d.id === dbArg || d.name === dbArg)) {\n  throw new Error(`Unknown database \"${dbArg}\" — pick one of: ${dbs.map(d => d.name).join(', ')}`);\n}","typeGuard":null,"tryCatchPattern":"try {\n  await runDbCommand(dbArg);\n} catch (e) {\n  if (/Database not found/.test((e as Error).message)) {\n    console.error('Run `mastra env db list` and use an exact id/name; check --project scope.');\n  }\n}","preventionTips":["Always resolve names via `mastra env db list` (or --json) instead of hardcoding.","Pass --project explicitly when the database isn't in the default project.","Prefer stable database ids over mutable names in scripts."],"tags":["cli","database","not-found","cloud"],"backgroundTag":"resource-not-found","analyzedSha":"75dd419e613fe9c39f846ffc500716141b74fda6","analyzedAt":"2026-08-30T00:15:31.844Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}