MySQL, MariaDB e SingleStore

Dialetti che utilizzano queste istruzioni

MySQL, MariaDB e SingleStore (in precedenza MemSQL) condividono i requisiti di configurazione del database descritti in questa pagina per connettere Looker al tuo database di analisi. Per configurare MySQL come database di backend interno per un'istanza di Looker ospitata dal cliente, consulta Migrazione del database di backend di Looker a MySQL.

Crittografia del traffico di rete

È una best practice criptare il traffico di rete tra l'applicazione Looker e il tuo database. Valuta una delle opzioni descritte nella pagina della documentazione Abilita l'accesso sicuro ai database.

Se ti interessa utilizzare la crittografia SSL, consulta questa pagina della documentazione di MySQL.

Utenti e sicurezza

Per creare e concedere l'accesso richiesto all'utente di Looker, segui le istruzioni nella sezione relativa al dialetto e alla versione del tuo database.

MySQL 8.4.X

In MySQL 8.4.X, il plug-in di autenticazione predefinito è caching_sha2_password e il plug-in mysql_native_password è disattivato per impostazione predefinita. Scegli uno dei seguenti metodi di autenticazione a seconda che SSL sia abilitato o meno per la connessione di Looker:

  • Quando ti connetti con SSL abilitato (consigliato): il driver JDBC di Looker supporta caching_sha2_password su connessioni SSL senza abilitare mysql_native_password. Seleziona SSL quando crei la connessione di Looker ed esegui i seguenti comandi per creare l'utente e concedere i privilegi SELECT:

    CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH caching_sha2_password BY 'PASSWORD';
    GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
    
  • Quando ti connetti senza SSL abilitato: poiché Looker non abilita il recupero automatico della chiave pubblica RSA (allowPublicKeyRetrieval) sulle connessioni ai database dei clienti non criptate, devi eseguire l'autenticazione con mysql_native_password:

    1. Configura il server MySQL 8.4.X per attivare il plug-in mysql_native_password utilizzando uno dei seguenti metodi, a seconda del deployment:

      • Avvia il server MySQL con il flag --mysql-native-password=ON.
      • Imposta la proprietà nel file di configurazione my.cnf:

        [mysqld]
        mysql_native_password=ON
        
      • Per le istanze MySQL 8.4.X ospitate nel cloud su Google Cloud, AWS o Azure, abilita il flag o il parametro di database mysql_native_password nella configurazione dell'istanza o nel gruppo di parametri se non è abilitato per impostazione predefinita e riavvia l'istanza di database, se necessario. Per i dettagli sulla configurazione, consulta la documentazione del tuo cloud provider.

    2. Crea l'utente del database con mysql_native_password e concedi i privilegi SELECT:

      CREATE USER 'DB_USERNAME'@'%' IDENTIFIED WITH mysql_native_password BY 'PASSWORD';
      GRANT SELECT ON DATABASE_NAME.* TO 'DB_USERNAME'@'%';
      

Sostituisci i seguenti segnaposto nei comandi precedenti:

  • DB_USERNAME: il nome utente dell'utente del database Looker, ad esempio looker
  • PASSWORD: una password univoca e sicura
  • DATABASE_NAME: il nome del database

MySQL 8.0.X

In MySQL 8.0.X, il plug-in di autenticazione predefinito è caching_sha2_password. Looker utilizza il plug-in mysql_native_password per autenticarsi nei database MySQL 8.0.X tramite il driver JDBC. Per il corretto funzionamento di MySQL 8.0.X, completa i seguenti passaggi:

  1. Configura il database MySQL in modo che utilizzi il plug-in mysql_native_password. Questa operazione può essere eseguita in diversi modi e dipende dalla modalità di deployment del database MySQL 8 e dal tipo di accesso alla configurazione:

    • Avvia il processo con il flag --default-auth=mysql_native_password

    • Imposta la proprietà nel file di configurazione my.cnf:

    [mysqld]
    default-authentication-plugin=mysql_native_password
    
    • Se l'istanza di database è ospitata tramite AWS RDS, imposta il parametro default_authentication_plugin tramite un gruppo di parametri RDS applicato a questa istanza di database.
  2. Esegui i seguenti comandi, sostituendo PASSWORD con una password univoca e sicura:

    CREATE USER looker IDENTIFIED WITH mysql_native_password BY 'PASSWORD';
    GRANT SELECT ON database_name.* TO 'looker'@'%';
    

MySQL 5.7.X e versioni precedenti, MariaDB e SingleStore:

Esegui i seguenti comandi, sostituendo PASSWORD con una password univoca e sicura:

CREATE USER looker;
SET PASSWORD FOR looker = PASSWORD ('PASSWORD');
GRANT SELECT ON database_name.* TO 'looker'@'%';

Configurazione dello schema temporaneo per le tabelle derivate permanenti

Questi dialetti di database supportano la creazione di tabelle derivate permanenti (PDT). Questa funzionalità può essere molto utile e ti consigliamo di attivarla, se possibile.

Per attivare le PDT, devi configurare uno schema temporaneo. I seguenti comandi mostrano un esempio di creazione di un database temporaneo e di concessione dei privilegi richiesti all'utente looker.

