Skip to main content
Summation connects to MySQL and compatible flavors (MariaDB, RDS for MySQL, Aurora MySQL, Cloud SQL for MySQL) using standard host/port credentials.

What you’ll need

  • A reachable host and port (default 3306).
  • A database name.
  • A user with SELECT on the tables you want exposed. See GRANT Statement in the MySQL docs.

Where to find host/port for your provider

ProviderWhere to look
Amazon RDS / AuroraRDS console → your DB instance → Connectivity & security. See Connecting to a DB instance running MySQL.
Google Cloud SQL for MySQLCloud SQL console → your instance → Connections. See About connection options.
Azure Database for MySQLAzure portal → your server → Overview. See Connect and query.

Form fields

FieldRequiredStored asNotes
HostYesConfigDNS name or IP, e.g. db.example.com.
PortYesConfigDefault 3306.
DatabaseYesConfigThe MySQL database (schema) name.
UsernameYesConfigMySQL login.
PasswordYesSecret
SSL ModeOptionalConfigdisabled, preferred, required, verify_ca, or verify_identity. Default required. See --ssl-mode in the MySQL docs.
CA CertificateOptionalSecretUpload or paste a PEM CA bundle for verify_ca / verify_identity. See Configuring MySQL to use encrypted connections.
Min Pool SizeOptionalConfigMinimum idle connections. Default 10.
Max Pool SizeOptionalConfigMaximum concurrent connections. Default 100.

Setup SQL

CREATE USER 'summation'@'%' IDENTIFIED BY '<strong-password>';
GRANT SELECT ON analytics.* TO 'summation'@'%';
FLUSH PRIVILEGES;
To force TLS on the user:
ALTER USER 'summation'@'%' REQUIRE SSL;
See CREATE USER Statement for more options.

Adding datasets

Source references use the form:
mysql:my_database.my_table

Common problems

Error or symptomLikely cause
Access denied for userWrong user, password, or host pattern. Check 'summation'@'%' vs 'summation'@'10.%'.
SSL connection errorSSL Mode doesn’t match the server. Most managed providers reject disabled.
Too many connectionsLower Max Pool Size if the server’s max_connections is low.