{"record":{"id":"0f2da8a05036c5ea","repo":"pentaho/pentaho-kettle","slug":"unexpected-error-reading-step-information-from-the-0f2da8","errorCode":null,"errorMessage":"Unexpected error reading step information from the repository","messagePattern":"Unexpected error reading step information from the repository","errorType":"exception","errorClass":"KettleException","httpStatus":null,"severity":"error","filePath":"engine/src/main/java/org/pentaho/di/trans/steps/getfilenames/GetFileNamesMeta.java","lineNumber":632,"sourceCode":"      rowLimit = rep.getStepAttributeInteger( id_step, \"limit\" );\n\n      allocate( nrfiles );\n\n      for ( int i = 0; i < nrfiles; i++ ) {\n        fileName[i] = rep.getStepAttributeString( id_step, i, \"file_name\" );\n        fileMask[i] = rep.getStepAttributeString( id_step, i, \"file_mask\" );\n        excludeFileMask[i] = rep.getStepAttributeString( id_step, i, \"exclude_file_mask\" );\n        fileRequired[i] = rep.getStepAttributeString( id_step, i, \"file_required\" );\n        if ( !YES.equalsIgnoreCase( fileRequired[i] ) ) {\n          fileRequired[i] = NO;\n        }\n        includeSubFolders[i] = rep.getStepAttributeString( id_step, i, \"include_subfolders\" );\n        if ( !YES.equalsIgnoreCase( includeSubFolders[i] ) ) {\n          includeSubFolders[i] = NO;\n        }\n      }\n    } catch ( Exception e ) {\n      throw new KettleException( \"Unexpected error reading step information from the repository\", e );\n    }\n  }\n\n  @Override\n  public void saveRep( Repository rep, IMetaStore metaStore, ObjectId id_transformation, ObjectId id_step ) throws KettleException {\n    try {\n      rep.saveStepAttribute( id_transformation, id_step, \"filterfiletype\", fileTypeFilter.toString() );\n      rep.saveStepAttribute( id_transformation, id_step, \"doNotFailIfNoFile\", doNotFailIfNoFile );\n      rep.saveStepAttribute( id_transformation, id_step, \"rownum\", includeRowNumber );\n      rep.saveStepAttribute( id_transformation, id_step, \"isaddresult\", isaddresult );\n      rep.saveStepAttribute( id_transformation, id_step, \"filefield\", filefield );\n      rep.saveStepAttribute( id_transformation, id_step, \"filename_Field\", dynamicFilenameField );\n      rep.saveStepAttribute( id_transformation, id_step, \"wildcard_Field\", dynamicWildcardField );\n      rep.saveStepAttribute( id_transformation, id_step, \"exclude_wildcard_Field\", dynamicExcludeWildcardField );\n      rep.saveStepAttribute( id_transformation, id_step, \"dynamic_include_subfolders\", dynamicIncludeSubFolders );\n\n      rep.saveStepAttribute( id_transformation, id_step, \"rownum_field\", rowNumberField );\n      rep.saveStepAttribute( id_transformation, id_step, \"limit\", rowLimit );","sourceCodeStart":614,"sourceCodeEnd":650,"githubUrl":"https://github.com/pentaho/pentaho-kettle/blob/f3058517a153da500bf4551f46d79b91bf8ec552/engine/src/main/java/org/pentaho/di/trans/steps/getfilenames/GetFileNamesMeta.java#L614-L650","documentation":"readRep wraps any exception while loading the step's settings from the repository into a KettleException 'Unexpected error reading step information from the repository'. It signals a repository read failure or unexpected attribute values for this step.","triggerScenarios":"Exception from rep.getStepAttributeString/getStepAttributeInteger calls in readRep — repository connection issues, missing step row, or type/number parse failures on stored attributes.","commonSituations":"Repository database unavailable or schema mismatch after Pentaho upgrade; step metadata rows missing/corrupted in r_step_attribute; concurrent modification.","solutions":["Check the wrapped cause for the repository error.","Verify repository connectivity and that the transformation/step rows exist.","Re-save the step metadata in Spoon to rewrite attributes.","If an upgrade broke the schema, run repository upgrade scripts."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"try {\n  readRep(rep, metaStore, id_step, databases);\n} catch (KettleException e) {\n  logError(\"Repository read failed: \" + e.getCause(), e);\n  throw e;\n}","preventionTips":["Keep repository schema upgraded to match the Pentaho version","Monitor repository DB availability before job runs","Re-save step metadata after upgrades"],"tags":["pentaho","kettle","repository","metadata"],"backgroundTag":"database-query-failed","analyzedSha":"f3058517a153da500bf4551f46d79b91bf8ec552","analyzedAt":"2026-09-13T14:04:16.340Z","contentChangedAt":"2026-09-13T14:04:16.340Z","schemaVersion":2},"datasetVersion":"2026-09-20T23:17:15.980Z"}