MindsDB
About
MindsDB is an AI federated database in the world. It allows you to combine information from hundreds of datasources as if they were SQL, supporting joins across datasources and enabling you to query all unstructured data as if it were structured.
MindsDB translates MySQL queries into whatever API is needed - whether it’s REST APIs, GraphQL, or native database protocols. This means you can write standard SQL queries and MindsDB automatically handles the translation to APIs like Salesforce, Jira, GitHub, email systems, MongoDB, and hundreds of other datasources.
MindsDB also enables you to use ML frameworks to train and use models as virtual tables from the data in those datasources. With MindsDB, the GenAI Toolbox can now expand to hundreds of datasources and leverage all of MindsDB’s capabilities on ML and unstructured data.
Key Features:
- Federated Database: Connect and query hundreds of datasources through a single SQL interface
- Cross-Datasource Joins: Perform joins across different datasources seamlessly
- API Translation: Automatically translates MySQL queries into REST APIs, GraphQL, and native protocols
- Unstructured Data Support: Query unstructured data as if it were structured
- ML as Virtual Tables: Train and use ML models as virtual tables
- MySQL Wire Protocol: Compatible with standard MySQL clients and tools
Supported Datasources
MindsDB supports hundreds of datasources, including:
Business Applications
- Salesforce: Query leads, opportunities, accounts, and custom objects
- Jira: Access issues, projects, workflows, and team data
- GitHub: Query repositories, commits, pull requests, and issues
- Slack: Access channels, messages, and team communications
- HubSpot: Query contacts, companies, deals, and marketing data
Databases & Storage
- MongoDB: Query NoSQL collections as structured tables
- Redis: Key-value stores and caching layers
- Elasticsearch: Search and analytics data
- S3/Google Cloud Storage: File storage and data lakes
Communication & Email
- Gmail/Outlook: Query emails, attachments, and metadata
- Slack: Access workspace data and conversations
- Microsoft Teams: Team communications and files
- Discord: Server data and message history
Example Queries
Cross-Datasource Analytics
-- Join Salesforce opportunities with GitHub activity
SELECT
s.opportunity_name,
s.amount,
g.repository_name,
COUNT(g.commits) as commit_count
FROM salesforce.opportunities s
JOIN github.repositories g ON s.account_id = g.owner_id
WHERE s.stage = 'Closed Won'
GROUP BY s.opportunity_name, s.amount, g.repository_name;
Email & Communication Analysis
-- Analyze email patterns with Slack activity
SELECT
e.sender,
e.subject,
s.channel_name,
COUNT(s.messages) as message_count
FROM gmail.emails e
JOIN slack.messages s ON e.sender = s.user_name
WHERE e.date >= '2024-01-01'
GROUP BY e.sender, e.subject, s.channel_name;
ML Model Predictions
-- Use ML model to predict customer churn
SELECT
customer_id,
customer_name,
predicted_churn_probability,
recommended_action
FROM customer_churn_model
WHERE predicted_churn_probability > 0.8;
Requirements
Database User
This source uses standard MySQL authentication since MindsDB implements the MySQL wire protocol. You will need to create a MindsDB user to login to the database with. If MindsDB is configured without authentication, you can omit the password field.
Example
sources:
my-mindsdb-source:
kind: mindsdb
host: 127.0.0.1
port: 3306
database: my_db
user: ${USER_NAME}
password: ${PASSWORD} # Optional: omit if MindsDB is configured without authentication
queryTimeout: 30s # Optional: query timeout duration
Working Configuration Example
Here’s a working configuration that has been tested:
sources:
my-pg-source:
kind: mindsdb
host: 127.0.0.1
port: 47335
database: files
user: mindsdb
Tip
Use environment variable replacement with the format ${ENV_NAME} instead of hardcoding your secrets into the configuration file.
Use Cases
With MindsDB integration, you can:
- Query Multiple Datasources: Connect to databases, APIs, file systems, and more through a single SQL interface
- Cross-Datasource Analytics: Perform joins and analytics across different data sources
- ML Model Integration: Use trained ML models as virtual tables for predictions and insights
- Unstructured Data Processing: Query documents, images, and other unstructured data as structured tables
- Real-time Predictions: Get real-time predictions from ML models through SQL queries
- API Abstraction: Write SQL queries that automatically translate to REST APIs, GraphQL, and native protocols
Reference
| field | type | required | description |
|---|---|---|---|
| kind | string | true | Must be “mindsdb”. |
| host | string | true | IP address to connect to (e.g. “127.0.0.1”). |
| port | string | true | Port to connect to (e.g. “3306”). |
| database | string | true | Name of the MindsDB database to connect to (e.g. “my_db”). |
| user | string | true | Name of the MindsDB user to connect as (e.g. “my-mindsdb-user”). |
| password | string | false | Password of the MindsDB user (e.g. “my-password”). Optional if MindsDB is configured without authentication. |
| queryTimeout | string | false | Maximum time to wait for query execution (e.g. “30s”, “2m”). By default, no timeout is applied. |
Resources
- MindsDB Documentation - Official documentation and guides
- MindsDB GitHub - Source code and community