Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Sync your structured data store with your Amazon Bedrock knowledge base

Focus mode
Sync your structured data store with your Amazon Bedrock knowledge base - Amazon Bedrock

After you connect your knowledge base to a structured data store, you perform a sync to start the metadata ingestion process so that data can be retrieved. The metadata allows Amazon Bedrock Knowledge Bases to translate user prompts into a query for the connected database.

Whenever you make modifications to your database schema, you need to sync the changes.

To learn how to ingest your metadata into your knowledge base and sync with your latest data, choose the tab for your preferred method, and then follow the steps:

Console
To ingest your data into your knowledge base and sync with your latest data
  1. Open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.

  2. From the left navigation pane, select Knowledge base and choose your knowledge base.

  3. In the Data source section, select Sync to begin the metadata ingestion process. To stop a data source currently syncing, select Stop. A data source must be currently syncing in order to stop syncing the data source. You can select Sync again to ingest the rest of your data.

  4. When data ingestion completes, a green success banner appears if it is successful.

  5. You can choose a data source to view its Sync history. Select View warnings to see why a data ingestion job failed.

API

To ingest your data into your knowledge base and sync with your latest data, send a StartIngestionJob request with an Agents for Amazon Bedrock build-time endpoint.

Use the ingestionJobId returned in the response in a GetIngestionJob request with an Agents for Amazon Bedrock build-time endpoint to track the status of the ingestion job.

You can see information for all ingestion jobs for a data source by sending a ListIngestionJobs request with a Agents for Amazon Bedrock build-time endpoint.

To stop a data ingestion job that is currently running, send a StopIngestionJobs request with an Agents for Amazon Bedrock build-time endpoint. You can send a StartIngestionJob request again to ingest the rest of your data when you are ready.

To ingest your data into your knowledge base and sync with your latest data
  1. Open the Amazon Bedrock console at https://console.aws.amazon.com/bedrock/.

  2. From the left navigation pane, select Knowledge base and choose your knowledge base.

  3. In the Data source section, select Sync to begin the metadata ingestion process. To stop a data source currently syncing, select Stop. A data source must be currently syncing in order to stop syncing the data source. You can select Sync again to ingest the rest of your data.

  4. When data ingestion completes, a green success banner appears if it is successful.

  5. You can choose a data source to view its Sync history. Select View warnings to see why a data ingestion job failed.

Important

If you use the Amazon Bedrock Knowledge Bases service role created for you in the console and then sync your data store before granting access to your database to the authentication role that you use, the sync will fail because the user hasn't been granted permissions to access your data store. For information about granting permissions to a role to access your data store, see Allow your Amazon Bedrock Knowledge Bases service role to access your data store.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.