[{"data":1,"prerenderedAt":396},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fconnections\u002Fconnection-management":3},{"id":4,"title":5,"body":6,"description":387,"extension":388,"meta":389,"navigation":390,"path":391,"redirect":392,"seo":393,"stem":394,"__hash__":395},"docs\u002Fdocs\u002Fconnections\u002Fconnection-management.md","Connection Management Guide",{"type":7,"value":8,"toc":367},"minimark",[9,13,17,20,47,52,55,69,84,88,94,97,122,126,132,137,140,143,160,164,167,215,230,238,242,249,256,260,265,268,275,279,282,285,288,291,302,305,308,312,329,333],[10,11,5],"h1",{"id":12},"connection-management-guide",[14,15,16],"p",{},"Connections are managed directly in the Data Explorer sidebar. The sidebar lists all configured connections — databases, local files, and S3-compatible storage — with their tree of schemas, tables, and objects.",[14,18,19],{},"From the sidebar you can:",[21,22,23,32,35,38,41,44],"ul",{},[24,25,26,27,31],"li",{},"create connections (click ",[28,29,30],"strong",{},"+ New Connection",")",[24,33,34],{},"edit credentials and transport settings",[24,36,37],{},"test access",[24,39,40],{},"clone reusable configurations",[24,42,43],{},"browse schemas, tables, and files inline",[24,45,46],{},"prepare source and target pairs for streams",[48,49,51],"h2",{"id":50},"connection-entries","Connection entries",[14,53,54],{},"Each connection in the sidebar shows:",[21,56,57,60,63,66],{},[24,58,59],{},"connection name and type icon",[24,61,62],{},"database connections: host and port",[24,64,65],{},"file connections: base path",[24,67,68],{},"S3 connections: bucket or endpoint",[14,70,71,72,75,76,79,80,83],{},"Hover over a connection to reveal quick actions: ",[28,73,74],{},"Edit"," (pencil), ",[28,77,78],{},"Clone"," (copy), and ",[28,81,82],{},"Delete"," (trash).",[48,85,87],{"id":86},"adding-a-new-connection","Adding a new connection",[89,90],"themed-image",{"alt":91,"dark":92,"light":93},"Add Connection","\u002Fimages\u002Fpages\u002Fget-started\u002Fdesktop-connection-form-dark.png","\u002Fimages\u002Fpages\u002Fget-started\u002Fdesktop-connection-form-light.png",[14,95,96],{},"Typical flow:",[98,99,100,107,110,113,116,119],"ol",{},[24,101,102,103,106],{},"Click ",[28,104,105],{},"New connection",".",[24,108,109],{},"Select the connection type.",[24,111,112],{},"Fill in the required parameters.",[24,114,115],{},"Configure SSL\u002FTLS if needed.",[24,117,118],{},"Test the connection.",[24,120,121],{},"Save it once validation succeeds.",[48,123,125],{"id":124},"connection-types","Connection types",[14,127,128,129,131],{},"When you click ",[28,130,105],{},", you select one of three connection families. Each has its own settings panel.",[133,134,136],"h3",{"id":135},"database-connections","Database connections",[14,138,139],{},"Database connections currently use MySQL or PostgreSQL settings. Snowflake target support is documented separately and is not yet publicly available.",[14,141,142],{},"These database connections use:",[21,144,145,148,151,154,157],{},[24,146,147],{},"name",[24,149,150],{},"host and port",[24,152,153],{},"username and password",[24,155,156],{},"database or initial scope",[24,158,159],{},"optional connection-string import",[133,161,163],{"id":162},"local-file-connections","Local file connections",[14,165,166],{},"Local file connections point to a directory on the machine running DBConvert Streams.",[168,169,170,186],"table",{},[171,172,173],"thead",{},[174,175,176,180,183],"tr",{},[177,178,179],"th",{},"Setting",[177,181,182],{},"Required",[177,184,185],{},"Description",[187,188,189,201],"tbody",{},[174,190,191,195,198],{},[192,193,194],"td",{},"Name",[192,196,197],{},"Yes",[192,199,200],{},"Connection label",[174,202,203,206,208],{},[192,204,205],{},"Base path",[192,207,197],{},[192,209,210,211,31],{},"Root directory for file browsing (e.g. ",[212,213,214],"code",{},"\u002Fdata\u002Fexports",[14,216,217,218,221,222,225,226,229],{},"Once saved, the connection tree in Data Explorer shows folders and files under the base path. Supported formats: ",[28,219,220],{},"CSV",", ",[28,223,224],{},"JSON\u002FJSONL",", and ",[28,227,228],{},"Parquet",". Files can be previewed, queried with SQL, and used as sources or targets in Load streams.",[14,231,232,233,106],{},"For format details and SQL workflows, see ",[234,235,237],"a",{"href":236},"\u002Fdocs\u002Fconnections\u002Flocal-files","Local Files",[133,239,241],{"id":240},"s3-compatible-storage-connections","S3-compatible storage connections",[14,243,244,245,248],{},"S3 connections let you browse buckets, query objects with SQL, and use S3 as a stream source or target. Built-in presets are available for AWS S3, Google Cloud Storage, Cloudflare R2, DigitalOcean Spaces, Backblaze B2, and MinIO. Use the ",[28,246,247],{},"Custom"," preset for other S3-compatible providers.",[14,250,251,252,106],{},"For connection settings, provider presets, and provider-specific setup, see ",[234,253,255],{"href":254},"\u002Fdocs\u002Fconnections\u002Fs3-compatible-storage","S3-Compatible Storage",[48,257,259],{"id":258},"ssl-and-secure-transport","SSL and secure transport",[89,261],{"alt":262,"dark":263,"light":264},"SSL Configuration form with certificate upload fields","\u002Fimages\u002Fdocs\u002Fconnections\u002Fssl-configuration-dark.png","\u002Fimages\u002Fdocs\u002Fconnections\u002Fssl-configuration-light.png",[14,266,267],{},"Use SSL\u002FTLS settings when the selected environment requires encrypted transport or certificate validation.",[14,269,270,271,106],{},"For full guidance, use ",[234,272,274],{"href":273},"\u002Fdocs\u002Fnetwork-security\u002Fssl-configuration","SSL Configuration",[48,276,278],{"id":277},"common-actions","Common actions",[133,280,74],{"id":281},"edit",[14,283,284],{},"Use edit when credentials, host details, database scope, or transport settings change.",[133,286,78],{"id":287},"clone",[14,289,290],{},"Use clone when you need a similar connection with small changes, such as:",[21,292,293,296,299],{},[24,294,295],{},"another environment",[24,297,298],{},"another database",[24,300,301],{},"another region or provider",[133,303,82],{"id":304},"delete",[14,306,307],{},"Delete removes the saved configuration. Use it only after confirming nothing still depends on it.",[48,309,311],{"id":310},"best-practices","Best practices",[98,313,314,317,320,323,326],{},[24,315,316],{},"Use descriptive names that encode environment or purpose.",[24,318,319],{},"Test every connection before using it in a stream.",[24,321,322],{},"Validate visibility in Data Explorer before assuming the stream scope is correct.",[24,324,325],{},"Use SSL\u002FTLS in production-relevant environments where appropriate.",[24,327,328],{},"Remove unused connections to keep the workspace readable.",[48,330,332],{"id":331},"related-docs","Related docs",[21,334,335,341,347,351,355,361],{},[24,336,337],{},[234,338,340],{"href":339},"\u002Fdocs\u002Fconnections\u002Fmysql-server","MySQL Server Setup",[24,342,343],{},[234,344,346],{"href":345},"\u002Fdocs\u002Fconnections\u002Fpostgresql-server","PostgreSQL Server Setup",[24,348,349],{},[234,350,237],{"href":236},[24,352,353],{},[234,354,255],{"href":254},[24,356,357],{},[234,358,360],{"href":359},"\u002Fdocs\u002Fconnections\u002Fsnowflake","Snowflake Target",[24,362,363],{},[234,364,366],{"href":365},"\u002Fdocs\u002Fapi\u002Fconnections","Connections API Reference",{"title":368,"searchDepth":369,"depth":369,"links":370},"",2,[371,372,373,379,380,385,386],{"id":50,"depth":369,"text":51},{"id":86,"depth":369,"text":87},{"id":124,"depth":369,"text":125,"children":374},[375,377,378],{"id":135,"depth":376,"text":136},3,{"id":162,"depth":376,"text":163},{"id":240,"depth":376,"text":241},{"id":258,"depth":369,"text":259},{"id":277,"depth":369,"text":278,"children":381},[382,383,384],{"id":281,"depth":376,"text":74},{"id":287,"depth":376,"text":78},{"id":304,"depth":376,"text":82},{"id":310,"depth":369,"text":311},{"id":331,"depth":369,"text":332},"Manage connections for databases, file workflows, and supported storage-backed workflows in DBConvert Streams.","md",{},false,"\u002Fdocs\u002Fconnections\u002Fconnection-management",null,{"title":5,"description":387},"docs\u002Fconnections\u002Fconnection-management","kGSbUtun6LJFfGacURm5MaBLGW1CzQQFoPVDsddzvAA",1783896283360]