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.

FeatureIngestion-based IntegrationConnector-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 the Integration Type Select MariaDB from the list of available integrations.

Configure the Connection

Provide the following connection details:

ParameterDescription
HostThe hostname or IP address of the MariaDB server
PortThe port number (default: 3306)
DatabaseThe name of the database to connect to (optional, leave empty to sync all databases)
UsernameThe username for authentication
PasswordThe 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_KEYS in 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