[{"data":1,"prerenderedAt":337},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fstreams\u002Fstream-states-lifecycle":3},{"id":4,"title":5,"body":6,"description":328,"extension":329,"meta":330,"navigation":331,"path":332,"redirect":333,"seo":334,"stem":335,"__hash__":336},"docs\u002Fdocs\u002Fstreams\u002Fstream-states-lifecycle.md","Stream States and Lifecycle",{"type":7,"value":8,"toc":315},"minimark",[9,13,17,26,31,186,190,193,203,206,212,215,221,225,243,247,251,254,272,276,279,283,286,290],[10,11,5],"h1",{"id":12},"stream-states-and-lifecycle",[14,15,16],"p",{},"Every stream moves through a small set of runtime states. These states help you understand whether a stream is ready to run, actively transferring data, paused, or finished with a terminal outcome.",[14,18,19,20,25],{},"Use ",[21,22,24],"a",{"href":23},"\u002Fdocs\u002Foperations\u002Fobservability","Observability"," alongside this page when you need logs, runtime progress, and operational troubleshooting.",[27,28,30],"h2",{"id":29},"stream-states","Stream states",[32,33,34,53],"table",{},[35,36,37],"thead",{},[38,39,40,44,47,50],"tr",{},[41,42,43],"th",{},"State",[41,45,46],{},"Terminal",[41,48,49],{},"Success",[41,51,52],{},"Description",[54,55,56,74,88,106,121,139,155,172],"tbody",{},[38,57,58,65,68,71],{},[59,60,61],"td",{},[62,63,64],"code",{},"READY",[59,66,67],{},"No",[59,69,70],{},"—",[59,72,73],{},"Stream exists but has not started yet",[38,75,76,81,83,85],{},[59,77,78],{},[62,79,80],{},"RUNNING",[59,82,67],{},[59,84,70],{},[59,86,87],{},"Actively reading from source and writing to target",[38,89,90,95,97,99],{},[59,91,92],{},[62,93,94],{},"PAUSED",[59,96,67],{},[59,98,70],{},[59,100,101,102,105],{},"Temporarily suspended; can be resumed via API (",[62,103,104],{},"POST \u002Fstreams\u002F{id}\u002Fresume",")",[38,107,108,113,116,118],{},[59,109,110],{},[62,111,112],{},"FINISHED",[59,114,115],{},"Yes",[59,117,115],{},[59,119,120],{},"Completed successfully — normal terminal state for Load workflows",[38,122,123,128,130,132],{},[59,124,125],{},[62,126,127],{},"TIME_LIMIT_REACHED",[59,129,115],{},[59,131,115],{},[59,133,134,135,138],{},"Stopped after reaching the configured ",[62,136,137],{},"elapsedTime"," limit",[38,140,141,146,148,150],{},[59,142,143],{},[62,144,145],{},"EVENT_LIMIT_REACHED",[59,147,115],{},[59,149,115],{},[59,151,134,152,138],{},[62,153,154],{},"numberOfEvents",[38,156,157,162,164,166],{},[59,158,159],{},[62,160,161],{},"STOPPED",[59,163,115],{},[59,165,67],{},[59,167,168,169,105],{},"Stopped intentionally by the user via API (",[62,170,171],{},"POST \u002Fstreams\u002F{id}\u002Fstop",[38,173,174,179,181,183],{},[59,175,176],{},[62,177,178],{},"FAILED",[59,180,115],{},[59,182,67],{},[59,184,185],{},"Ended because of an error (connectivity, permissions, invalid SQL, write failures)",[27,187,189],{"id":188},"common-state-transitions","Common state transitions",[14,191,192],{},"Typical Load flow:",[194,195,201],"pre",{"className":196,"code":198,"language":199,"meta":200},[197],"language-text","READY -> RUNNING -> FINISHED\n","text","",[62,202,198],{"__ignoreMap":200},[14,204,205],{},"Typical bounded run:",[194,207,210],{"className":208,"code":209,"language":199,"meta":200},[197],"READY -> RUNNING -> TIME_LIMIT_REACHED\nREADY -> RUNNING -> EVENT_LIMIT_REACHED\n",[62,211,209],{"__ignoreMap":200},[14,213,214],{},"Typical interrupted run:",[194,216,219],{"className":217,"code":218,"language":199,"meta":200},[197],"READY -> RUNNING -> PAUSED\nREADY -> RUNNING -> STOPPED\nREADY -> RUNNING -> FAILED\n",[62,220,218],{"__ignoreMap":200},[27,222,224],{"id":223},"terminal-vs-success","Terminal vs success",[14,226,227,228,230,231,233,234,236,237,239,240,242],{},"All states from ",[62,229,178],{}," onward are terminal — the stream will not continue without a new start. But only ",[62,232,112],{},", ",[62,235,127],{},", and ",[62,238,145],{}," count as successful completions. ",[62,241,161],{}," is terminal but not success — it means the run was interrupted before natural completion.",[27,244,246],{"id":245},"troubleshooting-by-state","Troubleshooting by state",[248,249,178],"h3",{"id":250},"failed",[14,252,253],{},"Check:",[255,256,257,261,264,267],"ol",{},[258,259,260],"li",{},"source and target connectivity",[258,262,263],{},"permissions and replication prerequisites",[258,265,266],{},"query validity if custom SQL is involved",[258,268,269,270],{},"runtime logs in ",[21,271,24],{"href":23},[248,273,275],{"id":274},"paused-or-stopped","PAUSED or STOPPED",[14,277,278],{},"Check whether the state was user-initiated or caused by a deployment-specific control or limit.",[248,280,282],{"id":281},"time_limit_reached-or-event_limit_reached","TIME_LIMIT_REACHED or EVENT_LIMIT_REACHED",[14,284,285],{},"Confirm whether the limit was intentional. If not, adjust the stream configuration before the next run.",[27,287,289],{"id":288},"related-docs","Related docs",[291,292,293,299,305,309],"ul",{},[258,294,295],{},[21,296,298],{"href":297},"\u002Fdocs\u002Fstreams\u002Funderstanding-streams","Understanding Streams",[258,300,301],{},[21,302,304],{"href":303},"\u002Fdocs\u002Fstreams\u002Fstream-configuration-guide","Stream Configuration Guide",[258,306,307],{},[21,308,24],{"href":23},[258,310,311],{},[21,312,314],{"href":313},"\u002Fdocs\u002Foperations\u002Ftroubleshooting","Troubleshooting",{"title":200,"searchDepth":316,"depth":316,"links":317},2,[318,319,320,321,327],{"id":29,"depth":316,"text":30},{"id":188,"depth":316,"text":189},{"id":223,"depth":316,"text":224},{"id":245,"depth":316,"text":246,"children":322},[323,325,326],{"id":250,"depth":324,"text":178},3,{"id":274,"depth":324,"text":275},{"id":281,"depth":324,"text":282},{"id":288,"depth":316,"text":289},"Learn how DBConvert Streams moves between ready, running, paused, finished, failed, and limit-reached states.","md",{},false,"\u002Fdocs\u002Fstreams\u002Fstream-states-lifecycle",null,{"title":5,"description":328},"docs\u002Fstreams\u002Fstream-states-lifecycle","-jcsOX1jZTTxowE3Xr2o-Gupzu4C3no1ReEyAmsqC2U",1783896284922]