Puoi specificare il nome del database temporaneo nel campo Database temporaneo quando crei la connessione al database. Se non specifichi un nome per il database temporaneo, Looker genera un database temporaneo denominato looker_tmp. I seguenti comandi utilizzano looker_tmp, ma se hai specificato un nome diverso per il database temporaneo, utilizza il nome del tuo database temporaneo anziché looker_tmp.

CREATE SCHEMA looker_tmp;
GRANT
  SELECT,
  INDEX,
  INSERT,
  UPDATE,
  DELETE,
  CREATE,
  DROP,
  ALTER,
  CREATE TEMPORARY TABLES
ON looker_tmp.* TO 'looker'@'%';

Per SingleStore o se il tuo database utilizza la replica basata su GTID, devi utilizzare il parametro LookML create_process per utilizzare le PDT, perché GTID non supporta le istruzioni CREATE TABLE AS SELECT.

Configurazione alternativa per le tabelle derivate normali

Se non vuoi consentire la creazione di tabelle derivate permanenti, puoi comunque utilizzare le tabelle derivate normali. Per utilizzare le tabelle derivate normali, devi comunque aggiungere determinate autorizzazioni a uno schema denominato looker_tmp. Tuttavia, lo schema looker_tmp non deve necessariamente esistere nel tuo database.

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

Imposta la variabile max_allowed_packet

Per MySQL, imposta la variabile MySQL max_allowed_packet sul valore massimo, 1073741824, per evitare errori "SQLException: Packet for query is too large".

Creazione della connessione di Looker al tuo database

Dopo aver completato la configurazione del database, puoi connetterti al database da Looker. Segui questi passaggi per creare la connessione da Looker al tuo database:

  1. Nella sezione Admin (Amministratore) di Looker, seleziona Connections (Connessioni) e poi fai clic su Add Connection (Aggiungi connessione).
  2. Dal menu a discesa Dialetto, seleziona il nome del dialetto del database: MySQL, MySQL 8.0.12+ (per MySQL 8.0.12 e versioni 8.X successive, incluso MySQL 8.4.X), MariaDB, SingleStore o SingleStore 7+.

  3. Compila i dettagli della connessione. La maggior parte delle impostazioni è comune alla maggioranza dei dialetti di database. Per informazioni, consulta la pagina della documentazione Connessione di Looker al tuo database.

  4. Per verificare che la connessione sia riuscita, fai clic sul pulsante Test Connection (Verifica connessione) nella sezione Status details (Dettagli stato) in fondo alla pagina Connections Settings (Impostazioni connessioni).

  5. Se Looker visualizza Can Connect (Connessione possibile), premi Connect (Connetti) per creare la connessione.

La connessione al tuo database viene quindi aggiunta all'elenco della pagina Connections (Connessioni) di Admin (Amministrazione) di Looker.

Parametri JDBC supportati

Per MySQL, MariaDB e SingleStore, Looker supporta i seguenti parametri JDBC nel campo Parametri JDBC aggiuntivi per la connessione. Per informazioni su questi parametri, consulta la documentazione del tuo database.

  • allowMultiQueries
  • autocommit
  • characterSetResults
  • clientCertificateKeyStorePassword
  • clientCertificateKeyStoreUrl
  • connectionAttributes
  • connectionCollation
  • connectionTimeZone
  • connectTimeout
  • defaultAuthenticationPlugin
  • disableSslHostnameVerification
  • disconnectOnExpiredPasswords
  • enabledSslCipherSuites
  • failOverReadOnly
  • fallbackToSystemTrustStore
  • forceConnectionTimeZoneToSession
  • interactiveClient
  • lookerFailover
  • maxIdleTime
  • maxQuerySizeToLog
  • oldModeNoPrecisionTimestamp
  • password
  • passwordCharacterEncoding
  • permitMysqlScheme
  • pinGlobalTxToPhysicalConnection
  • preserveInstants
  • queryInterceptors
  • restrictedAuth
  • rewriteBatchedStatements
  • socketTimeout
  • sslMode
  • tcpKeepAlive
  • trustCertificateKeyStorePassword
  • trustCertificateKeyStoreUrl
  • useCompression
  • usePipelineAuth
  • user
  • useServerPrepStmts
  • verifyServerCertificate
  • yearIsDateType

Funzionalità supportate

Affinché Looker supporti alcune funzionalità, anche il dialetto del database deve supportarle.

A partire da Looker 26.22, MySQL supporta le seguenti funzionalità:

Funzionalità Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Interruzione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli analitici nel database
Calendari personalizzati

MySQL 8.0.12+ supporta le seguenti funzionalità a partire da Looker 26.22:

Funzionalità Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Interruzione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli analitici nel database
Calendari personalizzati

A partire da Looker 26.22, MariaDB supporta le seguenti funzionalità:

Funzionalità Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Interruzione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli analitici nel database
Calendari personalizzati

SingleStore supporta le seguenti funzionalità a partire da Looker 26.22:

Funzionalità Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Interruzione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli analitici nel database
Calendari personalizzati

SingleStore 7+ supporta le seguenti funzionalità a partire da Looker 26.22:

Funzionalità Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Interruzione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Sensibile alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
Credenziali OAuth 2.0
Commenti sul contesto
Pool di connessioni
Sketch HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Modelli analitici nel database
Calendari personalizzati