Dialekte, für die diese Anweisungen relevant sind
Die auf dieser Seite beschriebenen Anforderungen für die Einrichtung der Datenbank gelten für MySQL, MariaDB und SingleStore (ehemals MemSQL), um Looker mit Ihrer Analysedatenbank zu verbinden. Informationen zum Konfigurieren von MySQL als interne Backend-Datenbank für eine vom Kunden gehostete Looker-Instanz finden Sie unter Looker-Backend-Datenbank zu MySQL migrieren.
Netzwerk-Datenverkehr verschlüsseln
Es empfiehlt sich, den Netzwerkverkehr zwischen Looker-Anwendung und Datenbank zu verschlüsseln. Prüfen Sie eine der Optionen, die auf der Dokumentationsseite Sicheren Datenbankzugriff ermöglichen beschrieben werden.
Wenn Sie an der Verwendung von SSL-Verschlüsselung interessiert sind, informieren Sie sich auf dieser Dokumentationsseite zu MySQL.
Benutzer und Sicherheit
Befolgen Sie zur Erstellung und Erteilung des erforderlichen Zugangs für den Looker-Benutzer die Anweisungen in dem entsprechenden Abschnitt für Ihre Datenbanksprache und -version.
MySQL 8.4.X
In MySQL 8.4.X ist caching_sha2_password das Standardauthentifizierungs-Plug-in und das Plug-in mysql_native_password ist standardmäßig deaktiviert. Wählen Sie eine der folgenden Authentifizierungsmethoden aus, je nachdem, ob SSL für Ihre Looker-Verbindung aktiviert ist:
Bei einer Verbindung mit aktiviertem SSL (empfohlen): Der Looker-JDBC-Treiber unterstützt
caching_sha2_passwordüber SSL-Verbindungen, ohne dassmysql_native_passwordaktiviert werden muss. Wählen Sie SSL aus, wenn Sie die Looker-Verbindung erstellen, und führen Sie die folgenden Befehle aus, um den Nutzer zu erstellen undSELECT-Berechtigungen zu gewähren:CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH caching_sha2_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';Bei einer Verbindung ohne aktiviertes SSL: Da Looker den automatischen Abruf des öffentlichen RSA-Schlüssels (
allowPublicKeyRetrieval) für unverschlüsselte Kundendatenbankverbindungen nicht aktiviert, müssen Sie sich mitmysql_native_passwordauthentifizieren:Konfigurieren Sie den MySQL 8.4.X-Server so, dass das Plug-in
mysql_native_passwordaktiviert wird. Verwenden Sie dazu je nach Bereitstellung eine der folgenden Methoden:- Starten Sie den MySQL-Server mit dem Flag
--mysql-native-password=ON. Legen Sie das Attribut in der Konfigurationsdatei
my.cnffest:[mysqld] mysql_native_password=ONAktivieren Sie für in der Cloud gehostete MySQL 8.4.X-Instanzen in Google Cloud, AWS oder Azure das Datenbank-Flag oder den Parameter
mysql_native_passwordin Ihrer Instanzkonfiguration oder Parametergruppe, falls es nicht standardmäßig aktiviert ist, und starten Sie die Datenbankinstanz bei Bedarf neu. Weitere Informationen zur Konfiguration finden Sie in der Dokumentation Ihres Cloud-Anbieters.
- Starten Sie den MySQL-Server mit dem Flag
Erstellen Sie den Datenbanknutzer mit
mysql_native_passwordund gewähren SieSELECT-Berechtigungen:CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
Ersetzen Sie die folgenden Platzhalter in den vorherigen Befehlen:
- DB_USERNAME: Der Nutzername für den Looker-Datenbanknutzer, z. B.
looker. - PASSWORD: ein eindeutiges, sicheres Passwort
- DATABASE_NAME: der Name Ihrer Datenbank
MySQL 8.0.X
In MySQL 8.0.X ist caching_sha2_password das standardmäßige Authentifizierungs-Plug-in. Looker verwendet das Plug-in mysql_native_password, um sich über den JDBC-Treiber bei MySQL 8.0.X-Datenbanken zu authentifizieren. Führen Sie die folgenden Schritte aus, damit MySQL 8.0.X ordnungsgemäß funktioniert:
Konfigurieren Sie die MySQL-Datenbank für die Verwendung des
mysql_native_password-Plug-ins. Dafür gibt es verschiedene Vorgehensweisen, die je nach Bereitstellungsvariante der MySQL 8-Datenbank und Art der Zugriffsberechtigung variieren:Starten Sie den Prozess mit dem Flag
--default-auth=mysql_native_password.Legen Sie das Attribut in der Konfigurationsdatei
my.cnffest:
[mysqld] default-authentication-plugin=mysql_native_password- Wenn die Datenbankinstanz durch AWS RDS gehostet wird, können Sie den
default_authentication_plugin-Parameter durch die Anwendung einer RDS Parameter Group auf die Datenbankinstanz bestimmen.
Führen Sie die folgenden Befehle aus und ersetzen Sie dabei
PASSWORDdurch ein eindeutiges, sicheres Passwort:CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'PASSWORD'; GRANT SELECT ON database_name.* TO 'looker'@'%';
MySQL 5.7.X und niedriger, MariaDB und SingleStore:
Führen Sie die folgenden Befehle aus und ersetzen Sie dabei PASSWORD durch ein eindeutiges, sicheres Passwort:
CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('PASSWORD');
GRANT SELECT ON database_name.* TO 'looker'@'%';
Temporäre Schema-Einrichtung für persistente abgeleitete Tabellen
Diese Datenbankdialekte unterstützen die Erstellung persistenter abgeleiteter Tabellen (PDTs). Diese Funktion kann äußerst nützlich sein. Wir empfehlen daher, sie nach Möglichkeit zu aktivieren.
Damit PDT aktiviert werden können, müssen Sie ein temporäres Schema konfigurieren. Die folgenden Befehle zeigen ein Beispiel für die Erstellung einer temporären Datenbank und die Gewährung der erforderlichen Berechtigungen für den Nutzer looker.
Sie können den Namen der temporären Datenbank im Feld Temporäre Datenbank angeben, wenn Sie die Datenbankverbindung erstellen. Wenn Sie keinen Namen für die temporäre Datenbank festlegen, erstellt Looker eine Scratch-Datenbank namens
looker_tmp. Die folgenden Befehle verwendenlooker_tmp. Wenn Sie aber einen anderen Namen für die temporäre Datenbank festgelegt haben, verwenden Sie diesen anstelle vonlooker_tmp.
CREATE SCHEMA looker_tmp;
GRANT
SELECT,
INDEX,
INSERT,
UPDATE,
DELETE,
CREATE,
DROP,
ALTER,
CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
Für SingleStore oder wenn Ihre Datenbank die GTID-basierte Replikation verwendet, müssen Sie den LookML-Parameter create_process verwenden, um PDTs zu verwenden, da GTID keine CREATE TABLE AS SELECT-Anweisungen unterstützt.
Alternative Einrichtungsoption für reguläre abgeleitete Tabellen
Wenn Sie die Erstellung von persistenten abgeleiteten Tabellen nicht zulassen möchten, können Sie weiterhin reguläre abgeleitete Tabellen verwenden. Um reguläre abgeleitete Tabellen zu verwenden, müssen Sie einem Schema namens looker_tmp weiterhin bestimmte Berechtigungen hinzufügen. Das Schema looker_tmp muss dafür nicht in Ihrer Datenbank vorhanden sein.
GRANT
SELECT,
INDEX,
INSERT,
DROP,
CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';
-- Note that the looker_tmp schema does not need to actually exist,
-- even though these permission grants are still needed
Variable max_allowed_packet festlegen
Setzen Sie für MySQL die MySQL-Variable max_allowed_packet auf den Höchstwert (1073741824), um die folgenden Fehler zu vermeiden: „SQLException: Packet for query is too large“.
Looker-Verbindung zu Ihrer Datenbank erstellen
Im Anschluss an die Datenbankkonfiguration können Sie in Looker eine Verbindung mit der Datenbank herstellen. So verbinden Sie Looker mit Ihrer Datenbank
- Wählen Sie in Looker im Bereich Admin die Option Verbindungen aus und klicken Sie dann auf Verbindung hinzufügen.
Wählen Sie im Drop-down-Menü Dialekt den Namen Ihres Datenbankdialekts aus: MySQL, MySQL 8.0.12+ (für MySQL 8.0.12 und neuere 8.X-Versionen, einschließlich MySQL 8.4.X), MariaDB, SingleStore oder SingleStore 7+.
Geben Sie die Verbindungsdetails ein. Der Großteil der Einstellungen ist für die meisten Datenbankdialekte gleich. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.
Klicken Sie unten auf der Seite Verbindungseinstellungen im Bereich Statusdetails auf den Button Verbindung testen, um zu prüfen, ob die Verbindung erfolgreich hergestellt wurde.
Wenn in Looker Can Connect angezeigt wird, klicken Sie auf Connect, um die Verbindung zu erstellen.
Ihre Datenbankverbindung wird dann der Liste auf der Looker-Seite Verbindungen Verwaltung hinzugefügt.
Unterstützte JDBC-Parameter
Für MySQL, MariaDB und SingleStore unterstützt Looker die folgenden JDBC-Parameter im Feld Zusätzliche JDBC-Parameter für die Verbindung. Informationen zu diesen Parametern finden Sie in der Dokumentation zu Ihrer Datenbank.
allowMultiQueriesautocommitcharacterSetResultsclientCertificateKeyStorePasswordclientCertificateKeyStoreUrlconnectionAttributesconnectionCollationconnectionTimeZoneconnectTimeoutdefaultAuthenticationPlugindisableSslHostnameVerificationdisconnectOnExpiredPasswordsenabledSslCipherSuitesfailOverReadOnlyfallbackToSystemTrustStoreforceConnectionTimeZoneToSessioninteractiveClientlookerFailovermaxIdleTimemaxQuerySizeToLogoldModeNoPrecisionTimestamppasswordpasswordCharacterEncodingpermitMysqlSchemepinGlobalTxToPhysicalConnectionpreserveInstantsqueryInterceptorsrestrictedAuthrewriteBatchedStatementssocketTimeoutsslModetcpKeepAlivetrustCertificateKeyStorePasswordtrustCertificateKeyStoreUrluseCompressionusePipelineAuthuseruseServerPrepStmtsverifyServerCertificateyearIsDateType
Funktionsunterstützung
Damit Looker einige Funktionen unterstützen kann, müssen diese auch von Ihrem Datenbankdialekt unterstützt werden.
MySQL unterstützt ab Looker 26.22 die folgenden Funktionen:
| Funktion | Unterstützt? |
|---|---|
| Looker (Google Cloud Core) | |
| Symmetrische Aggregate | |
| Abgeleitete Tabellen | |
| Persistente abgeleitete SQL-Tabellen | |
| Persistente, native abgeleitete Tabellen | |
| Stabile Ansichten | |
| Abfrageeabruch | |
| SQL-basierte Pivots | |
| Zeitzonen | |
| SSL | |
| Zwischensummen | |
| Zusätzliche JDBC-Parameter | |
| Groß-/Kleinschreibung beachten | |
| Standorttyp | |
| Listentyp | |
| Perzentil | |
| Perzentil der unterschiedlichen Werte | |
| SQL-Runner-Befehl – Prozesse anzeigen | |
| SQL-Runner-Funktion – Tabelle beschreiben | |
| SQL Runner-Befehl – Indexe anzeigen | |
| SQL-Runner – 10 auswählen | |
| SQL-Runner – Anzahl | |
| SQL – Erklären | |
| OAuth 2.0-Anmeldedaten | |
| Kontextkommentare | |
| Verbindungs-Pooling | |
| HLL-Skizzen | |
| Aggregate Awareness | |
| Inkrementelle PDTs | |
| Millisekunden | |
| Mikrosekunden | |
| Materialisierte Ansichten | |
| Vergleich zum vorherigen Zeitraum | |
| Ungefähre Anzahl einzelner Aufrufe | |
| In-Database-Analysemodelle | |
| Benutzerdefinierte Kalender |
MySQL 8.0.12 und höher unterstützen ab Looker 26.22 die folgenden Funktionen:
| Funktion | Unterstützt? |
|---|---|
| Looker (Google Cloud Core) | |
| Symmetrische Aggregate | |
| Abgeleitete Tabellen | |
| Persistente abgeleitete SQL-Tabellen | |
| Persistente, native abgeleitete Tabellen | |
| Stabile Ansichten | |
| Abfrageeabruch | |
| SQL-basierte Pivots | |
| Zeitzonen | |
| SSL | |
| Zwischensummen | |
| Zusätzliche JDBC-Parameter | |
| Groß-/Kleinschreibung beachten | |
| Standorttyp | |
| Listentyp | |
| Perzentil | |
| Perzentil der unterschiedlichen Werte | |
| SQL-Runner-Befehl – Prozesse anzeigen | |
| SQL-Runner-Funktion – Tabelle beschreiben | |
| SQL Runner-Befehl – Indexe anzeigen | |
| SQL-Runner – 10 auswählen | |
| SQL-Runner – Anzahl | |
| SQL – Erklären | |
| OAuth 2.0-Anmeldedaten | |
| Kontextkommentare | |
| Verbindungs-Pooling | |
| HLL-Skizzen | |
| Aggregate Awareness | |
| Inkrementelle PDTs | |
| Millisekunden | |
| Mikrosekunden | |
| Materialisierte Ansichten | |
| Vergleich zum vorherigen Zeitraum | |
| Ungefähre Anzahl einzelner Aufrufe | |
| In-Database-Analysemodelle | |
| Benutzerdefinierte Kalender |
MariaDB unterstützt ab Looker 26.22 die folgenden Funktionen:
| Funktion | Unterstützt? |
|---|---|
| Looker (Google Cloud Core) | |
| Symmetrische Aggregate | |
| Abgeleitete Tabellen | |
| Persistente abgeleitete SQL-Tabellen | |
| Persistente, native abgeleitete Tabellen | |
| Stabile Ansichten | |
| Abfrageeabruch | |
| SQL-basierte Pivots | |
| Zeitzonen | |
| SSL | |
| Zwischensummen | |
| Zusätzliche JDBC-Parameter | |
| Groß-/Kleinschreibung beachten | |
| Standorttyp | |
| Listentyp | |
| Perzentil | |
| Perzentil der unterschiedlichen Werte | |
| SQL-Runner-Befehl – Prozesse anzeigen | |
| SQL-Runner-Funktion – Tabelle beschreiben | |
| SQL Runner-Befehl – Indexe anzeigen | |
| SQL-Runner – 10 auswählen | |
| SQL-Runner – Anzahl | |
| SQL – Erklären | |
| OAuth 2.0-Anmeldedaten | |
| Kontextkommentare | |
| Verbindungs-Pooling | |
| HLL-Skizzen | |
| Aggregate Awareness | |
| Inkrementelle PDTs | |
| Millisekunden | |
| Mikrosekunden | |
| Materialisierte Ansichten | |
| Vergleich zum vorherigen Zeitraum | |
| Ungefähre Anzahl einzelner Aufrufe | |
| In-Database-Analysemodelle | |
| Benutzerdefinierte Kalender |
SingleStore unterstützt ab Looker 26.22 die folgenden Funktionen:
| Funktion | Unterstützt? |
|---|---|
| Looker (Google Cloud Core) | |
| Symmetrische Aggregate | |
| Abgeleitete Tabellen | |
| Persistente abgeleitete SQL-Tabellen | |
| Persistente, native abgeleitete Tabellen | |
| Stabile Ansichten | |
| Abfrageeabruch | |
| SQL-basierte Pivots | |
| Zeitzonen | |
| SSL | |
| Zwischensummen | |
| Zusätzliche JDBC-Parameter | |
| Groß-/Kleinschreibung beachten | |
| Standorttyp | |
| Listentyp | |
| Perzentil | |
| Perzentil der unterschiedlichen Werte | |
| SQL-Runner-Befehl – Prozesse anzeigen | |
| SQL-Runner-Funktion – Tabelle beschreiben | |
| SQL Runner-Befehl – Indexe anzeigen | |
| SQL-Runner – 10 auswählen | |
| SQL-Runner – Anzahl | |
| SQL – Erklären | |
| OAuth 2.0-Anmeldedaten | |
| Kontextkommentare | |
| Verbindungs-Pooling | |
| HLL-Skizzen | |
| Aggregate Awareness | |
| Inkrementelle PDTs | |
| Millisekunden | |
| Mikrosekunden | |
| Materialisierte Ansichten | |
| Vergleich zum vorherigen Zeitraum | |
| Ungefähre Anzahl einzelner Aufrufe | |
| In-Database-Analysemodelle | |
| Benutzerdefinierte Kalender |
SingleStore 7 und höher unterstützen ab Looker 26.22 die folgenden Funktionen:
| Funktion | Unterstützt? |
|---|---|
| Looker (Google Cloud Core) | |
| Symmetrische Aggregate | |
| Abgeleitete Tabellen | |
| Persistente abgeleitete SQL-Tabellen | |
| Persistente, native abgeleitete Tabellen | |
| Stabile Ansichten | |
| Abfrageeabruch | |
| SQL-basierte Pivots | |
| Zeitzonen | |
| SSL | |
| Zwischensummen | |
| Zusätzliche JDBC-Parameter | |
| Groß-/Kleinschreibung beachten | |
| Standorttyp | |
| Listentyp | |
| Perzentil | |
| Perzentil der unterschiedlichen Werte | |
| SQL-Runner-Befehl – Prozesse anzeigen | |
| SQL-Runner-Funktion – Tabelle beschreiben | |
| SQL Runner-Befehl – Indexe anzeigen | |
| SQL-Runner – 10 auswählen | |
| SQL-Runner – Anzahl | |
| SQL – Erklären | |
| OAuth 2.0-Anmeldedaten | |
| Kontextkommentare | |
| Verbindungs-Pooling | |
| HLL-Skizzen | |
| Aggregate Awareness | |
| Inkrementelle PDTs | |
| Millisekunden | |
| Mikrosekunden | |
| Materialisierte Ansichten | |
| Vergleich zum vorherigen Zeitraum | |
| Ungefähre Anzahl einzelner Aufrufe | |
| In-Database-Analysemodelle | |
| Benutzerdefinierte Kalender |