MariaDB Integration
Integration of MariaDB with Entropy Data.
When setting up an integration between Entropy Data and MariaDB, we provide two options:
1. Ingestion-based Integration (Built-In)
The integration is managed within Entropy Data. Configure the connection and sync schedule to start syncing with MariaDB.
No additional deployments are needed.
2. Connector-based Integration
Our connectors are based on the Entropy Data SDK and provide support for more use cases. You get the asset syncing capabilities of the ingestion-based integration, plus direct integration with MariaDB permissions. Changes through the Access Approval Workflow can be dynamically applied to MariaDB user permissions.
If you have a complex network topology or direct integration with Entropy Data is not possible due to governance restrictions, the MariaDB connector can be deployed in a DMZ of your network to provide additional security.
| Feature | Ingestion-based Integration | Connector-based Integration |
|---|---|---|
| Direct integration into Entropy Data | ✅ | |
| Syncing of assets | ✅ | ✅ |
| Syncing of permissions | ✅ | |
| Complete control of deployment | ✅ | |
| Support for different network topologies | ✅ |
1. Ingestion-based Integration
You can directly integrate MariaDB with Entropy Data.
Prerequisites
To start, navigate to Settings > Integrations > Add Integration.
This opens a wizard that guides you through configuring the integration.
Select the Integration Type
Select MariaDB from the list of available integrations.
Configure the Connection
Provide the following connection details:
| Parameter | Description |
|---|---|
| Host | The hostname or IP address of the MariaDB server |
| Port | The port number (default: 3306) |
| Database | The name of the database to connect to (optional, leave empty to sync all databases) |
| Username | The username for authentication |
| Password | The password for authentication |
Note: Credentials are stored encrypted in the Entropy Data database. To enable encryption in your environment, set a 64 hex character
APPLICATION_ENCRYPTION_KEYSin your environment (see Configuration).
Configure Filters
Configure filters to limit which assets are synchronized. Both include and exclude filters are supported. For MariaDB, filters can be applied to Databases and Tables.
Filters support '*' as a wildcard character to match any number of characters.
System databases (information_schema, mysql, performance_schema, sys) are excluded automatically.
Configure Schedule
Set a schedule to automatically synchronize assets. You can choose from predefined schedules or define a custom schedule using the cron expression format.
Note: All schedules use the UTC timezone, so make sure to take this into account when configuring your schedule. Please do not synchronize the assets more than once or twice per day. We reserve the right to disable the integration if this happens. You will be able to trigger a synchronization manually if you need an immediate update.
Complete the Integration Configuration
Choose a unique name for the integration, review your configuration, and click Create Integration.
Next Steps
The integration is now configured and will run according to the schedule. To check the integration status, navigate to Settings > Integrations. Here you'll find the current status and the last 10 integration runs.
You can adjust the integration configuration and credentials at any time. The configuration is saved in YAML format with syntax validation support in the editor.
Note: The previously stored credentials are not displayed in the edit view for security reasons. If you want to change them, add new credentials and save the integration.
Deselecting the Enabled checkbox disables the automatic schedule. Manual integration runs are still possible.
2. Connector-based Integration
The MariaDB Connector is an open-source component that integrates Entropy Data with MariaDB databases. It is based on the SDK and available as a Docker image. The source code can be forked to implement custom integrations.
Features
- Asset Synchronization: Sync tables and schemas from MariaDB to Entropy Data as Assets.
- Access Management: Listen for AccessActivated and AccessDeactivated events in Entropy Data and manage access permissions on MariaDB.
Links
- Source Code: Entropy Data Connector for MariaDB on GitHub