[{"data":1,"prerenderedAt":347},["ShallowReactive",2],{"docs-\u002Fdocs\u002Foperations\u002Ftroubleshooting":3},{"id":4,"title":5,"body":6,"description":338,"extension":339,"meta":340,"navigation":341,"path":342,"redirect":343,"seo":344,"stem":345,"__hash__":346},"docs\u002Fdocs\u002Foperations\u002Ftroubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":323},"minimark",[9,13,17,22,25,46,50,52,63,67,69,87,91,93,107,111,114,129,134,150,156,173,196,200,209,214,223,227,231,236,244,249,254,257,281,289,293,319],[10,11,5],"h1",{"id":12},"troubleshooting",[14,15,16],"p",{},"Use this page as the first stop when a workflow is blocked.",[18,19,21],"h2",{"id":20},"connection-issues","Connection issues",[14,23,24],{},"Check:",[26,27,28,32,35,38],"ul",{},[29,30,31],"li",{},"host, port, credentials, and SSL\u002FTLS settings",[29,33,34],{},"database or bucket scope",[29,36,37],{},"server-side reachability from the DBConvert Streams deployment",[29,39,40,41],{},"whether the connection can be opened in ",[42,43,45],"a",{"href":44},"\u002Fdocs\u002Fdatabase-explorer\u002F","Data Explorer",[18,47,49],{"id":48},"explorer-or-sql-issues","Explorer or SQL issues",[14,51,24],{},[26,53,54,57,60],{},[29,55,56],{},"whether the expected schemas, tables, or files are visible",[29,58,59],{},"whether you are in a direct database context or a DuckDB-backed file\u002Fmulti-source context",[29,61,62],{},"whether a federated query needs alias-qualified names or explicit casts",[18,64,66],{"id":65},"stream-issues","Stream issues",[14,68,24],{},[26,70,71,74,77,84],{},[29,72,73],{},"source and target compatibility for the selected mode",[29,75,76],{},"whether the selected mode is Load or CDC",[29,78,79,80],{},"stream logs and run history in ",[42,81,83],{"href":82},"\u002Fdocs\u002Foperations\u002Fobservability","Observability",[29,85,86],{},"whether the target requires staged file delivery or additional credentials",[18,88,90],{"id":89},"file-and-object-storage-issues","File and object storage issues",[14,92,24],{},[26,94,95,98,101,104],{},[29,96,97],{},"local base path permissions",[29,99,100],{},"S3-compatible credentials and bucket access",[29,102,103],{},"path validity and manifest behavior for object storage workflows",[29,105,106],{},"whether the issue is in explorer listing, SQL, or stream execution specifically",[18,108,110],{"id":109},"snowflake-issues","Snowflake issues",[14,112,113],{},"Start with:",[26,115,116,119,122],{},[29,117,118],{},"endpoint reachability",[29,120,121],{},"credentials and schema access",[29,123,124,125],{},"target-only assumptions from ",[42,126,128],{"href":127},"\u002Fdocs\u002Fconnections\u002Fsnowflake","Snowflake Target",[130,131,133],"h3",{"id":132},"snowflake-timestamp-corruption-far-future-dates","Snowflake: timestamp corruption (far-future dates)",[14,135,136,140,141,145,146,149],{},[137,138,139],"strong",{},"Symptom",": Timestamps like ",[142,143,144],"code",{},"2005-05-25 11:30:37"," appear as far-future dates like ",[142,147,148],{},"37366-12-22"," after loading Parquet files into Snowflake.",[14,151,152,155],{},[137,153,154],{},"Cause",": Snowflake's default Parquet reader ignores Arrow logical type metadata and misinterprets millisecond timestamps as days.",[14,157,158,161,162,165,166,169,170,172],{},[137,159,160],{},"Solution",": DBConvert Streams automatically includes ",[142,163,164],{},"USE_LOGICAL_TYPE = TRUE"," in the Snowflake ",[142,167,168],{},"COPY INTO"," command. If you run ",[142,171,168],{}," manually, ensure this option is set:",[174,175,180],"pre",{"className":176,"code":177,"language":178,"meta":179,"style":179},"language-sql shiki shiki-themes github-light github-dark","COPY INTO my_table FROM @my_stage\u002Ffile.parquet\nFILE_FORMAT = (TYPE = 'PARQUET' USE_LOGICAL_TYPE = TRUE)\n","sql","",[142,181,182,190],{"__ignoreMap":179},[183,184,187],"span",{"class":185,"line":186},"line",1,[183,188,189],{},"COPY INTO my_table FROM @my_stage\u002Ffile.parquet\n",[183,191,193],{"class":185,"line":192},2,[183,194,195],{},"FILE_FORMAT = (TYPE = 'PARQUET' USE_LOGICAL_TYPE = TRUE)\n",[130,197,199],{"id":198},"snowflake-binary-data-fails-to-load-utf-8-error","Snowflake: binary data fails to load (UTF-8 error)",[14,201,202,204,205,208],{},[137,203,139],{},": ",[142,206,207],{},"Invalid UTF8 detected while decoding '0x89PNG...'"," when loading tables containing BLOB\u002Fbinary data (e.g., images).",[14,210,211,213],{},[137,212,154],{},": Snowflake applies strict UTF-8 validation to Parquet files by default. Raw binary data fails this check.",[14,215,216,218,219,222],{},[137,217,160],{},": DBConvert Streams automatically converts binary data to base64-encoded strings and maps BLOB columns to ",[142,220,221],{},"VARCHAR"," in Snowflake DDL. No manual action is needed — this is handled transparently during stream execution.",[18,224,226],{"id":225},"postgresql-tlsssl-issues","PostgreSQL TLS\u002FSSL issues",[130,228,230],{"id":229},"connection-test-passes-but-stream-fails-with-ssl-error","Connection test passes but stream fails with SSL error",[14,232,233,235],{},[137,234,139],{},": Connection test in UI passes, but stream execution fails with:",[174,237,242],{"className":238,"code":240,"language":241},[239],"language-text","tls: failed to verify certificate: x509: certificate signed by unknown authority\n","text",[142,243,240],{"__ignoreMap":179},[14,245,246,248],{},[137,247,154],{},": This can occur when custom SSL certificates are configured but cloud-specific TLS settings override them during stream execution.",[14,250,251,253],{},[137,252,160],{},": Ensure your SSL certificates (CA, client cert\u002Fkey) are configured in the connection settings. DBConvert Streams respects user-provided TLS configuration and only applies cloud-specific defaults as fallbacks when no custom TLS config is set.",[14,255,256],{},"If the issue persists:",[258,259,260,263,278],"ol",{},[29,261,262],{},"Verify the CA certificate is valid and matches the server",[29,264,265,266,269,270,273,274,277],{},"Check that the SSL mode matches your server's requirements (",[142,267,268],{},"require",", ",[142,271,272],{},"verify-ca",", or ",[142,275,276],{},"verify-full",")",[29,279,280],{},"For cloud databases (AWS RDS, Azure, DigitalOcean), confirm the endpoint hostname matches the certificate",[14,282,283,284,288],{},"See ",[42,285,287],{"href":286},"\u002Fdocs\u002Fnetwork-security\u002Fssl-configuration","SSL Configuration"," for detailed setup.",[18,290,292],{"id":291},"related-docs","Related docs",[26,294,295,301,305,309,313],{},[29,296,297],{},[42,298,300],{"href":299},"\u002Fdocs\u002Fconnections\u002Fconnection-management","Connection Management",[29,302,303],{},[42,304,287],{"href":286},[29,306,307],{},[42,308,128],{"href":127},[29,310,311],{},[42,312,83],{"href":82},[29,314,315],{},[42,316,318],{"href":317},"\u002Fdocs\u002Fapi\u002Freference","API Reference",[320,321,322],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":179,"searchDepth":192,"depth":192,"links":324},[325,326,327,328,329,334,337],{"id":20,"depth":192,"text":21},{"id":48,"depth":192,"text":49},{"id":65,"depth":192,"text":66},{"id":89,"depth":192,"text":90},{"id":109,"depth":192,"text":110,"children":330},[331,333],{"id":132,"depth":332,"text":133},3,{"id":198,"depth":332,"text":199},{"id":225,"depth":192,"text":226,"children":335},[336],{"id":229,"depth":332,"text":230},{"id":291,"depth":192,"text":292},"Troubleshooting guide for connection, query, stream, and target issues in DBConvert Streams.","md",{},false,"\u002Fdocs\u002Foperations\u002Ftroubleshooting",null,{"title":5,"description":338},"docs\u002Foperations\u002Ftroubleshooting","Fl3NJW_LwEK2eaFlyTeA9WSoOXkQfWSG-qNiEwzXJi8",1783896283414]