Dialects Using These Instructions
MySQL, Clustrix, MariaDB, and MemSQL share the database setup requirements described on this page.
Encrypting Network Traffic
Looker strongly recommends encrypting network traffic between the Looker application and your database. Consider one of the options described here.
If you’re interested in using SSL encryption, see this MySQL documentation page.
Users and Security
some_password_here to a unique, secure password:
Temp Schema Setup for Persistent Derived Tables
These database dialects support the creation of persistent derived tables (PDTs). This feature can be very useful, and we recommend enabling it when possible.
To enable PDTs, you need to configure a temp schema. Create a temp database (
looker_scratch) and give the Looker user the rights to write to it. For these database dialects, the following privileges need to be granted to the Looker database user:
For MemSQL, or if your database uses GTID-based replication, you must use the
create_process LookML parameter to use PDTs, because GTID does not support
CREATE TABLE AS SELECT statements.
Alternative Setup for Regular Derived Tables
If you do not want to allow the creation of persistent derived tables, you can still use regular derived tables. To use regular derived tables, you still need to add certain permissions to a schema called
looker_tmp. However, the
looker_tmp schema does not actually need to exist in your database!
Looker’s ability to provide some features depends on whether the database dialect can support them.
In the current Looker release, MySQL supports the following Looker features:
In the current Looker release, Clustrix supports the following Looker features:
In the current Looker release, MariaDB supports the following Looker features:
In the current Looker release, MemSQL supports the following Looker features:
After completing the database configuration, you can connect to the database from Looker using these directions.
When creating connections, be sure to use the correct database dialect name. Although the database configuration instructions are the same for MySQL, Clustrix, MariaDB, and MemSQL be sure to pick your specific dialect from the Dialect drop-down on the Connections page, which is described next.