Connect Ana to a data warehouse, upload a file, or link a BI tool.
Ana needs at least one data source to work with. There are three ways to connect:
Connect a data warehouse — For live access to Snowflake, BigQuery, Redshift, Databricks, and more, see The Connectors Page. Covers credentials, schema discovery, and connector management
Upload a file — Attach a CSV or Excel file directly in a thread for instant analysis. No configuration needed — see Your First Chat
Connect a BI tool — Link Tableau or Power BI so Ana can analyze your existing dashboards alongside your warehouse data. See Tableau Connector and Power BI Connector
New to TextQL? Start with a file upload — no setup required. Connect your warehouse once you’re ready for production use.
Don’t have data to connect yet? Most workspaces come with sample data you can explore right away.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TextQL Docs","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/textql/9RDmZW4lVU96oHnJ/logo-textql/light.svg?fit=max\u0026auto=format\u0026n=9RDmZW4lVU96oHnJ\u0026q=85\u0026s=069d276e4ee2f256e061f8e2db9860a3","dark":"https://mintcdn.com/textql/9RDmZW4lVU96oHnJ/logo-textql/dark.svg?fit=max\u0026auto=format\u0026n=9RDmZW4lVU96oHnJ\u0026q=85\u0026s=1a728bc3acfd6eda203c49a45eac0355"},"favicon":"https://mintcdn.com/textql/jK3bTwZd_T-GaQ4j/favicon.svg?fit=max\u0026auto=format\u0026n=jK3bTwZd_T-GaQ4j\u0026q=85\u0026s=4f7feffa45a51a795a1b929f05a772bf","api":{"openapi":["api-reference/platform/chat.openapi.yaml","api-reference/platform/playbooks.openapi.yaml","api-reference/platform/agents.openapi.yaml","api-reference/platform/connectors.openapi.yaml","api-reference/platform/api_access_key.openapi.yaml","api-reference/platform/sandbox.openapi.yaml","api-reference/platform/v2.openapi.yaml","api-reference/speakeasy/textql-api-with-code-samples.yaml"],"mdx":{"auth":{"method":"bearer"},"server":"https://app.textql.com"}},"appearance":{"default":"light","strict":false},"navbar":{"links":[{"href":"mailto:support@textql.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.textql.com"}},"footer":{"socials":{"x":"https://x.com/TextQL","github":"https://github.com/textqllabs","linkedin":"https://www.linkedin.com/company/textql"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"textql","hasAudioNarration":false,"actualSubdomain":"textql","customDomains":["docs.textql.com"],"gitSource":{"type":"github","owner":"textqllabs","repo":"demo2","deployBranch":"main","contentDirectory":"docs/public","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aecc9f04df1cfa6996a0920","collectionId":"dc395dc9-ef15-4be2-97aa-8ca0516badb4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aecc9f04df1cfa6996a0920"},"entitlements":{},"buildId":"6aee771b67e25c4647c87bb2","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"v3 API (SDK)","count":454},{"language":"default","tag":"Workshops","count":202},{"language":"default","tag":"Documentation","count":163},{"language":"default","tag":"Ontology Management Service","count":70},{"language":"default","tag":"v2 API","count":56},{"language":"default","tag":"Set Up Your Data","count":55},{"language":"default","tag":"RBAC Service","count":41},{"language":"default","tag":"Chat Service","count":39},{"language":"default","tag":"Playbook Service","count":39},{"language":"default","tag":"How It Works","count":32}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table{width:100%;border-collapse:collapse;margin:1rem 0}th,td{border:1px solid #e5e7eb;padding:0.6rem 0.85rem;text-align:left;vertical-align:top;line-height:1.45}th{background:#f9fafb;font-weight:600}th:first-child,td:first-child{white-space:nowrap}.dark th,.dark td{border-color:#2b2b2b}.dark th{background:#18181b}"}],"page":{"pagePath":"core/get-started/connect-your-data","slug":"/core/get-started/connect-your-data","pageMetadata":{"title":"Connect Your Data","description":"Connect Ana to a data warehouse, upload a file, or link a BI tool.","icon":"database","href":"/core/get-started/connect-your-data"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect Ana to a data warehouse, upload a file, or link a BI tool.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,OptimizedImage,Tip}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/textql/xKEht7LI4-qtrybJ/images/Connect%20Data.png?fit=max\u0026auto=format\u0026n=xKEht7LI4-qtrybJ\u0026q=85\u0026s=bffb948298827815845c2e8d51957826`,alt:`Connect Your Data`,\"data-og-width\":`1784`,width:`1784`,\"data-og-height\":`732`,height:`732`,\"data-path\":`images/Connect Data.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/textql/xKEht7LI4-qtrybJ/images/Connect%20Data.png?w=280\u0026fit=max\u0026auto=format\u0026n=xKEht7LI4-qtrybJ\u0026q=85\u0026s=d42e57b8070b2e35380e4c6cce936288 280w, https://mintcdn.com/textql/xKEht7LI4-qtrybJ/images/Connect%20Data.png?w=560\u0026fit=max\u0026auto=format\u0026n=xKEht7LI4-qtrybJ\u0026q=85\u0026s=808291033181d4162202be6ac54b222b 560w, https://mintcdn.com/textql/xKEht7LI4-qtrybJ/images/Connect%20Data.png?w=840\u0026fit=max\u0026auto=format\u0026n=xKEht7LI4-qtrybJ\u0026q=85\u0026s=6fe8874c1306cda88f51e4ae5741e250 840w, https://mintcdn.com/textql/xKEht7LI4-qtrybJ/images/Connect%20Data.png?w=1100\u0026fit=max\u0026auto=format\u0026n=xKEht7LI4-qtrybJ\u0026q=85\u0026s=98c781e03c0e1761d058bbe0f01690c7 1100w, https://mintcdn.com/textql/xKEht7LI4-qtrybJ/images/Connect%20Data.png?w=1650\u0026fit=max\u0026auto=format\u0026n=xKEht7LI4-qtrybJ\u0026q=85\u0026s=40a91dccd34944742965921679b78e0a 1650w, https://mintcdn.com/textql/xKEht7LI4-qtrybJ/images/Connect%20Data.png?w=2500\u0026fit=max\u0026auto=format\u0026n=xKEht7LI4-qtrybJ\u0026q=85\u0026s=a5805af6e6ab590836929ebf2105c15d 2500w`})}),`\n`,_jsx(_components.p,{children:`Ana needs at least one data source to work with. There are three ways to connect:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connect a data warehouse`}),` — For live access to Snowflake, BigQuery, Redshift, Databricks, and more, see `,_jsx(_components.a,{href:`/core/datasources/the-connectors-page`,children:`The Connectors Page`}),`. Covers credentials, schema discovery, and connector management`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Upload a file`}),` — Attach a CSV or Excel file directly in a thread for instant analysis. No configuration needed — see `,_jsx(_components.a,{href:`/core/get-started/your-first-chat`,children:`Your First Chat`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connect a BI tool`}),` — Link Tableau or Power BI so Ana can analyze your existing dashboards alongside your warehouse data. See `,_jsx(_components.a,{href:`/core/datasources/business-intel/tableau-connector`,children:`Tableau Connector`}),` and `,_jsx(_components.a,{href:`/core/datasources/business-intel/powerbi-connector`,children:`Power BI Connector`})]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`New to TextQL? Start with a file upload — no setup required. Connect your warehouse once you’re ready for production use.`})}),`\n`,_jsxs(_components.p,{children:[`Don’t have data to connect yet? Most workspaces come with `,_jsx(_components.a,{href:`/core/get-started/sample-data`,children:`sample data`}),` you can explore right away.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connect Your Data","description":"Connect Ana to a data warehouse, upload a file, or link a BI tool.","icon":"database","href":"/core/get-started/connect-your-data"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"textql","siteName":"TextQL Docs","title":"Connect Your Data - TextQL Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-26T17:22:22.260Z","originalFileLocation":"core/get-started/connect-your-data.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect Ana to a data warehouse, upload a file, or link a BI tool.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TextQL Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect Your Data - TextQL Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect Ana to a data warehouse, upload a file, or link a BI tool.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TextQL Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.textql.com/core/get-started/connect-your-data\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://textql.mintlify.site/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=Connect+Your+Data\u0026amp;description=Connect+Ana+to+a+data+warehouse%2C+upload+a+file%2C+or+link+a+BI+tool.\u0026amp;theme=a75e06317ec6b7e82a309c26\u0026amp;signature=6a34f73b3aa11a2ef28e475bf06a8c977464cf5538d2171e79d9010d31b67a8e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connect Your Data - TextQL Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect Ana to a data warehouse, upload a file, or link a BI tool.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://textql.mintlify.site/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=Connect+Your+Data\u0026amp;description=Connect+Ana+to+a+data+warehouse%2C+upload+a+file%2C+or+link+a+BI+tool.\u0026amp;theme=a75e06317ec6b7e82a309c26\u0026amp;signature=6a34f73b3aa11a2ef28e475bf06a8c977464cf5538d2171e79d9010d31b67a8e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/textql/UPDKEixAE9_oDjsV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TextQL Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.textql.com/core/get-started/connect-your-data\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/core/get-started/connect-your-data.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.textql.com/#organization\",\"name\":\"TextQL Docs\",\"url\":\"https://docs.textql.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/textql/9RDmZW4lVU96oHnJ/logo-textql/light.svg?fit=max\u0026auto=format\u0026n=9RDmZW4lVU96oHnJ\u0026q=85\u0026s=069d276e4ee2f256e061f8e2db9860a3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.textql.com#website\",\"name\":\"TextQL Docs\",\"url\":\"https://docs.textql.com\",\"publisher\":{\"@id\":\"https://docs.textql.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.textql.com/core/get-started/connect-your-data#webpage\",\"url\":\"https://docs.textql.com/core/get-started/connect-your-data\",\"name\":\"Connect Your Data\",\"description\":\"Connect Ana to a data warehouse, upload a file, or link a BI tool.\",\"dateModified\":\"2026-06-26T17:22:22.260Z\",\"isPartOf\":{\"@id\":\"https://docs.textql.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.textql.com/core/get-started/connect-your-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.textql.com/core/get-started/connect-your-data#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get Started\",\"item\":\"https://docs.textql.com/core/get-started/quickstart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect Your Data\",\"item\":\"https://docs.textql.com/core/get-started/connect-your-data\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.textql.com/core/get-started/connect-your-data#article\",\"headline\":\"Connect Your Data\",\"name\":\"Connect Your Data\",\"description\":\"Connect Ana to a data warehouse, upload a file, or link a BI tool.\",\"url\":\"https://docs.textql.com/core/get-started/connect-your-data\",\"mainEntityOfPage\":{\"@id\":\"https://docs.textql.com/core/get-started/connect-your-data#webpage\"},\"dateModified\":\"2026-06-26T17:22:22.260Z\",\"publisher\":{\"@id\":\"https://docs.textql.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.textql.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TextQL Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"TextQL Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"What is TextQL","sidebarTitle":"Introduction","description":"TextQL is an AI data scientist that connects to your entire data stack and answers questions in plain language.","icon":"rocket","href":"/core/get-started/quickstart"},{"title":"Connect Your Data","icon":"database","href":"/core/get-started/connect-your-data"},{"title":"Example Connectors","description":"Sample data sources for exploring, demoing, and testing connector workflows.","icon":"flask","href":"/core/get-started/sample-data"},{"title":"Your First Chat","icon":"comment-dots","href":"/core/get-started/your-first-chat"}]},{"group":"How It Works","pages":[{"title":"Threads — Chat with Ana","sidebarTitle":"Threads","icon":"robot","href":"/core/how-it-works/ana/overview"},{"group":"Playbooks","icon":"play","pages":[{"title":"Build Playbooks Directly in Threads","icon":"play","href":"/core/how-it-works/playbooks/build-from-threads"},{"title":"Overview","icon":"play","href":"/core/how-it-works/playbooks"},{"title":"Slack Integration","icon":"play","href":"/core/how-it-works/playbooks/slack-integration"},{"title":"Teams Integration","icon":"microsoft","href":"/core/how-it-works/playbooks/teams-integration"},{"title":"Templates","icon":"play","href":"/core/how-it-works/playbooks/templates"},{"title":"Your First Playbook","icon":"play","href":"/core/how-it-works/playbooks/your-first-playbook"}]},{"group":"Tools","icon":"wrench","pages":[{"title":"Overview","sidebarTitle":"Overview","icon":"wrench","href":"/core/how-it-works/tools"},{"title":"Text to SQL","sidebarTitle":"Text to SQL","icon":"wrench","href":"/core/how-it-works/tools/text-to-sql"},{"title":"TQL Query","icon":"brackets-curly","href":"/core/how-it-works/tools/tql-query"},{"title":"Ana Forms","sidebarTitle":"Ana Forms","icon":"wrench","href":"/core/how-it-works/tools/ana-forms"},{"title":"Web Search","sidebarTitle":"Web Search","icon":"wrench","href":"/core/how-it-works/tools/web-search"},{"title":"Thread History Search","icon":"magnifying-glass","href":"/core/how-it-works/tools/thread-search"},{"title":"Platform API Tools","sidebarTitle":"Platform API Tools","icon":"plug","href":"/core/how-it-works/tools/platform-api"},{"title":"File Upload","sidebarTitle":"File Upload","icon":"paperclip","href":"/core/how-it-works/tools/file-upload"},{"title":"Voice Input","sidebarTitle":"Voice Input","icon":"microphone","href":"/core/how-it-works/tools/voice-input"},{"title":"Decide","sidebarTitle":"Decide","icon":"scale-balanced","href":"/core/how-it-works/tools/decide"}]},{"group":"Data Apps","icon":"window-restore","pages":[{"title":"Data Apps","icon":"window-restore","href":"/core/how-it-works/data-apps"},{"title":"The ana.* Functions","icon":"code","href":"/core/how-it-works/data-apps/ana-functions"},{"title":"Row-Level Security","icon":"shield-halved","href":"/core/how-it-works/data-apps/row-level-security"}]},{"title":"Dashboards","icon":"chart-mixed","href":"/core/how-it-works/dashboards"},{"title":"Artifacts","icon":"folder-open","href":"/core/how-it-works/artifacts"},{"title":"Citations","sidebarTitle":"Citations","icon":"quote-right","href":"/core/how-it-works/citations"},{"title":"Subagents","sidebarTitle":"Subagents","icon":"sitemap","href":"/core/how-it-works/ana/subagents"},{"title":"Agent Harnesses","sidebarTitle":"Agent Harnesses","icon":"robot","href":"/core/how-it-works/ana/harnesses"},{"group":"Feed","icon":"rss","pages":[{"title":"Agents","sidebarTitle":"Agents","icon":"robot","href":"/core/how-it-works/feed/agents"},{"title":"Build your first feed agent","sidebarTitle":"Build your first feed agent","icon":"rocket","href":"/core/how-it-works/feed/quickstart"},{"title":"Feed Overview","sidebarTitle":"Overview","icon":"rss","href":"/core/how-it-works/feed"},{"title":"Feeds and channels","sidebarTitle":"Feeds and channels","icon":"rss","href":"/core/how-it-works/feed/feeds-and-channels"},{"group":"Triggers","icon":"bolt","pages":[{"title":"Slack triggers","sidebarTitle":"Slack triggers","icon":"slack","href":"/core/how-it-works/feed/triggers/slack-triggers"}]}]},{"title":"CLI","icon":"terminal","href":"/core/admin/cli"},{"title":"Running an Agent Loop on Sandcastles","icon":"robot","href":"/core/guides/agent-loop-sandcastles"}]},{"group":"Set Up Your Data","pages":[{"title":"The Connectors Page","icon":"down-left-and-up-right-to-center","href":"/core/datasources/the-connectors-page"},{"group":"APIs","icon":"key","pages":[{"title":"Overview","icon":"globe","href":"/core/datasources/api-connectors"},{"title":"Anthropic API Connector","icon":"robot","href":"/core/datasources/apis/anthropic"},{"title":"Apollo.io Connector","icon":"address-book","href":"/core/datasources/apis/apollo"},{"title":"Attio Connector","icon":"address-book","href":"/core/datasources/apis/attio"},{"title":"AWS Connector","icon":"aws","href":"/core/datasources/apis/aws"},{"title":"Microsoft Azure Connector","icon":"microsoft","href":"/core/datasources/apis/azure"},{"title":"Cloudflare Connector","icon":"cloudflare","href":"/core/datasources/apis/cloudflare"},{"title":"Dropbox Connector","icon":"dropbox","href":"/core/datasources/apis/dropbox"},{"title":"ElevenLabs Connector","icon":"microphone","href":"/core/datasources/apis/elevenlabs"},{"title":"Gemini Connector","icon":"sparkles","href":"/core/datasources/apis/gemini"},{"title":"GitHub Connector","icon":"github","href":"/core/datasources/apis/githubapi"},{"title":"Google Cloud Connector","icon":"cloud","href":"/core/datasources/apis/googlecloud"},{"title":"Google Drive Connector","icon":"google-drive","href":"/core/datasources/google-drive"},{"title":"Google Workspace Connector","icon":"google","href":"/core/datasources/google-workspace"},{"title":"Grain Connector","icon":"video","href":"/core/datasources/apis/grain"},{"title":"HubSpot Connector","icon":"hubspot","href":"/core/datasources/apis/hubspot"},{"title":"Jira Connector","icon":"jira","href":"/core/datasources/apis/jira"},{"title":"Linear Connector","icon":"linear","href":"/core/datasources/apis/linear"},{"title":"Mercury Connector","icon":"building-columns","href":"/core/datasources/apis/mercury"},{"title":"Microsoft 365 Connector","icon":"microsoft","href":"/core/datasources/microsoft/microsoft365"},{"title":"Notion Connector","icon":"book","href":"/core/datasources/apis/notion"},{"title":"OpenAI API Connector","icon":"openai","href":"/core/datasources/apis/openai"},{"title":"Oracle Fusion Connector","icon":"cloud","href":"/core/datasources/apis/oracle"},{"title":"PowerBI Connector","icon":"chart-simple","href":"/core/datasources/business-intel/powerbi-connector"},{"title":"Pylon Connector","icon":"headset","href":"/core/datasources/apis/pylon"},{"title":"Ramp Connector","icon":"credit-card","href":"/core/datasources/apis/ramp"},{"title":"Salesforce Connector","icon":"salesforce","href":"/core/datasources/apis/salesforce"},{"title":"SendGrid Connector","icon":"envelope","href":"/core/datasources/apis/sendgrid"},{"title":"Slack API Connector","icon":"slack","href":"/core/datasources/apis/slackapi"},{"title":"Tableau Connector","icon":"t","href":"/core/datasources/business-intel/tableau-connector"},{"title":"YouTube Analytics","icon":"youtube","href":"/core/datasources/youtube"}]},{"group":"Databases","icon":"database","pages":[{"title":"Amazon Aurora Connector","icon":"aws","href":"/core/datasources/databases/aurora"},{"title":"AWS Athena Connector","icon":"aws","href":"/core/datasources/databases/athena"},{"title":"Azure Synapse Analytics Connector","icon":"microsoft","href":"/core/datasources/databases/azure-synapse"},{"title":"BigQuery Connector","icon":"google","href":"/core/datasources/databases/bigquery"},{"title":"ClickHouse Connector","icon":"chart-line","href":"/core/datasources/databases/clickhouse"},{"title":"Databricks Connector","icon":"table","href":"/core/datasources/databases/databricks"},{"title":"Dremio Connector","icon":"database","href":"/core/datasources/databases/dremio"},{"title":"Exasol Connector","icon":"database","href":"/core/datasources/databases/exasol"},{"title":"Firebolt Connector","icon":"fire","href":"/core/datasources/databases/firebolt"},{"title":"kdb+ Connector","icon":"database","href":"/core/datasources/databases/kdb"},{"title":"MongoDB Connector","icon":"database","href":"/core/datasources/databases/mongodb"},{"title":"MySQL Connector","icon":"database","href":"/core/datasources/databases/mysql"},{"title":"Network Configuration","icon":"network-wired","href":"/core/datasources/databases/network-configuration"},{"title":"Per-Member Authentication","icon":"users","href":"/core/datasources/per-member-auth"},{"title":"PostgreSQL Connector","icon":"database","href":"/core/datasources/databases/postgresql"},{"title":"Prometheus Connector","icon":"chart-line","href":"/core/datasources/databases/prometheus"},{"title":"Redshift Connector","icon":"aws","href":"/core/datasources/databases/redshift"},{"title":"SAP HANA Connector","icon":"database","href":"/core/datasources/databases/sap-hana"},{"title":"Snowflake Connector","icon":"snowflake","href":"/core/datasources/databases/snowflake"},{"title":"Supabase Connector","icon":"bolt","href":"/core/datasources/databases/supabase"},{"title":"Trino Connector","icon":"triangle","href":"/core/datasources/databases/trino"}]},{"group":"MCP Servers","icon":"plug","pages":[{"title":"MCP Reference","sidebarTitle":"Reference","icon":"book","href":"/core/how-it-works/mcp/reference"},{"title":"MCP Tools: Getting Started","sidebarTitle":"Getting Started","icon":"rocket","href":"/core/how-it-works/mcp/getting-started"}]}]},{"group":"Integrations","pages":[{"group":"Desktop App","icon":"desktop","pages":[{"title":"Desktop App","icon":"desktop","href":"/core/integrations/desktop-app"},{"title":"Desktop App Rollout","icon":"desktop-arrow-down","href":"/core/admin/desktop-app"}]},{"group":"Embedding TextQL","icon":"code","pages":[{"title":"Embedding Chat","icon":"window-restore","href":"/core/guides/embedding-ana"},{"title":"Embedding Dashboards","icon":"chart-mixed","href":"/core/guides/embedding-dashboards"},{"title":"Embedding Data Apps","icon":"window-restore","href":"/core/guides/embedding-data-apps"}]},{"title":"MS Teams","icon":"microsoft","href":"/core/integrations/teams"},{"title":"Slack","icon":"slack","href":"/core/integrations/slack"}]},{"group":"Ontology","pages":[{"group":"Build Your Ontology","icon":"hammer","pages":[{"title":"Build Your Ontology: Quickstart","sidebarTitle":"Quickstart","icon":"hammer","href":"/core/ontology/build-your-ontology"},{"title":".tql Manual","icon":"code","href":"/core/ontology/tql-reference"}]},{"title":"Skills","icon":"wand-magic-sparkles","href":"/core/ontology/skills"},{"group":"Config Files","icon":"file-code","tag":"Beta","pages":[{"title":"Config Files","sidebarTitle":"Config Files","icon":"file-code","href":"/core/ontology/config-files"},{"title":"Config File Reference","sidebarTitle":"Config File Reference","icon":"code","href":"/core/ontology/config-file-reference"}]},{"title":"Branches","sidebarTitle":"Branches","icon":"code-branch","href":"/core/ontology/branches"},{"title":"Role \u0026 Access","icon":"lock","href":"/core/ontology/ontology-rbac"},{"title":"What is Ontology?","icon":"book-open","href":"/core/ontology/overview"}]},{"group":"Get Better Results","pages":[{"title":"How Ana Thinks","icon":"brain","href":"/core/get-better-results/how-ana-thinks"},{"title":"Interactive HTML Reports","icon":"file-code","href":"/core/guides/interactive-html-reports"},{"title":"Validating and Improving Ana's Answers","sidebarTitle":"Validating Ana's Answers","icon":"circle-check","href":"/core/get-better-results/validating-answers"},{"title":"Writing Better Playbook Prompts","sidebarTitle":"Constructing Better Playbooks","icon":"calendar-check","href":"/core/get-better-results/constructing-better-playbooks"},{"title":"Writing Better Prompts","icon":"pen-to-square","href":"/core/get-better-results/writing-better-prompts"}]},{"group":"Admin \u0026 Security","pages":[{"group":"Settings","icon":"gear","pages":[{"title":"Settings Overview","icon":"gear","href":"/core/admin/settings"},{"title":"API Keys","icon":"key","href":"/core/admin/api-keys"},{"title":"Workload Identity Federation","icon":"id-badge","href":"/core/admin/workload-identity"}]},{"title":"Audit Log","icon":"clipboard-list","href":"/core/admin/audit-log"},{"group":"Compliance","icon":"user-shield","pages":[{"title":"Network Configuration","sidebarTitle":"Network Configuration","icon":"shield-halved","href":"/core/admin/compliance/network-configuration"},{"title":"Network Integration Options","sidebarTitle":"Network Integration","icon":"network-wired","href":"/core/admin/compliance/network-integration"},{"title":"TextQL Deployment Types","sidebarTitle":"Deployment Types","icon":"rocket","href":"/core/admin/compliance/deployment-types"},{"title":"TextQL Inference Options","sidebarTitle":"Model Options","icon":"robot","href":"/core/admin/compliance/inference-options"},{"title":"TextQL Security and Data Governance Whitepaper","sidebarTitle":"Data Governance","icon":"gavel","href":"/core/admin/compliance/security"},{"title":"TextQL-Agent (web requests)","icon":"robot","href":"/bot"}]},{"group":"Console","icon":"desktop","pages":[{"title":"Usage","icon":"chart-column","href":"/core/admin/console/usage"},{"title":"Organization Limits","icon":"database","href":"/core/admin/limits"},{"title":"Chargeback","icon":"sitemap","href":"/core/admin/console/chargeback"}]},{"title":"Deployment Configuration","icon":"gear","href":"/core/admin/deployment-config"},{"title":"Manage Workspaces","icon":"building","href":"/core/admin/manage-workspaces"},{"title":"Model Management","icon":"microchip-ai","href":"/core/admin/models"},{"group":"Observability","icon":"shield-check","pages":[{"title":"Audit Logs and Metrics via OpenTelemetry","sidebarTitle":"OpenTelemetry Export","icon":"arrow-up-from-bracket","href":"/core/admin/observability-export"},{"title":"Observability","icon":"shield-check","href":"/core/admin/observability"},{"title":"Evaluations","icon":"clipboard-check","href":"/core/admin/evaluations"}]},{"title":"Role-Based Access Control (RBAC)","icon":"user-shield","href":"/core/admin/rbac"},{"title":"SCIM Provisioning","icon":"users-gear","href":"/core/admin/scim"},{"group":"Single Sign-On (SSO)","icon":"lock","pages":[{"title":"Okta","icon":"key","href":"/core/admin/sso-okta"},{"title":"Single Sign-On (SSO)","icon":"lock","href":"/core/admin/sso"}]},{"title":"TextQL Pricing and Consumption Table","icon":"circle-question","href":"/core/admin/pricing"},{"group":"Usage \u0026 Billing APIs","icon":"chart-bar","pages":[{"title":"Get Usage via API","icon":"chart-bar","href":"/core/admin/usage-api"},{"title":"BYOK Token Usage","icon":"chart-bar","href":"/core/admin/token-usage-api"}]}]},{"group":"FAQ","pages":[{"title":"Chat Error Messages (Advanced)","icon":"triangle-exclamation","href":"/core/how-it-works/chat-errors"},{"title":"Frequently Asked Questions","icon":"circle-question","href":"/core/how-it-works/faq"},{"title":"Get Help","sidebarTitle":"Get Help","icon":"headset","href":"/core/get-started/customer-support"},{"title":"Send Us a HAR File","sidebarTitle":"HAR Files","icon":"network-wired","href":"/core/get-started/har-file"}]},{"group":"Legacy Features","pages":[{"group":"Getting Started with Context","icon":"book","pages":[{"title":"Context Scoping","icon":"layer-group","href":"/core/archived-ontology/context-library/context-scoping"},{"title":"Dynamic Context Loading","icon":"bolt","href":"/core/archived-ontology/context-library/github-dynamic-loading"},{"title":"GitHub Integration for Context","icon":"github","href":"/core/archived-ontology/context-library/github-integration"},{"title":"Using the Context Editor","icon":"pen-to-square","href":"/core/archived-ontology/context-library/context-editor"},{"title":"Version-Controlled Context Writing","icon":"code-branch","href":"/core/archived-ontology/context-library/github-version-control"},{"title":"What is Context?","icon":"book-open","href":"/core/archived-ontology/context-library/what-is-context"}]},{"group":"Getting Started with Ontology","icon":"sitemap","pages":[{"title":"What is Ontology?","icon":"book-open","href":"/core/archived-ontology/ontology-guide/what-is-ontology"},{"title":"Building Your First Ontology","icon":"hammer","href":"/core/archived-ontology/ontology-guide/building-your-first-ontology"},{"title":"Core Concepts Explained","icon":"cubes","href":"/core/archived-ontology/ontology-guide/core-concepts"},{"title":"Quick Start Ontology","icon":"bolt","href":"/core/archived-ontology/ontology-guide/quick-start-ontology"},{"title":"Sample Conglomerate Ontology","icon":"database","href":"/core/archived-ontology/ontology-guide/sample-conglomerate-ontology"},{"title":"Why Use Ontology?","icon":"lightbulb","href":"/core/archived-ontology/ontology-guide/why-use-ontology"}]},{"group":"Ontology","icon":"diagram-project","pages":[{"title":"Ontology Overview","sidebarTitle":"Overview","icon":"chalkboard-user","href":"/core/archived-ontology/ontology-how-it-works/overview"},{"title":"BI Dashboards","icon":"chart-line","href":"/core/archived-ontology/ontology-how-it-works/dashboards"},{"title":"Files and Spreadsheets","icon":"file-csv","href":"/core/archived-ontology/ontology-how-it-works/files"},{"title":"Known Missing Features","icon":"bug","href":"/core/archived-ontology/ontology-how-it-works/missing"},{"title":"Metrics","icon":"ruler","href":"/core/archived-ontology/ontology-how-it-works/metrics"},{"title":"Object Links","icon":"code-branch","href":"/core/archived-ontology/ontology-how-it-works/links"},{"title":"Objects","icon":"cube","href":"/core/archived-ontology/ontology-how-it-works/objects"},{"title":"Queries","icon":"person-circle-question","href":"/core/archived-ontology/ontology-how-it-works/queries"},{"title":"TQL Language Reference","sidebarTitle":"TQL Reference","icon":"code","href":"/core/archived-ontology/ontology-how-it-works/tql-reference"},{"title":"Why Ontology? (Advanced)","icon":"diagram-project","href":"/core/archived-ontology/ontology-how-it-works/why"}]}]}]},{"tab":"Workshops","pages":[{"title":"Workshops","href":"/workshops"}]},{"tab":"v1 API (deprecated)","pages":[{"title":"v1 API (deprecated)","href":"/api-reference/introduction"}]},{"tab":"v2 API","pages":[{"title":"v2 API","href":"/api-reference/v2/introduction"}]},{"tab":"v3 API (SDK)","pages":[{"title":"v3 API (SDK)","href":"/api-reference/sdk/changelog"}]},{"tab":"MCP Reference","pages":[{"title":"MCP Reference","href":"/core/how-it-works/mcp/ana-as-mcp-server"}]},{"tab":"Helm Charts","pages":[{"title":"Helm Charts","href":"/helm-charts/installation"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/product/changelog"}]}]},"basePath":"","title":"Connect Your Data - TextQL Docs","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-NdetNziF.js","DynamicMarkdown-CD8713Yy.js","zoom-image-lightbox-DMoL6lHz.js","lightbox-handle-r17bVUz3.js"]}
