After a knowledge graph has been created, all users who have an account role with the Create knowledge graph permission, and any other users who have been added to the knowledge graph as contributors can edit its configuration. Users who aren’t able to edit a knowledge graph can request access to the knowledge graph.Each knowledge graph is configured in the following tabs, where you can perform corresponding actions:
Crawlers: Add and edit crawlers to ingest data, and monitor the status and run history of all crawlers in this knowledge graph.
Documents: Upload documents to ingest unstructured data.
Projects: Manage the projects that have access to this knowledge graph.
Access: Manage the users who can contribute to this knowledge graph.
To access these tabs:
In the left navigation, click , then Context Engine.
Click the knowledge graph you want to access.
In the top right, click Set up.
You’ll be taken to the Crawlers tab of the selected knowledge graph—from here, you can manage crawlers or select a different tab on the left to edit other aspects of the knowledge graph’s configuration.
Request or grant access to a knowledge graph
If you don’t have an account role with the Create knowledge graph permission, follow these steps to request access to a knowledge graph:
Click the name of the knowledge graph on the Context Engine dashboard.
In the Viewer access only box at the top of the visualization, click Request contributor access. This sends an email to all contributors on the knowledge graph notifying them that you have requested access.
If you’re a contributor on a knowledge graph and you receive an email requesting access to the knowledge graph, follow these steps:
Click the name of the knowledge graph on the Context Engine dashboard.
In the Pending access requests section above the list of users, click Approve or Reject to answer the request.
Crawlers
A crawler is a continuous process that connects, discovers, and maps data structures to populate the knowledge graph and keep it updated. In the Crawlers tab, you can view and manage the crawlers that populate the knowledge graph with data from your warehouse, pipelines, and external sources. You can add any number of crawlers to a knowledge graph. You can also upload documents to crawl unstructured content—for more information, read Documents.Each crawler type populates the knowledge graph with data from a different source, and has its own prerequisites:
Warehouse data crawlers harvest your warehouse and structured sources supported via connectors to populate the graphs. This helps keep an accurate view of the data landscape. To run a Warehouse data crawler, your project must contain a schema that is populated with data.
Pipeline execution crawlers harvest your pipeline executions for your chosen project and environment to build an operational understanding of how data flows through your organization and workflow. To run a Pipeline execution crawler, your project must contain at least one pipeline.
External source crawlers harvest data from external applications to add business objects to your knowledge graph. To run an External source crawler, you need a connection to the source you want to crawl.
Warehouse data crawlers don’t consume credits when they crawl data in your warehouse.
After a Warehouse data crawler completes its first crawl, subsequent crawls of the data you selected in your warehouse only crawl new metadata added since the last crawl, such as new tables or columns.
The Crawlers tab lists all crawlers in the knowledge graph, the source of the data they crawl, the date of their last run, and the status of their last run.
Add a crawler
In the Crawlers tab of a knowledge graph, click Add crawler.
In the Add crawler step:
In Name, enter a name.
In Crawl type, select the crawler type, then follow the steps in the corresponding tab below.
Warehouse data
Pipeline execution
External source
In Project, select a project that is connected to the warehouse you want to harvest data from.
In Environment, select the environment you want to use to harvest data.
Click Next.
In the Select data step, select the data to crawl:
If you’re crawling a Snowflake warehouse, select the database and schemas to crawl.
If you’re crawling a Databricks warehouse, select the catalog and schemas to crawl.
If you’re crawling an Amazon Redshift warehouse, select the schemas to crawl.
If you’re crawling a Google BigQuery warehouse, select the datasets to crawl.
Click Next.
In Project, select the project to crawl.
In Environment, select the environment to crawl.
Click Next.
In Project, select a project that has access to the external source you want to crawl.
In Environment, select an environment that has access to the external source you want to crawl.
In Select source, search for and click the source you want to crawl.
In the Connection drop-down, select the connection to use to access the source.
Click Next.
In the Select data step, select the objects you want to crawl.
Click Next.
In the Schedule crawl step, choose how often this crawl should run. The crawl will run immediately after you create this knowledge graph, then follow this schedule.
Select Standard or Advanced schedule settings.
In Timezone, select the timezone for the crawl schedule.
If you selected Standard settings, use the repeat drop-downs to set how often the crawler runs.
If you selected Advanced settings, enter a cron expression to set how often the crawler runs.
Click Run.
Manage crawlers
To edit, reschedule, or monitor a crawler, in the Crawlers tab of a knowledge graph, click the name of the crawler you want to manage. Each crawler is configured in four tabs on the left, where you can perform the following actions.Click the Set up tab to:
View the crawler’s details (the data it crawls, the user who created it, and the user who last edited it).
Edit the crawler’s configuration: Click Edit and make your changes to its name, project, environment, and/or the data it crawls. Then, click Save.
Delete the crawler: Click Delete. Then, in the confirmation dialog, click Yes, delete.
Click the Schedule tab to:
View and change the crawler’s schedule: Click Edit, make your changes, and then click Save.
Pause a scheduled crawler: Click Pause in the top right. This crawler will not run until you resume it.
Resume a paused crawler: Click Resume in the top right. This crawler will run at its next scheduled time.
Click the Last crawl tab to:
View the status, start and end time, and duration of the crawler’s most recent crawl.
View a detailed crawl log: Click View logs to see a detailed log of the entities that the most recent crawl linked and added to your knowledge graph. You can filter the log to only show warnings and errors.
Click the Crawl history tab to:
View a list of all crawls performed by this crawler, including their status, start and end time, and duration.
View detailed crawl logs: Click View logs for a specific crawl to learn more about the entities that this crawl linked and added to your knowledge graph. You can filter the log to only show warnings and errors.
Crawl statuses
The table below lists the possible crawl statuses you might see in the Crawlers tab or when viewing the Crawl history for a specific crawler.
Status
Explanation
Successful
The crawl was successful. The date of the last crawl is displayed next to the status.
Initializing
The crawl has just started.
Extracting
The crawl is currently in progress.
Pending
The crawler has been scheduled but hasn’t run for the first time yet. The date of the crawler’s next scheduled run is displayed next to this status.
Paused
The crawler is paused.
Failed
The crawl was unsuccessful. The date of the failed crawl is displayed next to this status.
Documents
Uploading files to your knowledge graph lets you give Maia Team additional context from unstructured content, such as runbooks and documentation. You can upload files in the following formats: .pdf, .pptx, .docx, .txt, .csv, .md, .html, .htm, and .json.The Documents tab displays the following information about the files that have been uploaded to the knowledge graph:
Latest run: The status of the last crawl that harvested data from this file. These are the same as the Crawl statuses listed above.
Started: The start date and time of the file’s last run
Runs: The number of times the file has been crawled
To add unstructured content to a knowledge graph:
In the Documents tab of a knowledge graph, click Upload documents in the top right.
Click Browse files and select up to five files to add to this knowledge graph. Each file must be 2 MB or smaller, and in one of the formats listed above.
Click Upload.
This automatically starts a crawl to extract information from the files you have uploaded. Documents are only crawled once because the content doesn’t change once it has been uploaded—if you want to update the unstructured content in your knowledge graph, remove the document and upload a new version.
Manage documents
To view more information and detailed upload logs for a document, in the Documents tab of a knowledge graph, click the name of the document you want to view. The information about each document is split across three tabs on the left:
Set up: Details about the file, its current status, its type, and its last run.
Last upload: Details about the last time the file was uploaded.
Upload history: Details about all uploads of this file.
In the Last upload and Upload history tabs, click View logs to learn more about the entities that were added to your knowledge graph when the document was uploaded and crawled. You can filter the log to only show warnings and errors.
Document statuses
The table below lists the possible document statuses you might see in the Documents tab or when viewing the Upload history for a specific file.
Status
Explanation
Not ingested
The data in the file has not been harvested.
Ingested
The data in the file has been harvested and added to the knowledge graph.
Projects
The Projects tab shows whether the knowledge graph is restricted, or available to all projects. If the knowledge graph is restricted, this tab lists the projects that can use this knowledge graph.If the knowledge graph is restricted:
To add a project to the allow list, click Add project, select one or more projects, then click Add.
To remove a project from the allow list, click the three dots in the project’s row, then click Yes, remove.
To make the knowledge graph available to all projects, click Restricted in the top right, then click Yes, allow all projects.
Making a restricted knowledge graph available to all projects may expose sensitive or restricted data to unintended users. Make sure your knowledge graph doesn’t contain any sensitive or restricted data before making it available to all projects.
If the knowledge graph is available to all projects:
To restrict access to the knowledge graph, click Restrict access. You will then need to add projects to the allow list as described above.
Access
The Access tab lists the users who can contribute to this knowledge graph. By default, the user who added a knowledge graph and all users with an account role with the Create knowledge graph permission can contribute to knowledge graphs.Users added to a knowledge graph can perform all available actions on the knowledge graph and its crawlers.To add a contributor to a knowledge graph, click Add contributor, search for and select one or more users, then click Add.To remove a contributor from a knowledge graph, click the trash can icon in their row. This immediately removes the contributor.
Delete a knowledge graph
To delete a knowledge graph:
Click the name of the knowledge graph on the Context Engine dashboard.
Click Delete graph in the top right.
In the confirmation dialog, click Yes, delete.
Deleted knowledge graphs cannot be recovered. This action will permanently delete the knowledge graph, including all its crawlers, schedules, and run history.
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Maia Documentation","colors":{"primary":"#001f1d","light":"#20514e","dark":"#001f1d"},"logo":{"light":"https://mintcdn.com/matillion/GyuNBHAx-GXnVlKX/images/maia-by-matillion-light.svg?fit=max\u0026auto=format\u0026n=GyuNBHAx-GXnVlKX\u0026q=85\u0026s=2c48b854f858c5a835450b3f34360db7","dark":"https://mintcdn.com/matillion/GyuNBHAx-GXnVlKX/images/maia-by-matillion-dark.svg?fit=max\u0026auto=format\u0026n=GyuNBHAx-GXnVlKX\u0026q=85\u0026s=88f8d1e1b1931cefd35c233a56cafe0a","href":"https://docs.maia.ai/"},"favicon":{"light":"https://mintcdn.com/matillion/0xM0A92Owv1nZXX1/images/maia-favicon-dark-green.png?fit=max\u0026auto=format\u0026n=0xM0A92Owv1nZXX1\u0026q=85\u0026s=356295fc83c5c6d1ed4aac2573ae45b1","dark":"https://mintcdn.com/matillion/0xM0A92Owv1nZXX1/images/maia-favicon-white.png?fit=max\u0026auto=format\u0026n=0xM0A92Owv1nZXX1\u0026q=85\u0026s=8709fc6d370155352cb6a4b5bbdd59d6"},"appearance":{"default":"light","strict":true},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://support.matillion.com/s/","label":"Support"}],"primary":{"type":"button","label":"Book your Maia demo","href":"https://www.maia.ai/book-a-demo"}},"footer":{"socials":{"x":"https://x.com/matillion","facebook":"https://www.facebook.com/matillion","youtube":"https://www.youtube.com/user/MatillionVideos","linkedin":"https://www.linkedin.com/company/matillion-limited","instagram":"https://www.instagram.com/matillion_"},"links":[{"header":"Maia","items":[{"label":"Maia.ai","href":"https://maia.ai"},{"label":"Academy","href":"https://academy.matillion.com"},{"label":"Exchange","href":"https://exchange.matillion.com/"},{"label":"Roadmap","href":"https://roadmap.matillion.com/"},{"label":"Support","href":"https://support.matillion.com/s"},{"label":"YouTube","href":"https://www.youtube.com/@Matillion"}]},{"header":"Matillion","items":[{"label":"Matillion.com","href":"https://matillion.com"},{"label":"Status","href":"https://status.matillion.com/"},{"label":"News","href":"https://www.matillion.com/news"},{"label":"Legal","href":"https://www.matillion.com/legal"},{"label":"Trust Center","href":"https://www.matillion.com/trust-center"}]}]},"seo":{"metatags":{"google-site-verification":"0VLXGRESICGHnU66TdhEgUMBRRubPnW8JTkzOpiiNn0"}},"fonts":{"heading":{"family":"Inter, system-ui"},"body":{"family":"Inter, system-ui"}},"integrations":{"ga4":{"measurementId":"G-6T2W93NTXW"},"posthog":{"apiKey":"phc_ky6YtuQApuXUkdApnVTY5PrjvnHx7EQGtYyRVSd9G535","apiHost":"https://us.i.posthog.com"}},"contextual":{"options":["claude","chatgpt","perplexity","copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"matillion","hasAudioNarration":false,"actualSubdomain":"matillion","customDomains":["docs.maia.ai"],"gitSource":{"type":"github","owner":"matillion","repo":"maia-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b005d05baa97067db113c3c","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Components","count":357},{"language":"default","tag":"Guides","count":216},{"language":"default","tag":"Connectors","count":188},{"language":"default","tag":"API Reference","count":131},{"language":"default","tag":"Endpoints","count":116},{"language":"default","tag":"Orchestration","count":94},{"language":"default","tag":"Admin","count":70},{"language":"default","tag":"Transformation","count":70},{"language":"default","tag":"Runners","count":51},{"language":"default","tag":"AI","count":42}],"searchSettings":{"showContentSnippets":false}},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"#navbar .bg-background-light,#navbar .bg-background-dark{background-color:#001f1d!important}#navbar a,#navbar button,#navbar span,#navbar p{color:white!important}#navbar svg{color:white!important;stroke:white!important}#navbar #topbar-cta-button a,#navbar #topbar-cta-button a span,#navbar #topbar-cta-button svg{color:#001f1d!important}#navbar #topbar-cta-button a{font-weight:600!important}:root:not(.dark) #search-bar-entry,:root:not(.dark) #nav-anchor,:root:not(.dark) #navbar .navbar-link,:root:not(.dark) .nav-anchor{background-color:#0a3d39!important;border-radius:9999px!important}#topbar-cta-button a span.bg-primary-dark{background:#ffc700!important;border-radius:9999px!important}#navbar svg.bg-gray-500{background-color:white!important}#navbar button.lg\\:hidden div.font-semibold{color:white!important}#navbar button.lg\\:hidden div.text-gray-500 svg{color:white!important;stroke:white!important}#navbar img.nav-logo{content:url('/images/maia-by-matillion-light.svg');height:50px!important;width:auto!important}#footer img.nav-logo{content:url('/images/maia-by-matillion-dark.svg');height:80px!important;width:auto!important}#pagination{display:none}#navigation-items>div{padding-bottom:4rem!important}#navbar a[data-active=\"true\"] div.h-px{height:4px!important;background-color:#ffc700!important;border-radius:9999px!important}[id^=\"headlessui-dialog-panel\"] .navbar-link a{color:white!important}[id^=\"headlessui-dialog-panel\"] nav{padding-top:2.5rem}.accordion{width:100%!important;overflow-x:auto!important}.accordion>div{padding-left:1.375rem!important;padding-right:0!important}.accordion>div[class*=\"overflow\"],.accordion>div>div[class*=\"overflow\"]{overflow:visible!important}@media (min-width: 1920px){body:has(#navbar.is-not-custom) #body-content{max-width:2000px!important}body:has(#navbar.is-not-custom) #content-container{max-width:1650px!important}body:has(#navbar.is-not-custom) #navbar .max-w-8xl{max-width:2000px!important}}body:has(#navbar.is-not-custom) #content{zoom:var(--maia-content-zoom, 100%)}body:has(#navbar.is-not-custom) #content-area>#content+div:has(>p+a){zoom:var(--maia-content-zoom, 100%)}#content-area>#content+div:has(>p+a)>p{font-size:1.5rem;line-height:2rem;font-weight:600;letter-spacing:normal;color:#101828;margin-bottom:0.5rem}.dark #content-area>#content+div:has(>p+a)>p{color:inherit}#content-area>#content+div:has(>p+a)>a{font-size:1rem;line-height:1.75rem}"},{"filePath":"new-features-blog/new-features-blog.css","content":".fos-background-container{position:fixed;top:0;left:0;height:100vh;width:100vw;background:#fff3d1;z-index:-1;background-size:cover}.fos-post-page-container{background-color:#fff;border-radius:20px;padding:20px!important}.fos-roadmap-page-container{background-color:#fff;border-radius:20px;width:95%}@media (min-width: 1024px){.fos-roadmap-page-container{width:70%;margin:0 auto}}.fos-changelog-page-container{background-color:#fff;border-radius:20px}.banner-title,.fos-header-banner-title{color:#00524E;font-size:4rem;font-weight:700;font-family:'Inter', sans-serif}.banner-subtitle,.fos-header-banner-subtitle{color:#001F1D;font-size:1.1487em;margin-top:0.5em;margin-bottom:2em}.fos-header-boards-trigger,.fos-header-roadmap-trigger,.fos-header-changelog-trigger{display:none}.fos-user-side-header{color:white;font-family:'Inter', sans-serif}.fos-header-container{background-color:#001f1d;box-shadow:0px 1px 13px #bfbfbf}.fos-header-boards-dropdown-content span{color:white}.fos-header-links-container{justify-content:center;gap:1em}.fos-header-link{color:white;font-size:14px!important;font-weight:bold;padding:10px 0}.fos-header-logo-container{display:flex}.fos-header-logo-image{width:100px}.fos-header-boards-link{color:white;font-size:16px;padding:10px 0;font-weight:bold}.fos-header-link-icon{color:white}"}]}
{"page":{"pagePath":"docs/guides/managing-knowledge-graphs","slug":"/docs/guides/managing-knowledge-graphs","pageMetadata":{"title":"Managing knowledge graphs","description":null,"href":"/docs/guides/managing-knowledge-graphs"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const admin=`Admin`;const super_admin=`Super Admin`;const AIAgents=()=>_jsxs(_Fragment,{children:[`the `,_jsx(`strong`,{children:`AI Agents`}),` icon `,_jsx(`span`,{style:{whiteSpace:`nowrap`},children:_jsx(`img`,{src:`/images/global-nav/ai-agents.png`,width:`20`,height:`20`,style:{verticalAlign:`text-bottom`,display:`inline`,margin:`0 1px`}})})]});const mission_control=`Mission Control`;const maia_team=`Maia Team`;const context_engine=`Context Engine`;const maia=`Maia`;function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,Tab,Table,Tabs,Warning,_MdxComponentBoundary}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`After a knowledge graph has been created, all users who have an `,_jsx(_components.a,{href:`/docs/administration/account-roles`,children:`account role`}),` with the `,_jsx(_components.strong,{children:`Create knowledge graph`}),` permission, and any other users who have been added to the knowledge graph as contributors can edit its configuration. Users who aren’t able to edit a knowledge graph can `,_jsx(_components.a,{href:`#request-or-grant-access-to-a-knowledge-graph`,children:`request access`}),` to the knowledge graph.`]}),`\n`,_jsx(_components.p,{children:`Each knowledge graph is configured in the following tabs, where you can perform corresponding actions:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`#crawlers`,children:`Crawlers`}),`:`]}),` Add and edit crawlers to ingest data, and monitor the status and run history of all crawlers in this knowledge graph.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`#documents`,children:`Documents`}),`:`]}),` Upload documents to ingest unstructured data.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`#projects`,children:`Projects`}),`:`]}),` Manage the projects that have access to this knowledge graph.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.a,{href:`#access`,children:`Access`}),`:`]}),` Manage the users who can contribute to this knowledge graph.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`To access these tabs:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In the left navigation, click `,_jsx(_MdxComponentBoundary,{name:`AIAgents`,children:_jsx(AIAgents,{})}),`, then `,_jsx(_components.strong,{children:context_engine}),`.`]}),`\n`,_jsx(_components.li,{children:`Click the knowledge graph you want to access.`}),`\n`,_jsxs(_components.li,{children:[`In the top right, click `,_jsx(_components.strong,{children:`Set up`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`You’ll be taken to the `,_jsx(_components.strong,{children:`Crawlers`}),` tab of the selected knowledge graph—from here, you can manage crawlers or select a different tab on the left to edit other aspects of the knowledge graph’s configuration.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`request-or-grant-access-to-a-knowledge-graph`,children:`Request or grant access to a knowledge graph`}),`\n`,_jsxs(_components.p,{children:[`If you don’t have an account role with the `,_jsx(_components.strong,{children:`Create knowledge graph`}),` permission, follow these steps to request access to a knowledge graph:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Click the name of the knowledge graph on the `,context_engine,` dashboard.`]}),`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Viewer access only`}),` box at the top of the visualization, click `,_jsx(_components.strong,{children:`Request contributor access`}),`. This sends an email to all contributors on the knowledge graph notifying them that you have requested access.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`If you’re a contributor on a knowledge graph and you receive an email requesting access to the knowledge graph, follow these steps:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Click the name of the knowledge graph on the `,context_engine,` dashboard.`]}),`\n`,_jsxs(_components.li,{children:[`Click the `,_jsx(_components.a,{href:`#access`,children:`Access`}),` tab on the left.`]}),`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Pending access requests`}),` section above the list of users, click `,_jsx(_components.strong,{children:`Approve`}),` or `,_jsx(_components.strong,{children:`Reject`}),` to answer the request.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`crawlers`,children:`Crawlers`}),`\n`,_jsxs(_components.p,{children:[`A crawler is a continuous process that connects, discovers, and maps data structures to populate the knowledge graph and keep it updated. In the `,_jsx(_components.strong,{children:`Crawlers`}),` tab, you can view and manage the crawlers that populate the knowledge graph with data from your warehouse, pipelines, and external sources. You can add any number of crawlers to a knowledge graph. You can also upload documents to crawl unstructured content—for more information, read `,_jsx(_components.a,{href:`#documents`,children:`Documents`}),`.`]}),`\n`,_jsx(_components.p,{children:`Each crawler type populates the knowledge graph with data from a different source, and has its own prerequisites:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Warehouse data`}),` crawlers harvest your warehouse and structured sources supported via connectors to populate the graphs. This helps keep an accurate view of the data landscape. To run a `,_jsx(_components.strong,{children:`Warehouse data`}),` crawler, your project must contain a schema that is populated with data.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pipeline execution`}),` crawlers harvest your pipeline executions for your chosen project and environment to build an operational understanding of how data flows through your organization and workflow. To run a `,_jsx(_components.strong,{children:`Pipeline execution`}),` crawler, your project must contain at least one pipeline.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`External source`}),` crawlers harvest data from external applications to add business objects to your knowledge graph. To run an `,_jsx(_components.strong,{children:`External source`}),` crawler, you need a `,_jsx(_components.a,{href:`/docs/guides/connections`,children:`connection`}),` to the source you want to crawl.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Warehouse data`}),` crawlers don’t consume credits when they crawl data in your warehouse.`]}),`\n`,_jsxs(_components.li,{children:[`After a `,_jsx(_components.strong,{children:`Warehouse data`}),` crawler completes its first crawl, subsequent crawls of the data you selected in your warehouse only crawl new metadata added since the last crawl, such as new tables or columns.`]}),`\n`]})}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Crawlers`}),` tab lists all crawlers in the knowledge graph, the source of the data they crawl, the date of their last run, and the `,_jsx(_components.a,{href:`#crawl-statuses`,children:`status`}),` of their last run.`]}),`\n`,_jsx(Heading,{level:`3`,id:`add-a-crawler`,children:`Add a crawler`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Crawlers`}),` tab of a knowledge graph, click `,_jsx(_components.strong,{children:`Add crawler`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Add crawler`}),` step:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Name`}),`, enter a name.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Crawl type`}),`, select the crawler type, then follow the steps in the corresponding tab below.`]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Warehouse data`,id:`warehouse-data`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Project`}),`, select a project that is connected to the warehouse you want to harvest data from.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Environment`}),`, select the environment you want to use to harvest data.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Next`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Select data`}),` step, select the data to crawl:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`If you’re crawling a Snowflake warehouse, select the database and schemas to crawl.`}),`\n`,_jsx(_components.li,{children:`If you’re crawling a Databricks warehouse, select the catalog and schemas to crawl.`}),`\n`,_jsx(_components.li,{children:`If you’re crawling an Amazon Redshift warehouse, select the schemas to crawl.`}),`\n`,_jsx(_components.li,{children:`If you’re crawling a Google BigQuery warehouse, select the datasets to crawl.`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Next`}),`.`]}),`\n`]})}),_jsx(Tab,{title:`Pipeline execution`,id:`pipeline-execution`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Project`}),`, select the project to crawl.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Environment`}),`, select the environment to crawl.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Next`}),`.`]}),`\n`]})}),_jsx(Tab,{title:`External source`,id:`external-source`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Project`}),`, select a project that has access to the external source you want to crawl.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Environment`}),`, select an environment that has access to the external source you want to crawl.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Select source`}),`, search for and click the source you want to crawl.`]}),`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Connection`}),` drop-down, select the connection to use to access the source.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Next`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Select data`}),` step, select the objects you want to crawl.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Next`}),`.`]}),`\n`]})})]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Schedule crawl`}),` step, choose how often this crawl should run. The crawl will run immediately after you create this knowledge graph, then follow this schedule.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`Standard`}),` or `,_jsx(_components.strong,{children:`Advanced`}),` schedule settings.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`Timezone`}),`, select the timezone for the crawl schedule.`]}),`\n`,_jsxs(_components.li,{children:[`If you selected `,_jsx(_components.strong,{children:`Standard`}),` settings, use the repeat drop-downs to set how often the crawler runs.`]}),`\n`,_jsxs(_components.li,{children:[`If you selected `,_jsx(_components.strong,{children:`Advanced`}),` settings, enter a cron expression to set how often the crawler runs.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Run`}),`.`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`manage-crawlers`,children:`Manage crawlers`}),`\n`,_jsxs(_components.p,{children:[`To edit, reschedule, or monitor a crawler, in the `,_jsx(_components.strong,{children:`Crawlers`}),` tab of a knowledge graph, click the name of the crawler you want to manage. Each crawler is configured in four tabs on the left, where you can perform the following actions.`]}),`\n`,_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Set up`}),` tab to:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View the crawler’s details`}),` (the data it crawls, the user who created it, and the user who last edited it).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Edit the crawler’s configuration:`}),` Click `,_jsx(_components.strong,{children:`Edit`}),` and make your changes to its name, project, environment, and/or the data it crawls. Then, click `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Delete the crawler:`}),` Click `,_jsx(_components.strong,{children:`Delete`}),`. Then, in the confirmation dialog, click `,_jsx(_components.strong,{children:`Yes, delete`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Schedule`}),` tab to:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View and change the crawler’s schedule:`}),` Click `,_jsx(_components.strong,{children:`Edit`}),`, make your changes, and then click `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pause a scheduled crawler:`}),` Click `,_jsx(_components.strong,{children:`Pause`}),` in the top right. This crawler will not run until you resume it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Resume a paused crawler:`}),` Click `,_jsx(_components.strong,{children:`Resume`}),` in the top right. This crawler will run at its next scheduled time.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Last crawl`}),` tab to:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`View the status, start and end time, and duration of the crawler’s most recent crawl.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View a detailed crawl log:`}),` Click `,_jsx(_components.strong,{children:`View logs`}),` to see a detailed log of the entities that the most recent crawl linked and added to your knowledge graph. You can filter the log to only show warnings and errors.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Crawl history`}),` tab to:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`View a list of all crawls performed by this crawler, including their status, start and end time, and duration.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View detailed crawl logs:`}),` Click `,_jsx(_components.strong,{children:`View logs`}),` for a specific crawl to learn more about the entities that this crawl linked and added to your knowledge graph. You can filter the log to only show warnings and errors.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`crawl-statuses`,children:`Crawl statuses`}),`\n`,_jsxs(_components.p,{children:[`The table below lists the possible crawl statuses you might see in the `,_jsx(_components.strong,{children:`Crawlers`}),` tab or when viewing the `,_jsx(_components.strong,{children:`Crawl history`}),` for a specific crawler.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Explanation`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Successful`}),_jsx(_components.td,{children:`The crawl was successful. The date of the last crawl is displayed next to the status.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Initializing`}),_jsx(_components.td,{children:`The crawl has just started.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Extracting`}),_jsx(_components.td,{children:`The crawl is currently in progress.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Pending`}),_jsx(_components.td,{children:`The crawler has been scheduled but hasn’t run for the first time yet. The date of the crawler’s next scheduled run is displayed next to this status.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Paused`}),_jsx(_components.td,{children:`The crawler is paused.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Failed`}),_jsx(_components.td,{children:`The crawl was unsuccessful. The date of the failed crawl is displayed next to this status.`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`documents`,children:`Documents`}),`\n`,_jsxs(_components.p,{children:[`Uploading files to your knowledge graph lets you give `,maia_team,` additional context from unstructured content, such as runbooks and documentation. You can upload files in the following formats: `,_jsx(_components.code,{children:`.pdf`}),`, `,_jsx(_components.code,{children:`.pptx`}),`, `,_jsx(_components.code,{children:`.docx`}),`, `,_jsx(_components.code,{children:`.txt`}),`, `,_jsx(_components.code,{children:`.csv`}),`, `,_jsx(_components.code,{children:`.md`}),`, `,_jsx(_components.code,{children:`.html`}),`, `,_jsx(_components.code,{children:`.htm`}),`, and `,_jsx(_components.code,{children:`.json`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Documents`}),` tab displays the following information about the files that have been uploaded to the knowledge graph:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`File name:`}),` The name of the uploaded file`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Document state:`}),` The `,_jsx(_components.a,{href:`#document-statuses`,children:`status`}),` of the file.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Latest run:`}),` The status of the last crawl that harvested data from this file. These are the same as the `,_jsx(_components.a,{href:`#crawl-statuses`,children:`Crawl statuses`}),` listed above.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Started:`}),` The start date and time of the file’s last run`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Runs:`}),` The number of times the file has been crawled`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`To add unstructured content to a knowledge graph:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Documents`}),` tab of a knowledge graph, click `,_jsx(_components.strong,{children:`Upload documents`}),` in the top right.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Browse files`}),` and select up to five files to add to this knowledge graph. Each file must be 2 MB or smaller, and in one of the formats listed above.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Upload`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`This automatically starts a crawl to extract information from the files you have uploaded. Documents are only crawled once because the content doesn’t change once it has been uploaded—if you want to update the unstructured content in your knowledge graph, remove the document and upload a new version.`}),`\n`,_jsx(Heading,{level:`3`,id:`manage-documents`,children:`Manage documents`}),`\n`,_jsxs(_components.p,{children:[`To view more information and detailed upload logs for a document, in the `,_jsx(_components.strong,{children:`Documents`}),` tab of a knowledge graph, click the name of the document you want to view. The information about each document is split across three tabs on the left:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Set up:`}),` Details about the file, its current status, its type, and its last run.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Last upload:`}),` Details about the last time the file was uploaded.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Upload history:`}),` Details about all uploads of this file.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Last upload`}),` and `,_jsx(_components.strong,{children:`Upload history`}),` tabs, click `,_jsx(_components.strong,{children:`View logs`}),` to learn more about the entities that were added to your knowledge graph when the document was uploaded and crawled. You can filter the log to only show warnings and errors.`]}),`\n`,_jsx(Heading,{level:`2`,id:`document-statuses`,children:`Document statuses`}),`\n`,_jsxs(_components.p,{children:[`The table below lists the possible document statuses you might see in the `,_jsx(_components.strong,{children:`Documents`}),` tab or when viewing the `,_jsx(_components.strong,{children:`Upload history`}),` for a specific file.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Explanation`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Not ingested`}),_jsx(_components.td,{children:`The data in the file has not been harvested.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Ingested`}),_jsx(_components.td,{children:`The data in the file has been harvested and added to the knowledge graph.`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`projects`,children:`Projects`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Projects`}),` tab shows whether the knowledge graph is restricted, or available to all projects. If the knowledge graph is restricted, this tab lists the projects that can use this knowledge graph.`]}),`\n`,_jsx(_components.p,{children:`If the knowledge graph is restricted:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`To add a project to the allow list, click `,_jsx(_components.strong,{children:`Add project`}),`, select one or more projects, then click `,_jsx(_components.strong,{children:`Add`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`To remove a project from the allow list, click the three dots in the project’s row, then click `,_jsx(_components.strong,{children:`Yes, remove`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`To make the knowledge graph available to all projects, click `,_jsx(_components.strong,{children:`Restricted`}),` in the top right, then click `,_jsx(_components.strong,{children:`Yes, allow all projects`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Making a restricted knowledge graph available to all projects may expose sensitive or restricted data to unintended users. Make sure your knowledge graph doesn’t contain any sensitive or restricted data before making it available to all projects.`})}),`\n`,_jsx(_components.p,{children:`If the knowledge graph is available to all projects:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`To restrict access to the knowledge graph, click `,_jsx(_components.strong,{children:`Restrict access`}),`. You will then need to add projects to the allow list as described above.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`access`,children:`Access`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Access`}),` tab lists the users who can contribute to this knowledge graph. By default, the user who added a knowledge graph and all users with an account role with the `,_jsx(_components.strong,{children:`Create knowledge graph`}),` permission can contribute to knowledge graphs.`]}),`\n`,_jsx(_components.p,{children:`Users added to a knowledge graph can perform all available actions on the knowledge graph and its crawlers.`}),`\n`,_jsxs(_components.p,{children:[`To add a contributor to a knowledge graph, click `,_jsx(_components.strong,{children:`Add contributor`}),`, search for and select one or more users, then click `,_jsx(_components.strong,{children:`Add`}),`.`]}),`\n`,_jsx(_components.p,{children:`To remove a contributor from a knowledge graph, click the trash can icon in their row. This immediately removes the contributor.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`delete-a-knowledge-graph`,children:`Delete a knowledge graph`}),`\n`,_jsx(_components.p,{children:`To delete a knowledge graph:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Click the name of the knowledge graph on the `,context_engine,` dashboard.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Delete graph`}),` in the top right.`]}),`\n`,_jsxs(_components.li,{children:[`In the confirmation dialog, click `,_jsx(_components.strong,{children:`Yes, delete`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Deleted knowledge graphs cannot be recovered. This action will permanently delete the knowledge graph, including all its crawlers, schedules, and run history.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{admin,super_admin,AIAgents,mission_control,maia_team,context_engine,maia,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":"Managing knowledge graphs","description":null,"href":"/docs/guides/managing-knowledge-graphs"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[134,489,"AIAgents=()=>null;const admin=`Admin`;const super_admin=`Super Admin`;const miss"],[3169,3187,"`Context Engine`}),`"],[4187,4205,"`Context Engine`,` d"],[4847,4865,"`Context Engine`,` d"],[18334,18352,"`Maia Team`,` additi"],[26337,26355,"`Context Engine`,` d"],[27071,27111,"AIAgents,admin,super_admin,mission_contr"]]},"mdxExtracts":{"tableOfContents":[{"title":"Request or grant access to a knowledge graph","slug":"request-or-grant-access-to-a-knowledge-graph","depth":2,"children":[]},{"title":"Crawlers","slug":"crawlers","depth":2,"children":[{"title":"Add a crawler","slug":"add-a-crawler","depth":3,"children":[]},{"title":"Manage crawlers","slug":"manage-crawlers","depth":3,"children":[]},{"title":"Crawl statuses","slug":"crawl-statuses","depth":3,"children":[]}]},{"title":"Documents","slug":"documents","depth":2,"children":[{"title":"Manage documents","slug":"manage-documents","depth":3,"children":[]}]},{"title":"Document statuses","slug":"document-statuses","depth":2,"children":[]},{"title":"Projects","slug":"projects","depth":2,"children":[]},{"title":"Access","slug":"access","depth":2,"children":[]},{"title":"Delete a knowledge graph","slug":"delete-a-knowledge-graph","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/matillion/1eecfe13cb8a36b9/scripts/feedback-widget.js","/_mintlify/custom/matillion/b8b092d8d394af0f/scripts/ga4-events.js","/_mintlify/custom/matillion/5baf5b38fe34f41f/scripts/iubenda.js","/_mintlify/custom/matillion/573540f1e9142d9c/scripts/kapa-widget.js","/_mintlify/custom/matillion/a52101786f42c23b/scripts/ph-pageleaves.js","/_mintlify/custom/matillion/b8f0431aaf9ef855/scripts/cookie-preferences-button.js","/_mintlify/custom/matillion/a3d31738f4c89949/scripts/status-badge-nav.js","/_mintlify/custom/matillion/b444958fcc79163d/scripts/text-size-slider.js","/_mintlify/custom/matillion/f7016c1e98f77080/scripts/posthog-events.js"],"subdomain":"matillion","siteName":"Maia Documentation","title":"Managing knowledge graphs - Maia Documentation","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"manual"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T17:06:07.041Z","originalFileLocation":"docs/guides/managing-knowledge-graphs.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"application-name\" content=\"Maia Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Managing knowledge graphs - Maia Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Maia Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://matillion.mintlify.site/_mintlify/api/og/v2?division=Context+Engine\u0026amp;title=Managing+knowledge+graphs\u0026amp;theme=ce57a3e3dfd574362d42229a\u0026amp;signature=c20e76b83f2d620768ff3a28a9a46f144220c44a1ac7892d137bd6432c9329a3\">\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=\"Managing knowledge graphs - Maia Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://matillion.mintlify.site/_mintlify/api/og/v2?division=Context+Engine\u0026amp;title=Managing+knowledge+graphs\u0026amp;theme=ce57a3e3dfd574362d42229a\u0026amp;signature=c20e76b83f2d620768ff3a28a9a46f144220c44a1ac7892d137bd6432c9329a3\">\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/matillion/eb7R3mt9l7P1vThW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Maia Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#001f1d\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"0VLXGRESICGHnU66TdhEgUMBRRubPnW8JTkzOpiiNn0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/guides/managing-knowledge-graphs.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.maia.ai/#organization\",\"name\":\"Maia Documentation\",\"url\":\"https://docs.maia.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/matillion/GyuNBHAx-GXnVlKX/images/maia-by-matillion-light.svg?fit=max\u0026auto=format\u0026n=GyuNBHAx-GXnVlKX\u0026q=85\u0026s=2c48b854f858c5a835450b3f34360db7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.maia.ai#website\",\"name\":\"Maia Documentation\",\"url\":\"https://docs.maia.ai\",\"publisher\":{\"@id\":\"https://docs.maia.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs#webpage\",\"url\":\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs\",\"name\":\"Managing knowledge graphs\",\"dateModified\":\"2026-11-17T17:06:07.041Z\",\"isPartOf\":{\"@id\":\"https://docs.maia.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Context Engine\",\"item\":\"https://docs.maia.ai/docs/guides/context-engine-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Managing knowledge graphs\",\"item\":\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs#article\",\"headline\":\"Managing knowledge graphs\",\"name\":\"Managing knowledge graphs\",\"url\":\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs\",\"mainEntityOfPage\":{\"@id\":\"https://docs.maia.ai/docs/guides/managing-knowledge-graphs#webpage\"},\"dateModified\":\"2026-11-17T17:06:07.041Z\",\"publisher\":{\"@id\":\"https://docs.maia.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.maia.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Maia Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Maia Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/guides/managing-knowledge-graphs.md","siteName":"Maia Documentation","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Admin","pages":[{"title":"Admin","href":"/docs/administration/administration-overview"}]},{"tab":"Components","pages":[{"title":"Components","href":"/docs/components/components-overview"}]},{"tab":"Guides","pages":[{"group":"Platform overview","root":{"title":"Maia product overview","href":"/docs/guides/maia-overview"},"pages":[{"title":"Maia product overview","href":"/docs/guides/maia-overview"},{"title":"Maia product architecture","href":"/docs/guides/architecture-overview"},{"title":"Full SaaS vs Hybrid SaaS","href":"/docs/guides/full-saas-vs-hybrid-saas"},{"title":"Data Pipeline Language (DPL)","href":"/docs/guides/data-pipeline-language"},{"title":"Maia glossary","href":"/docs/guides/glossary"},{"title":"Supported browsers","href":"/docs/guides/supported-browsers"},{"title":"Maia product release FAQ","href":"/docs/guides/release-faq"},{"title":"Migrating from Matillion ETL to Maia","href":"/docs/guides/migrating-from-matillion-etl"}]},{"group":"Setup","root":{"title":"Setup overview","href":"/docs/guides/setup-overview"},"pages":[{"title":"Setup overview","href":"/docs/guides/setup-overview"},{"title":"Services","href":"/docs/guides/services"},{"group":"Full SaaS","pages":[{"title":"Setup guide - Matillion Full SaaS Snowflake","href":"/docs/guides/full-saas-snowflake"},{"title":"Setup guide - Matillion Full SaaS Amazon Redshift","href":"/docs/guides/full-saas-redshift"},{"title":"Setup guide - Matillion Full SaaS Databricks","href":"/docs/guides/full-saas-databricks"},{"title":"Setup guide - Matillion Full SaaS Google BigQuery","href":"/docs/guides/full-saas-bigquery"}]},{"group":"Hybrid SaaS","pages":[{"title":"Setup guide - Hybrid SaaS Snowflake on AWS","href":"/docs/guides/hybrid-saas-snowflake-aws"},{"title":"Setup guide - Hybrid SaaS Snowflake on Azure","href":"/docs/guides/hybrid-saas-snowflake-azure"},{"title":"Setup guide - Hybrid SaaS Snowflake on Google Cloud","href":"/docs/guides/hybrid-saas-snowflake-gcp"},{"title":"Setup guide - Hybrid SaaS Snowflake on Snowpark","href":"/docs/guides/hybrid-saas-snowflake-snowpark"},{"title":"Setup guide - Hybrid SaaS Amazon Redshift on AWS","href":"/docs/guides/hybrid-saas-redshift-aws"},{"title":"Setup guide - Hybrid SaaS Databricks on AWS","href":"/docs/guides/hybrid-saas-databricks-aws"},{"title":"Setup guide - Hybrid SaaS Databricks on Azure","href":"/docs/guides/hybrid-saas-databricks-azure"},{"title":"Setup guide - Hybrid SaaS Google BigQuery","href":"/docs/guides/hybrid-saas-bigquery"}]}]},{"group":"Getting started","root":{"title":"Maia new user tutorial","href":"/docs/guides/new-user-tutorial"},"pages":[{"title":"Maia new user tutorial","href":"/docs/guides/new-user-tutorial"},{"title":"Project quickstart guide","href":"/docs/guides/project-quickstart-guide"},{"title":"Using Designer","href":"/docs/guides/using-designer"},{"title":"Convert workloads from other platforms","tag":"Preview","href":"/docs/guides/convert-workloads-from-other-platforms"},{"title":"Best practices for converting workloads","href":"/docs/guides/convert-workloads-best-practices"},{"title":"Getting started with loading data","href":"/docs/guides/loading-data-overview"},{"title":"Incremental or high water mark data loading","href":"/docs/guides/incremental-load-example"},{"title":"Post-processing","href":"/docs/guides/post-processing"},{"title":"Sampling component output and metadata","href":"/docs/guides/sampling-output"},{"title":"Validating pipelines","href":"/docs/guides/validating-pipelines"},{"title":"Organizing file storage","href":"/docs/guides/organizing-file-storage"}]},{"group":"Projects","root":{"title":"Projects","href":"/docs/guides/projects"},"pages":[{"title":"Projects","href":"/docs/guides/projects"},{"title":"Branches","href":"/docs/guides/branches"},{"title":"Environments","href":"/docs/guides/environments"},{"title":"Artifacts","href":"/docs/guides/artifacts"},{"title":"Schedules","href":"/docs/guides/schedules"},{"group":"Connections","root":{"title":"Connections","href":"/docs/guides/connections"},"pages":[{"title":"Connections","href":"/docs/guides/connections"},{"title":"Secrets and connections","href":"/docs/guides/secrets-and-connections-overview"},{"title":"Understanding the new connections model","href":"/docs/guides/new-connections-model"},{"title":"Secrets and secret definitions","href":"/docs/guides/secrets-and-secret-definitions"},{"title":"Cloud provider credentials","href":"/docs/guides/cloud-credentials"}]},{"title":"Networks","href":"/docs/guides/networks"},{"title":"Upgrade Assistant","href":"/docs/guides/upgrade-assistant"}]},{"group":"Pipelines","root":{"title":"Pipelines","href":"/docs/guides/pipelines"},"pages":[{"title":"Pipelines","href":"/docs/guides/pipelines"},{"title":"Create and manage pipelines","href":"/docs/guides/create-and-manage-pipelines"},{"title":"Pipeline folders","href":"/docs/guides/pipeline-folders"},{"title":"Import and export pipelines","href":"/docs/guides/import-and-export-pipelines"},{"title":"Pipelines tutorial","href":"/docs/guides/pipelines-tutorial"},{"group":"Variables","pages":[{"title":"Project and pipeline variables","href":"/docs/guides/variables"},{"title":"Grid variables","href":"/docs/guides/grid-variables"},{"title":"System variables","href":"/docs/guides/system-variables"},{"title":"Variable expressions","href":"/docs/guides/variable-expressions"}]},{"title":"Code Editor","href":"/docs/guides/code-editor"},{"title":"Transactions","href":"/docs/guides/transactions"},{"title":"Data masking in transformation pipelines","href":"/docs/guides/data-masking-transformation"},{"title":"Matillion data quality framework","href":"/docs/guides/data-quality-framework"},{"title":"Shared pipelines","href":"/docs/guides/shared-pipelines"},{"title":"Reviewing pipeline quality","tag":"Preview","href":"/docs/guides/pipeline-quality"},{"title":"Tutorial: Triggering a pipeline via SQS","href":"/docs/guides/triggering-a-pipeline-via-sqs"},{"title":"SQS pipeline trigger adapter","href":"/docs/guides/sqs-pipeline-trigger-adapter"},{"title":"Triggering a pipeline via an Azure queue","href":"/docs/guides/triggering-a-pipeline-via-azure-queue"}]},{"group":"Git","root":{"title":"Git overview","href":"/docs/guides/git-introduction"},"pages":[{"title":"Git overview","href":"/docs/guides/git-introduction"},{"group":"Using Git in Designer","root":{"title":"Using Git in Designer","href":"/docs/guides/git-overview"},"pages":[{"title":"Using Git in Designer","href":"/docs/guides/git-overview"},{"title":"Commit changes","href":"/docs/guides/git-commit"},{"title":"Push local changes","href":"/docs/guides/git-push"},{"title":"Pull remote changes","href":"/docs/guides/git-pull"},{"title":"Merge from branch","href":"/docs/guides/git-merge"},{"title":"Compare changes","href":"/docs/guides/git-compare"},{"title":"Reset branch","href":"/docs/guides/git-hard-reset"},{"title":"Revert changes","href":"/docs/guides/git-revert"},{"title":"Pull requests","href":"/docs/guides/git-pull-requests"},{"title":"Troubleshooting Git errors","href":"/docs/guides/troubleshooting-git"}]},{"group":"Connect your own Git repository","root":{"title":"Connect your own Git repo","href":"/docs/guides/installing-git-provider-overview"},"pages":[{"title":"Connect your own Git repo","href":"/docs/guides/installing-git-provider-overview"},{"group":"GitHub","root":{"title":"What is the Maia GitHub app?","href":"/docs/guides/matillion-github-app-overview"},"pages":[{"title":"What is the Maia GitHub app?","href":"/docs/guides/matillion-github-app-overview"},{"title":"Installing the Maia app in GitHub","href":"/docs/guides/installing-matillion-app-github-marketplace"},{"title":"Prerequisites for connecting to a GitHub repository","href":"/docs/guides/connect-github-repository-prerequisites"},{"title":"Troubleshooting GitHub repository errors","href":"/docs/guides/troubleshooting-github-repository-connection"}]},{"group":"GitLab","root":{"title":"What is the Maia GitLab App?","href":"/docs/guides/matillion-gitlab-app-overview"},"pages":[{"title":"What is the Maia GitLab App?","href":"/docs/guides/matillion-gitlab-app-overview"},{"title":"Prerequisites for connecting to a GitLab repository","href":"/docs/guides/connect-gitlab-repository-prerequisites"},{"title":"Troubleshooting GitLab repository errors","href":"/docs/guides/troubleshooting-gitlab-repository-connections"}]},{"group":"Azure DevOps","root":{"title":"Maia Azure DevOps app overview","href":"/docs/guides/matillion-azure-devops-app-overview"},"pages":[{"title":"Maia Azure DevOps app overview","href":"/docs/guides/matillion-azure-devops-app-overview"},{"title":"Installing the Maia app in Azure","href":"/docs/guides/installing-matillion-app-azure-devops"},{"title":"Prerequisites for connecting to an Azure DevOps repository","href":"/docs/guides/connect-azure-devops-repository-prerequisites"},{"title":"Troubleshooting Azure DevOps repository errors","href":"/docs/guides/troubleshooting-azure-devops-repository-connection"}]},{"group":"Bitbucket","root":{"title":"Maia Bitbucket app overview","href":"/docs/guides/matillion-bitbucket-app-overview"},"pages":[{"title":"Maia Bitbucket app overview","href":"/docs/guides/matillion-bitbucket-app-overview"},{"title":"Prerequisites for connecting to a Bitbucket repository","href":"/docs/guides/connect-bitbucket-repository-prerequisites"},{"title":"Troubleshooting Bitbucket repository errors","href":"/docs/guides/troubleshooting-bitbucket-repository-connection"}]}]},{"title":"Reconnecting your Git user account","href":"/docs/guides/reconnecting-git-user-account"}]},{"group":"Custom connectors","root":{"title":"Custom connector overview","href":"/docs/guides/custom-connector-overview"},"pages":[{"title":"Custom connector overview","href":"/docs/guides/custom-connector-overview"},{"title":"Flex connector overview","href":"/docs/guides/flex-connector-introduction"},{"title":"Creating custom connectors","href":"/docs/guides/custom-connector-setup"},{"title":"Custom connector authentication","href":"/docs/guides/custom-connector-authentication"},{"title":"Script paging in custom connectors","href":"/docs/guides/custom-connector-script-paging"}]},{"group":"Runners","root":{"title":"Maia runner overview","href":"/docs/guides/runner-overview"},"pages":[{"title":"Maia runner overview","href":"/docs/guides/runner-overview"},{"title":"Maia runner updates","href":"/docs/guides/runner-updates"},{"title":"Scaling best practices","href":"/docs/guides/scaling-best-practices"},{"group":"Managing runners","root":{"title":"Manage runners","href":"/docs/guides/manage-runners"},"pages":[{"title":"Manage runners","href":"/docs/guides/manage-runners"},{"title":"Create a Maia runner in your infrastructure","href":"/docs/guides/create-a-runner"},{"title":"Pause a Maia runner","href":"/docs/guides/pause-runner"},{"title":"Restart a Maia runner","href":"/docs/guides/restart-runner"},{"title":"Refresh Maia runner credentials","href":"/docs/guides/refresh-credentials"},{"title":"Restrict a Maia runner","href":"/docs/guides/restrict-a-runner"},{"group":"Logging","pages":[{"title":"Maia runner logs","href":"/docs/guides/runner-logs"},{"title":"Enable Maia runner heap dumps","href":"/docs/guides/enable-runner-heap-dumps"},{"title":"Export Maia runner logs","href":"/docs/guides/export-logs-hybrid-saas"}]}]},{"group":"AWS runner","pages":[{"title":"Amazon EKS deployment guide for Maia runners","href":"/docs/guides/eks-deployment-guide"},{"group":"ECS Fargate","pages":[{"title":"Maia runner installation using a CloudFormation quick-create link","href":"/docs/guides/runner-installation-cloudformation-quick-create"},{"title":"AWS Fargate manual setup for Maia runners","href":"/docs/guides/aws-fargate-manual-runner-setup"}]},{"group":"AWS configuration","pages":[{"title":"AWS IAM roles","href":"/docs/guides/aws-iam-roles"},{"title":"AWS IAM permissions for runner deployment","href":"/docs/guides/aws-iam-permissions-for-runner"},{"title":"Add Maia runner credentials to AWS Secrets Manager","href":"/docs/guides/add-runner-credentials-to-aws-secrets-manager"}]}]},{"group":"Azure runner","pages":[{"title":"Azure AKS deployment guide for Maia runners","href":"/docs/guides/aks-deployment-guide"},{"group":"Container Apps","pages":[{"title":"Maia runner installation using an ARM template","href":"/docs/guides/azure-arm-runner-install"},{"title":"ARM template permissions","href":"/docs/guides/arm-template-permissions"},{"title":"Download and amend the Azure ARM template","href":"/docs/guides/amend-azure-arm-template"},{"title":"Configuring an Azure key vault for Maia runners","href":"/docs/guides/azure-arm-runner-key-vault"},{"title":"Azure managed identity","href":"/docs/guides/azure-managed-identity"},{"title":"Sizing Maia runners on Azure Container Apps","href":"/docs/guides/azure-arm-runner-sizing"}]},{"title":"Troubleshooting a Maia runner hosted on Azure","href":"/docs/guides/azure-runner-troubleshooting"}]},{"group":"Google Cloud runner","pages":[{"title":"Google Cloud GKE deployment for Maia runners","href":"/docs/guides/gke-deployment-guide"},{"title":"Google Cloud IAM permissions for runner deployment","href":"/docs/guides/gcp-iam-permissions-for-runner"}]},{"group":"Snowflake runner","pages":[{"title":"Installing a Maia runner for Snowflake","href":"/docs/guides/snowflake-runner-install"},{"title":"Using secrets in a Maia runner for Snowflake","href":"/docs/guides/snowflake-runner-secrets"},{"title":"Troubleshooting a Maia runner for Snowflake","href":"/docs/guides/snowflake-runner-troubleshooting"}]},{"title":"Kubernetes deployment guide for runners","href":"/docs/guides/kubernetes-deployment-guide"},{"title":"Connectivity via AWS PrivateLink","href":"/docs/guides/connecting-via-privatelink"},{"title":"Shared script runner","href":"/docs/guides/shared-script-runner"},{"group":"General configuration","pages":[{"title":"Optional Maia runner parameters","href":"/docs/guides/optional-runner-parameters"},{"title":"Customizing Maia runner networking and connectivity","href":"/docs/guides/customizing-runner-networking-and-connectivity"},{"title":"Installing Python libraries","href":"/docs/guides/installing-python-libraries"},{"title":"Uploading external drivers to a Maia runner","href":"/docs/guides/uploading-external-drivers"}]}]},{"group":"Context Engine","root":{"title":"Context Engine overview","href":"/docs/guides/context-engine-overview"},"pages":[{"title":"Context Engine overview","href":"/docs/guides/context-engine-overview"},{"title":"Creating knowledge graphs","description":null,"href":"/docs/guides/creating-knowledge-graphs"},{"title":"Managing knowledge graphs","href":"/docs/guides/managing-knowledge-graphs"},{"title":"Visualizing knowledge graphs","description":null,"href":"/docs/guides/visualizing-knowledge-graphs"}]},{"group":"Maia Team","root":{"title":"Maia Team overview","href":"/docs/guides/maia-team-overview"},"pages":[{"title":"Maia Team overview","href":"/docs/guides/maia-team-overview"},{"title":"Building pipelines","href":"/docs/guides/maia-pipelines"},{"title":"Chat features","href":"/docs/guides/maia-sessions-and-tools"},{"title":"Context files","href":"/docs/guides/maia-context-files"},{"title":"Create a custom connector with Maia Team","href":"/docs/guides/create-a-custom-connector-with-maia"},{"title":"Mission Control overview","href":"/docs/guides/mission-control"},{"title":"Mission Control integrations","href":"/docs/guides/mission-control-integrations"},{"title":"Tasks in Mission Control","href":"/docs/guides/mission-control-tasks"},{"title":"Pipeline notes","href":"/docs/guides/ai-note"},{"title":"Prompting best practices","href":"/docs/guides/maia-best-practices"},{"title":"Skills","href":"/docs/guides/maia-skills"},{"title":"AI FAQ","href":"/docs/guides/ai-faq"}]},{"group":"Observability","root":{"title":"Observability overview","href":"/docs/guides/observability-overview"},"pages":[{"title":"Observability overview","href":"/docs/guides/observability-overview"},{"title":"Audit service","href":"/docs/guides/audit-service"},{"group":"Lineage","root":{"title":"Lineage","href":"/docs/guides/data-lineage"},"pages":[{"title":"Send lineage to your data catalog","href":"/docs/guides/lineage-integrations"}]},{"group":"Notifications","pages":[{"title":"Pipeline notifications","href":"/docs/guides/pipeline-notifications"},{"title":"Billing notifications","href":"/docs/guides/billing-notifications"}]},{"title":"Lineage","href":"/docs/guides/data-lineage"},{"title":"Pipeline notifications","href":"/docs/guides/pipeline-notifications"},{"group":"Pipeline observability","pages":[{"title":"Pipeline run history","href":"/docs/guides/pipeline-run-history"},{"title":"Impact stream","href":"/docs/guides/impact-stream"},{"title":"Troubleshoot pipelines with Maia Team","href":"/docs/guides/troubleshoot-pipelines-with-maia-team"}]}]},{"group":"Connections and credentials","root":{"title":"Connections and credentials overview","href":"/docs/guides/connections-and-credentials-overview"},"pages":[{"title":"Connections and credentials overview","href":"/docs/guides/connections-and-credentials-overview"},{"title":"Amazon Redshift connection","href":"/docs/guides/amazon-redshift-connection"},{"title":"Amazon Redshift Serverless connection","href":"/docs/guides/amazon-redshift-serverless-connection"},{"title":"Databricks","href":"/docs/guides/databricks-cdw-guide"},{"title":"Databricks Jobs Compute configuration","href":"/docs/guides/databricks-jobs-compute"},{"title":"Connect your Databricks account to Maia via Partner Connect","href":"/docs/guides/databricks-partner-connect"},{"title":"Connectivity via AWS PrivateLink using Full SaaS","href":"/docs/guides/aws-privatelink"},{"title":"Troubleshooting cloud data warehouse errors","href":"/docs/guides/troubleshooting-connectivity"}]},{"group":"Streaming","root":{"title":"Streaming pipelines","href":"/docs/streaming/streaming-pipelines"},"pages":[{"title":"Streaming pipelines","href":"/docs/streaming/streaming-pipelines"},{"title":"Sync All Tables","href":"/docs/streaming/sync-all-tables"},{"title":"Failover recovery for streaming pipelines","href":"/docs/streaming/failover-recovery"},{"title":"Dates and times strategy","href":"/docs/streaming/dates-and-times-strategy"},{"group":"Sources","pages":[{"title":"Modify access to source databases","href":"/docs/streaming/how-to-modify-access-for-each-source-system"},{"group":"Db2 for IBM i","pages":[{"title":"Configure your Db2 for IBM i database","href":"/docs/streaming/db2-for-ibm-i-configure-database"},{"title":"Db2 for IBM i streaming connector","href":"/docs/streaming/db2-for-ibm-i-streaming-source"}]},{"group":"Microsoft SQL Server","pages":[{"title":"Configure your Microsoft SQL Server database","href":"/docs/streaming/microsoft-sql-server-configure-database"},{"title":"Microsoft SQL Server streaming connector","href":"/docs/streaming/microsoft-sql-server-streaming-source"}]},{"group":"MySQL","pages":[{"title":"Configure the Streaming runner for MySQL","href":"/docs/streaming/mysql-configure-runner"},{"title":"Configure your MySQL database","href":"/docs/streaming/mysql-configure-database"},{"title":"MySQL streaming connector","href":"/docs/streaming/mysql-streaming-source"}]},{"group":"Oracle","pages":[{"title":"Configure your Oracle database","href":"/docs/streaming/oracle-configure-database"},{"title":"Oracle streaming connector","href":"/docs/streaming/oracle-streaming-source"}]},{"group":"PostgreSQL","pages":[{"title":"Configure your PostgreSQL database","href":"/docs/streaming/postgresql-configure-database"},{"title":"PostgreSQL streaming connector","href":"/docs/streaming/postgresql-streaming-source"}]}]},{"group":"Destinations","pages":[{"title":"Streaming to an Amazon S3 destination","href":"/docs/streaming/amazon-s3-streaming-destination"},{"title":"Streaming to an Azure Blob Storage destination","href":"/docs/streaming/azure-blob-storage-streaming-destination"},{"title":"Streaming to a Google Cloud Storage destination","href":"/docs/streaming/google-cloud-storage-streaming-destination"},{"title":"Streaming to a Snowflake destination","href":"/docs/streaming/snowflake-streaming-destination"}]},{"group":"Streaming runners","pages":[{"title":"Create a Streaming runner","href":"/docs/streaming/create-streaming-runner"},{"title":"Streaming runner versions","href":"/docs/streaming/runner-versions"},{"title":"Sizing Streaming runners","href":"/docs/streaming/sizing-streaming-runners"},{"title":"Streaming runner logs","href":"/docs/streaming/streaming-runner-logs"},{"title":"Enable Streaming runner heap dumps","href":"/docs/streaming/streaming-runner-heap-dumps"},{"group":"AWS","pages":[{"title":"AWS Fargate Streaming runner setup","href":"/docs/streaming/aws-streaming-runner-manual-setup"},{"title":"AWS IAM roles for Streaming runners","href":"/docs/streaming/streaming-runner-aws-iam-roles"},{"title":"Streaming runner installation using a CloudFormation quick-create link","href":"/docs/streaming/streaming-runner-installation-cloudformation-quick-create"}]},{"group":"Azure","pages":[{"title":"Streaming runner installation on Azure","href":"/docs/streaming/azure-streaming-runner-install"},{"title":"Configuring an Azure key vault for Streaming runners","href":"/docs/streaming/azure-arm-streaming-runner-key-vault"},{"title":"Download and amend the Azure Resource Manager template for a Streaming runner","href":"/docs/streaming/amend-azure-arm-streaming-template"},{"title":"Azure Resource Manager Streaming runner template permissions","href":"/docs/streaming/arm-streaming-template-permissions"},{"title":"Communicating with other Azure services","href":"/docs/streaming/authenticate-streaming-runner-with-azure-services"},{"title":"Azure Streaming runner troubleshooting","href":"/docs/streaming/azure-streaming-runner-troubleshooting"}]},{"group":"GCP","pages":[{"title":"Streaming runner installation on Google Cloud","href":"/docs/streaming/gcp-streaming-runner-install"}]}]}]},{"group":"Videos","pages":[{"title":"Feature videos","href":"/docs/videos/feature-videos"},{"title":"How-to video guides","href":"/docs/videos/how-to-videos"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/docs/api-reference/maia-api-overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/docs/changelog/2026-changelog"}]}]},"basePath":"","title":"Managing knowledge graphs - Maia Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}