[{"data":1,"prerenderedAt":319},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fconnections\u002Fneon-database":3},{"id":4,"title":5,"body":6,"description":310,"extension":311,"meta":312,"navigation":313,"path":314,"redirect":315,"seo":316,"stem":317,"__hash__":318},"docs\u002Fdocs\u002Fconnections\u002Fneon-database.md","Neon PostgreSQL Guide",{"type":7,"value":8,"toc":303},"minimark",[9,13,17,20,33,36,51,56,72,79,85,91,101,104,114,123,127,130,133,144,148,151,154,157,165,171,181,184,233,239,243,285,289,299],[10,11,5],"h1",{"id":12},"neon-postgresql-guide",[14,15,16],"p",{},"Use this page when your PostgreSQL source or target is hosted in Neon.",[14,18,19],{},"This guide keeps the Neon-specific parts of the setup in one place:",[21,22,23,27,30],"ul",{},[24,25,26],"li",{},"project and branch connection details",[24,28,29],{},"required SSL behavior",[24,31,32],{},"Neon logical replication enablement for CDC source workflows",[14,34,35],{},"For the core workflow split, use:",[21,37,38,45],{},[24,39,40],{},[41,42,44],"a",{"href":43},"\u002Fdocs\u002Fconnections\u002Fpostgresql-server","PostgreSQL Server Configuration",[24,46,47],{},[41,48,50],{"href":49},"\u002Fdocs\u002Fintegration\u002Fpostgres-cdc-source-configuration","PostgreSQL CDC Source Configuration",[52,53,55],"h2",{"id":54},"base-setup","Base setup",[57,58,59,69],"ol",{},[24,60,61,62,68],{},"Open the ",[41,63,67],{"href":64,"rel":65},"https:\u002F\u002Fconsole.neon.tech",[66],"nofollow","Neon Console",".",[24,70,71],{},"Select the project and branch that DBConvert Streams should use.",[14,73,74],{},[75,76],"img",{"alt":77,"src":78},"Neon Create Project","\u002Fimages\u002Fdocs\u002Fconnections\u002Fneon\u002Fcreate-project.png",[57,80,82],{"start":81},3,[24,83,84],{},"Copy the PostgreSQL connection details.",[14,86,87],{},[75,88],{"alt":89,"src":90},"Neon Connection Details","\u002Fimages\u002Fdocs\u002Fconnections\u002Fneon\u002Fconnection-details.png",[57,92,94],{"start":93},4,[24,95,96,97,68],{},"Confirm the DBConvert Streams deployment can reach the Neon endpoint on port ",[98,99,100],"code",{},"5432",[14,102,103],{},"Typical connection pattern:",[105,106,112],"pre",{"className":107,"code":109,"language":110,"meta":111},[108],"language-text","postgres:\u002F\u002Fuser:password@endpoint.region.aws.neon.tech\u002Fdbname?sslmode=require\n","text","",[98,113,109],{"__ignoreMap":111},[14,115,116,117,119,120,68],{},"In DBConvert Streams, use the endpoint host, port ",[98,118,100],{},", username, password, database, and set SSL mode to ",[98,121,122],{},"require",[52,124,126],{"id":125},"ssl-requirements","SSL requirements",[14,128,129],{},"Neon connections are SSL-oriented by default. Treat TLS as required unless your Neon setup explicitly documents something different.",[14,131,132],{},"In practice:",[21,134,135,138,141],{},[24,136,137],{},"enable SSL\u002FTLS in the DBConvert Streams connection",[24,139,140],{},"use a verification mode that matches your certificate policy",[24,142,143],{},"test the connection before creating a stream",[52,145,147],{"id":146},"cdc-source-preparation","CDC source preparation",[14,149,150],{},"If Neon is only a Load source or a target, the base PostgreSQL connection setup is enough.",[14,152,153],{},"If Neon is the CDC source, you must also enable logical replication in Neon first.",[14,155,156],{},"Typical flow:",[57,158,159,162],{},[24,160,161],{},"Open the Neon project settings.",[24,163,164],{},"Enable logical replication for the project or branch.",[14,166,167],{},[75,168],{"alt":169,"src":170},"Enable Logical Replication in Neon","\u002Fimages\u002Fdocs\u002Fconnections\u002Fneon\u002Fenable-logical-replication.png",[57,172,173,176],{"start":81},[24,174,175],{},"Confirm the chosen user has the privileges required by the PostgreSQL CDC workflow.",[24,177,178,179,68],{},"Then complete the remaining steps in ",[41,180,50],{"href":49},[14,182,183],{},"After enabling logical replication, verify:",[105,185,189],{"className":186,"code":187,"language":188,"meta":111,"style":111},"language-sql shiki shiki-themes github-light github-dark","SELECT name, setting\nFROM pg_settings\nWHERE name IN (\n  'wal_level',\n  'max_replication_slots',\n  'max_wal_senders'\n);\n","sql",[98,190,191,199,205,210,215,221,227],{"__ignoreMap":111},[192,193,196],"span",{"class":194,"line":195},"line",1,[192,197,198],{},"SELECT name, setting\n",[192,200,202],{"class":194,"line":201},2,[192,203,204],{},"FROM pg_settings\n",[192,206,207],{"class":194,"line":81},[192,208,209],{},"WHERE name IN (\n",[192,211,212],{"class":194,"line":93},[192,213,214],{},"  'wal_level',\n",[192,216,218],{"class":194,"line":217},5,[192,219,220],{},"  'max_replication_slots',\n",[192,222,224],{"class":194,"line":223},6,[192,225,226],{},"  'max_wal_senders'\n",[192,228,230],{"class":194,"line":229},7,[192,231,232],{},");\n",[14,234,235],{},[75,236],{"alt":237,"src":238},"Check Replication Settings","\u002Fimages\u002Fdocs\u002Fconnections\u002Fneon\u002Fcheck-replication-settings.png",[52,240,242],{"id":241},"validation-checklist","Validation checklist",[57,244,245,261,267,282],{},[24,246,247,248,252,253,257,258,260],{},"Test the Neon connection from the ",[41,249,251],{"href":250},"\u002Fdocs\u002Fdatabase-explorer\u002F","Data Explorer"," sidebar (right-click → ",[254,255,256],"strong",{},"Test connection",") or from the connection editor. If TLS fails, confirm SSL mode is set to ",[98,259,122],{}," — Neon does not allow unencrypted connections.",[24,262,263,264,266],{},"Open it in ",[41,265,251],{"href":250}," to confirm visible schemas and tables.",[24,268,269,270,273,274,277,278,281],{},"If the workflow uses CDC, run ",[98,271,272],{},"SHOW wal_level"," and confirm it returns ",[98,275,276],{},"logical",". If it shows ",[98,279,280],{},"replica",", logical replication is not enabled in the Neon project settings.",[24,283,284],{},"After Neon branch resets, compute restarts, or project-level changes, re-test the connection — Neon can reset replication state on these events.",[52,286,288],{"id":287},"related-docs","Related docs",[21,290,291,295],{},[24,292,293],{},[41,294,44],{"href":43},[24,296,297],{},[41,298,50],{"href":49},[300,301,302],"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":111,"searchDepth":201,"depth":201,"links":304},[305,306,307,308,309],{"id":54,"depth":201,"text":55},{"id":125,"depth":201,"text":126},{"id":146,"depth":201,"text":147},{"id":241,"depth":201,"text":242},{"id":287,"depth":201,"text":288},"Configure Neon-hosted PostgreSQL for DBConvert Streams connection workflows and PostgreSQL CDC preparation.","md",{},false,"\u002Fdocs\u002Fconnections\u002Fneon-database",null,{"title":5,"description":310},"docs\u002Fconnections\u002Fneon-database","56gpzWFtPPnhEPk_QF8od7dbwXn1bCoY9ZB9HiqIXos",1782346474584]