[{"data":1,"prerenderedAt":700},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fconnections\u002Foverview":3},{"page":4,"navigation":628,"surround":697},{"_path":5,"_dir":6,"_draft":7,"_partial":7,"_locale":8,"title":9,"description":10,"navigation":11,"body":13,"_type":622,"_id":623,"_source":624,"_file":625,"_stem":626,"_extension":627},"\u002Fdocs\u002Fconnections\u002Foverview","connections",false,"","Connections","Add a source, name it, choose which tables to sync, and understand how its tables are named in SQL.",{"title":12},"Overview",{"type":14,"children":15,"toc":614},"root",[16,25,206,228,234,272,290,296,301,388,409,415,428,504,531,559,571,577,597,603,608],{"type":17,"tag":18,"props":19,"children":21},"element","h2",{"id":20},"supported-sources",[22],{"type":23,"value":24},"text","Supported sources",{"type":17,"tag":26,"props":27,"children":28},"table",{},[29,53],{"type":17,"tag":30,"props":31,"children":32},"thead",{},[33],{"type":17,"tag":34,"props":35,"children":36},"tr",{},[37,43,48],{"type":17,"tag":38,"props":39,"children":40},"th",{},[41],{"type":23,"value":42},"Source",{"type":17,"tag":38,"props":44,"children":45},{},[46],{"type":23,"value":47},"How it connects",{"type":17,"tag":38,"props":49,"children":50},{},[51],{"type":23,"value":52},"Guide",{"type":17,"tag":54,"props":55,"children":56},"tbody",{},[57,80,101,122,143,165,184],{"type":17,"tag":34,"props":58,"children":59},{},[60,66,71],{"type":17,"tag":61,"props":62,"children":63},"td",{},[64],{"type":23,"value":65},"Salesforce",{"type":17,"tag":61,"props":67,"children":68},{},[69],{"type":23,"value":70},"Username and security token, a connected app, or a refresh token",{"type":17,"tag":61,"props":72,"children":73},{},[74],{"type":17,"tag":75,"props":76,"children":78},"a",{"href":77},"\u002Fdocs\u002Fconnections\u002Fsalesforce",[79],{"type":23,"value":65},{"type":17,"tag":34,"props":81,"children":82},{},[83,88,93],{"type":17,"tag":61,"props":84,"children":85},{},[86],{"type":23,"value":87},"Marketo",{"type":17,"tag":61,"props":89,"children":90},{},[91],{"type":23,"value":92},"REST API client ID and secret",{"type":17,"tag":61,"props":94,"children":95},{},[96],{"type":17,"tag":75,"props":97,"children":99},{"href":98},"\u002Fdocs\u002Fconnections\u002Fmarketo",[100],{"type":23,"value":87},{"type":17,"tag":34,"props":102,"children":103},{},[104,109,114],{"type":17,"tag":61,"props":105,"children":106},{},[107],{"type":23,"value":108},"Google Analytics 4",{"type":17,"tag":61,"props":110,"children":111},{},[112],{"type":23,"value":113},"The property's BigQuery export, read with a service account",{"type":17,"tag":61,"props":115,"children":116},{},[117],{"type":17,"tag":75,"props":118,"children":120},{"href":119},"\u002Fdocs\u002Fconnections\u002Fgoogle-analytics-4",[121],{"type":23,"value":108},{"type":17,"tag":34,"props":123,"children":124},{},[125,130,135],{"type":17,"tag":61,"props":126,"children":127},{},[128],{"type":23,"value":129},"Google Ads",{"type":17,"tag":61,"props":131,"children":132},{},[133],{"type":23,"value":134},"A Google Cloud service account added as a user of the account",{"type":17,"tag":61,"props":136,"children":137},{},[138],{"type":17,"tag":75,"props":139,"children":141},{"href":140},"\u002Fdocs\u002Fconnections\u002Fgoogle-ads",[142],{"type":23,"value":129},{"type":17,"tag":34,"props":144,"children":145},{},[146,151,156],{"type":17,"tag":61,"props":147,"children":148},{},[149],{"type":23,"value":150},"PostgreSQL",{"type":17,"tag":61,"props":152,"children":153},{},[154],{"type":23,"value":155},"Host, database, user and password",{"type":17,"tag":61,"props":157,"children":158},{},[159],{"type":17,"tag":75,"props":160,"children":162},{"href":161},"\u002Fdocs\u002Fconnections\u002Fpostgres-mysql",[163],{"type":23,"value":164},"PostgreSQL and MySQL",{"type":17,"tag":34,"props":166,"children":167},{},[168,173,177],{"type":17,"tag":61,"props":169,"children":170},{},[171],{"type":23,"value":172},"MySQL",{"type":17,"tag":61,"props":174,"children":175},{},[176],{"type":23,"value":155},{"type":17,"tag":61,"props":178,"children":179},{},[180],{"type":17,"tag":75,"props":181,"children":182},{"href":161},[183],{"type":23,"value":164},{"type":17,"tag":34,"props":185,"children":186},{},[187,192,197],{"type":17,"tag":61,"props":188,"children":189},{},[190],{"type":23,"value":191},"Sample data",{"type":17,"tag":61,"props":193,"children":194},{},[195],{"type":23,"value":196},"One click, no credentials",{"type":17,"tag":61,"props":198,"children":199},{},[200],{"type":17,"tag":75,"props":201,"children":203},{"href":202},"\u002Fdocs\u002Fgetting-started\u002Fquickstart",[204],{"type":23,"value":205},"Quickstart",{"type":17,"tag":207,"props":208,"children":209},"p",{},[210,212,218,220,226],{"type":23,"value":211},"HubSpot and NetSuite are listed as ",{"type":17,"tag":213,"props":214,"children":215},"strong",{},[216],{"type":23,"value":217},"Coming soon",{"type":23,"value":219}," in the app. If you need a source that isn't listed, ",{"type":17,"tag":75,"props":221,"children":223},{"href":222},"\u002Fcontact",[224],{"type":23,"value":225},"tell us",{"type":23,"value":227},".",{"type":17,"tag":18,"props":229,"children":231},{"id":230},"adding-a-connection",[232],{"type":23,"value":233},"Adding a connection",{"type":17,"tag":235,"props":236,"children":237},"ol",{},[238,250,255,260],{"type":17,"tag":239,"props":240,"children":241},"li",{},[242,244,248],{"type":23,"value":243},"Open ",{"type":17,"tag":213,"props":245,"children":246},{},[247],{"type":23,"value":9},{"type":23,"value":249}," and choose a source.",{"type":17,"tag":239,"props":251,"children":252},{},[253],{"type":23,"value":254},"Give the connection a name (see below) and fill in the credentials.",{"type":17,"tag":239,"props":256,"children":257},{},[258],{"type":23,"value":259},"Save. Datachef tests the connection and lists the tables the source offers.",{"type":17,"tag":239,"props":261,"children":262},{},[263,265,271],{"type":23,"value":264},"Turn on the tables you want and choose how each one syncs. See ",{"type":17,"tag":75,"props":266,"children":268},{"href":267},"\u002Fdocs\u002Fconnections\u002Fsync-settings",[269],{"type":23,"value":270},"sync settings",{"type":23,"value":227},{"type":17,"tag":207,"props":273,"children":274},{},[275,277,282,284,289],{"type":23,"value":276},"Adding and changing connections needs the ",{"type":17,"tag":213,"props":278,"children":279},{},[280],{"type":23,"value":281},"Editor",{"type":23,"value":283}," role in the workspace. Deleting one needs ",{"type":17,"tag":213,"props":285,"children":286},{},[287],{"type":23,"value":288},"Admin",{"type":23,"value":227},{"type":17,"tag":18,"props":291,"children":293},{"id":292},"connection-names-and-labels",[294],{"type":23,"value":295},"Connection names and labels",{"type":17,"tag":207,"props":297,"children":298},{},[299],{"type":23,"value":300},"Every connection has two names:",{"type":17,"tag":26,"props":302,"children":303},{},[304,328],{"type":17,"tag":30,"props":305,"children":306},{},[307],{"type":17,"tag":34,"props":308,"children":309},{},[310,313,318,323],{"type":17,"tag":38,"props":311,"children":312},{},[],{"type":17,"tag":38,"props":314,"children":315},{},[316],{"type":23,"value":317},"What it is",{"type":17,"tag":38,"props":319,"children":320},{},[321],{"type":23,"value":322},"Example",{"type":17,"tag":38,"props":324,"children":325},{},[326],{"type":23,"value":327},"Can change?",{"type":17,"tag":54,"props":329,"children":330},{},[331,362],{"type":17,"tag":34,"props":332,"children":333},{},[334,342,347,357],{"type":17,"tag":61,"props":335,"children":336},{},[337],{"type":17,"tag":213,"props":338,"children":339},{},[340],{"type":23,"value":341},"Name",{"type":17,"tag":61,"props":343,"children":344},{},[345],{"type":23,"value":346},"The SQL schema its tables are queried through",{"type":17,"tag":61,"props":348,"children":349},{},[350],{"type":17,"tag":351,"props":352,"children":354},"code",{"className":353},[],[355],{"type":23,"value":356},"salesforce_sandbox_1",{"type":17,"tag":61,"props":358,"children":359},{},[360],{"type":23,"value":361},"No, it's fixed when the connection is created",{"type":17,"tag":34,"props":363,"children":364},{},[365,373,378,383],{"type":17,"tag":61,"props":366,"children":367},{},[368],{"type":17,"tag":213,"props":369,"children":370},{},[371],{"type":23,"value":372},"Label",{"type":17,"tag":61,"props":374,"children":375},{},[376],{"type":23,"value":377},"What people see in the app",{"type":17,"tag":61,"props":379,"children":380},{},[381],{"type":23,"value":382},"Salesforce (EU sandbox)",{"type":17,"tag":61,"props":384,"children":385},{},[386],{"type":23,"value":387},"Yes",{"type":17,"tag":207,"props":389,"children":390},{},[391,393,399,401,407],{"type":23,"value":392},"The name is fixed because every query, model and tab that reads those tables refers to it. A name is lower snake case, starts with a letter, is at most 63 characters, and is unique in the workspace. The form suggests a free one: ",{"type":17,"tag":351,"props":394,"children":396},{"className":395},[],[397],{"type":23,"value":398},"salesforce",{"type":23,"value":400},", then ",{"type":17,"tag":351,"props":402,"children":404},{"className":403},[],[405],{"type":23,"value":406},"salesforce_2",{"type":23,"value":408},", and so on.",{"type":17,"tag":18,"props":410,"children":412},{"id":411},"how-tables-are-named",[413],{"type":23,"value":414},"How tables are named",{"type":17,"tag":207,"props":416,"children":417},{},[418,420,426],{"type":23,"value":419},"Tables are queried as ",{"type":17,"tag":351,"props":421,"children":423},{"className":422},[],[424],{"type":23,"value":425},"\u003Cconnection name>.\u003Ctable>",{"type":23,"value":427},":",{"type":17,"tag":429,"props":430,"children":434},"pre",{"className":431,"code":432,"language":433,"meta":8,"style":8},"language-sql shiki shiki-themes github-light github-dark","SELECT stagename, sum(amount)\nFROM salesforce.opportunity\nGROUP BY 1\n","sql",[435],{"type":17,"tag":351,"props":436,"children":437},{"__ignoreMap":8},[438,467,490],{"type":17,"tag":439,"props":440,"children":443},"span",{"class":441,"line":442},"line",1,[444,450,456,462],{"type":17,"tag":439,"props":445,"children":447},{"style":446},"--shiki-default:#D73A49;--shiki-dark:#F97583",[448],{"type":23,"value":449},"SELECT",{"type":17,"tag":439,"props":451,"children":453},{"style":452},"--shiki-default:#24292E;--shiki-dark:#E1E4E8",[454],{"type":23,"value":455}," stagename, ",{"type":17,"tag":439,"props":457,"children":459},{"style":458},"--shiki-default:#005CC5;--shiki-dark:#79B8FF",[460],{"type":23,"value":461},"sum",{"type":17,"tag":439,"props":463,"children":464},{"style":452},[465],{"type":23,"value":466},"(amount)\n",{"type":17,"tag":439,"props":468,"children":470},{"class":441,"line":469},2,[471,476,481,485],{"type":17,"tag":439,"props":472,"children":473},{"style":446},[474],{"type":23,"value":475},"FROM",{"type":17,"tag":439,"props":477,"children":478},{"style":458},[479],{"type":23,"value":480}," salesforce",{"type":17,"tag":439,"props":482,"children":483},{"style":452},[484],{"type":23,"value":227},{"type":17,"tag":439,"props":486,"children":487},{"style":458},[488],{"type":23,"value":489},"opportunity\n",{"type":17,"tag":439,"props":491,"children":493},{"class":441,"line":492},3,[494,499],{"type":17,"tag":439,"props":495,"children":496},{"style":446},[497],{"type":23,"value":498},"GROUP BY",{"type":17,"tag":439,"props":500,"children":501},{"style":458},[502],{"type":23,"value":503}," 1\n",{"type":17,"tag":207,"props":505,"children":506},{},[507,509,514,516,522,524,530],{"type":23,"value":508},"So a second Salesforce connection named ",{"type":17,"tag":351,"props":510,"children":512},{"className":511},[],[513],{"type":23,"value":356},{"type":23,"value":515}," lands its tables as ",{"type":17,"tag":351,"props":517,"children":519},{"className":518},[],[520],{"type":23,"value":521},"salesforce_sandbox_1.opportunity",{"type":23,"value":523},", beside the first connection's ",{"type":17,"tag":351,"props":525,"children":527},{"className":526},[],[528],{"type":23,"value":529},"salesforce.opportunity",{"type":23,"value":227},{"type":17,"tag":207,"props":532,"children":533},{},[534,536,542,544,550,552,558],{"type":23,"value":535},"Database tables outside the default schema keep their schema as a prefix: a Postgres table ",{"type":17,"tag":351,"props":537,"children":539},{"className":538},[],[540],{"type":23,"value":541},"sales.orders",{"type":23,"value":543}," in a connection named ",{"type":17,"tag":351,"props":545,"children":547},{"className":546},[],[548],{"type":23,"value":549},"warehouse",{"type":23,"value":551}," becomes ",{"type":17,"tag":351,"props":553,"children":555},{"className":554},[],[556],{"type":23,"value":557},"warehouse.sales_orders",{"type":23,"value":227},{"type":17,"tag":207,"props":560,"children":561},{},[562,564,570],{"type":23,"value":563},"Connections created before connection names existed keep their original flat table names, such as ",{"type":17,"tag":351,"props":565,"children":567},{"className":566},[],[568],{"type":23,"value":569},"salesforce_opportunity",{"type":23,"value":227},{"type":17,"tag":18,"props":572,"children":574},{"id":573},"credentials",[575],{"type":23,"value":576},"Credentials",{"type":17,"tag":207,"props":578,"children":579},{},[580,582,588,590,596],{"type":23,"value":581},"Connection credentials are encrypted when they're stored. They're never sent back to your browser, to an AI agent connected through the ",{"type":17,"tag":75,"props":583,"children":585},{"href":584},"\u002Fdocs\u002Fai-agents\u002Fclaude-connector",[586],{"type":23,"value":587},"Claude connector",{"type":23,"value":589},", or to Datachef support staff. See ",{"type":17,"tag":75,"props":591,"children":593},{"href":592},"\u002Fdocs\u002Fadministration\u002Fsecurity",[594],{"type":23,"value":595},"security",{"type":23,"value":227},{"type":17,"tag":18,"props":598,"children":600},{"id":599},"deleting-a-connection",[601],{"type":23,"value":602},"Deleting a connection",{"type":17,"tag":207,"props":604,"children":605},{},[606],{"type":23,"value":607},"Deleting a connection stops its syncs. The tables it already synced are kept.",{"type":17,"tag":609,"props":610,"children":611},"style",{},[612],{"type":23,"value":613},"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":8,"searchDepth":469,"depth":469,"links":615},[616,617,618,619,620,621],{"id":20,"depth":469,"text":24},{"id":230,"depth":469,"text":233},{"id":292,"depth":469,"text":295},{"id":411,"depth":469,"text":414},{"id":573,"depth":469,"text":576},{"id":599,"depth":469,"text":602},"markdown","content:docs:2.connections:1.overview.md","content","docs\u002F2.connections\u002F1.overview.md","docs\u002F2.connections\u002F1.overview","md",[629],{"title":630,"_path":631,"children":632},"Welcome","\u002Fdocs",[633,634,642,654,670,677,685],{"title":630,"_path":631},{"title":635,"_path":636,"children":637},"Getting started","\u002Fdocs\u002Fgetting-started",[638,639],{"title":205,"_path":202},{"title":640,"_path":641},"Key concepts","\u002Fdocs\u002Fgetting-started\u002Fconcepts",{"title":643,"_path":644,"children":645},"Connecting data","\u002Fdocs\u002Fconnections",[646,647,649,650,651,652,653],{"title":12,"_path":5},{"title":648,"_path":267},"Sync settings",{"title":129,"_path":140},{"title":108,"_path":119},{"title":87,"_path":98},{"title":164,"_path":161},{"title":65,"_path":77},{"title":655,"_path":656,"children":657},"Analysis","\u002Fdocs\u002Fanalysis",[658,661,664,667],{"title":659,"_path":660},"Asking questions","\u002Fdocs\u002Fanalysis\u002Fask-a-question",{"title":662,"_path":663},"SQL editor","\u002Fdocs\u002Fanalysis\u002Fsql-editor",{"title":665,"_path":666},"Charts","\u002Fdocs\u002Fanalysis\u002Fcharts",{"title":668,"_path":669},"Tabs and sharing","\u002Fdocs\u002Fanalysis\u002Ftabs-and-sharing",{"title":671,"_path":672,"children":673},"Models","\u002Fdocs\u002Fmodels",[674],{"title":675,"_path":676},"Working with models","\u002Fdocs\u002Fmodels\u002Foverview",{"title":678,"_path":679,"children":680},"AI agents","\u002Fdocs\u002Fai-agents",[681,682],{"title":587,"_path":584},{"title":683,"_path":684},"Tools","\u002Fdocs\u002Fai-agents\u002Ftools",{"title":686,"_path":687,"children":688},"Administration","\u002Fdocs\u002Fadministration",[689,692,695],{"title":690,"_path":691},"People and roles","\u002Fdocs\u002Fadministration\u002Fpeople-and-roles",{"title":693,"_path":694},"Sign-in and SSO","\u002Fdocs\u002Fadministration\u002Fsign-in-and-sso",{"title":696,"_path":592},"Security",[698,699],{"_path":641,"title":640},{"_path":267,"title":648},1794442271713]