Install & Compatibility
Where this runs
tested against v0.29.10 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 4.570s · 135MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 13.3s · import 4.332s · 191MB
170MB installed
● package 170MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
MySQLEventLogStorage
✓ from dagster_mysql import MySQLEventLogStorage
Use dagster_mysql, not a submodule like dagster_mysql.storage.
MySQLRunStorage
✓ from dagster_mysql import MySQLRunStorage
Use dagster_mysql, not a submodule.
dagster_mysql
✓ import dagster_mysql
Simple import works; the library auto-exports the main classes.
Basic setup to connect MySQL event log and run storage. Requires a running MySQL server.
from dagster_mysql import MySQLEventLogStorage, MySQLRunStorage
# Example configuration dict for the MySQL storage backends
config = {
"mysql_host": os.environ.get("MYSQL_HOST", "localhost"),
"mysql_port": int(os.environ.get("MYSQL_PORT", "3306")),
"mysql_user": os.environ.get("MYSQL_USER", "root"),
"mysql_password": os.environ.get("MYSQL_PASSWORD", ""),
"mysql_db_name": os.environ.get("MYSQL_DB_NAME", "dagster"),
}
# Create storage instances
event_log_storage = MySQLEventLogStorage.from_local(**config)
run_storage = MySQLRunStorage.from_local(**config)
# Verify connection (raises if cannot connect)
print("Connected to MySQL successfully.")
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'mysql'
Missing mysql-connector-python dependency.
fixInstall mysql-connector-python: `pip install mysql-connector-python`
OperationalError: (mysql.connector.errors.OperationalError) 1045 (28000): Access denied for user 'root'@'...'
Invalid MySQL credentials or host not allowed to connect.
fixVerify MYSQL_USER, MYSQL_PASSWORD, and that the user has remote access permissions.
ImportError: cannot import name 'MySQLEventLogStorage' from 'dagster_mysql'
Old versions of dagster-mysql (<0.28) exported from submodules; the preferred import path changed.
fixUse `from dagster_mysql import MySQLEventLogStorage`. If using an older version, import from `dagster_mysql.event_log`.
Upgrade
Version history
0.29.10latest on PyPI · released Jun 18, 2026
Audit
Dependencies
dagsterrequiredCore dependency; dagster-mysql is an extension plugin.
mysql-connector-pythonrequiredRequired for MySQL connectivity.