Puoi connettere i tuoi database Cloud SQL per MySQL a Data Studio utilizzando il connettore Cloud SQL per MySQL. Utilizza le tabelle di database o le query personalizzate per creare report e dashboard interattivi. Puoi quindi condividere questi approfondimenti con le parti interessate o i membri del team che non hanno accesso diretto al database.
Versioni supportate
Il connettore Cloud SQL per MySQL è stato testato sulle seguenti versioni di MySQL:
- 5,6
- 5,7
- 8,0
Se riscontri problemi durante l'utilizzo di una versione supportata, contattaci nella community di Data Studio. Puoi anche aggiungere richieste di funzionalità e votare per quelle esistenti nel tracker dei problemi.
Come connettersi a Cloud SQL per MySQL
Un'origine dati Data Studio può connettersi a una singola tabella di database Cloud SQL per MySQL o a una query personalizzata fornita da te.
Per connetterti al database Cloud SQL per MySQL:
- Accedi a Data Studio.
- Nella home page di Data Studio, fai clic su Crea e poi seleziona Origine dati.
- Seleziona il connettore Cloud SQL per MySQL.
- Configura l'accesso al tuo database utilizzando una delle opzioni di connessione.
- Fai clic su AUTHENTICATE. Viene visualizzato un elenco delle tabelle del database.
- Seleziona una tabella nell'elenco o inserisci una query personalizzata.
- Fai clic su COLLEGA.
Ora puoi accedere a tutte le colonne della tabella come campi nei tuoi report.
Opzioni di connessione
Connettersi utilizzando un nome host o un indirizzo IP
Nel riquadro di connessione, seleziona BASE. Inserisci i dettagli della connessione:
- Nome connessione istanza
- Database
- Nome utente
- Password
Connettersi utilizzando un URL JDBC
Nel riquadro di connessione, seleziona URL JDBC. Inserisci i dettagli della connessione:
- URL JDBC
Esempio
jdbc:google:mysql://INSTANCE_CONNECTION_NAME/DATABASE
- Nome utente
- Password
Per connetterti utilizzando un indirizzo letterale IPv6, racchiudi l'indirizzo tra parentesi quadre. Ad esempio:
jdbc:google:mysql://[2001:db8:1:1:1:1:1:1]/your_db
Query personalizzata
Seleziona l'opzione QUERY PERSONALIZZATA per fornire una query SQL anziché connetterti a una singola tabella. Data Studio utilizza questa query SQL personalizzata come un'istruzione di selezione interna per ogni query generata inviata al database.
Le query SQL personalizzate possono avere una sola istruzione. Ad esempio, la query seguente non funziona perché contiene più istruzioni SQL:
DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;
SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;
Le query in Data Studio potrebbero scadere dopo 3-5 minuti. Se le query personalizzate scadono, prova ad adottare i seguenti approcci per risolvere il problema:
- Semplifica la query in modo che venga eseguita più velocemente.
- Esegui la query nel tuo database e archivia i risultati in una tabella distinta, quindi collega la nuova tabella nell'origine dati.
Note
Consulta le sezioni seguenti per informazioni dettagliate su come trovare il nome di connessione istanza, configurare le autorizzazioni richieste e configurare la connettività di rete.
Individuare il nome di connessione istanza
Il nome di connessione istanza identifica l'istanza su Google Cloud. Per visualizzare questo nome, puoi utilizzare la Google Cloud consoleo la riga di comando.
Utilizzare la console
- Vai a https://console.cloud.google.com/sql/instances.
- Fai clic sull'ID istanza a cui vuoi connetterti.
- A sinistra troverai il nome della connessione nella sezione "Connetti a questa istanza".
Utilizzare la riga di comando
Per trovare il nome della connessione utilizzando l'interfaccia a riga di comando di Cloud, utilizza il seguente comando:
gcloud sql instances describe [INSTANCE_NAME] | grep connectionName
Autorizzazioni
Per creare la connessione, devi disporre almeno dell'autorizzazione cloudsql.client nel progetto Cloud SQL per MySQL. Se non hai (o non puoi ottenere) questo accesso, puoi usare il connettore MySQL invece.
Connettività di rete
Il connettore Cloud SQL per MySQL supporta le connessioni alle istanze Cloud SQL per MySQL con connettività con IP pubblico e con IP privato.
Prima di utilizzare il connettore Cloud SQL per MySQL, devi configurare la connettività con IP pubblico o la connettività con IP privato dell'istanza Cloud SQL per MySQL.
Per consentire a Data Studio di accedere ai dati in Cloud SQL ed eseguire query su questi dati tramite una connessione privata, seleziona l'opzione Percorso privato per i servizi Google Cloud nelle impostazioni dell'istanza Cloud SQL per MySQL.
Tipi di dati supportati
Data Studio associa i tipi di dati integrati del database a un set unificato di tipi di dati. Se Data Studio rileva una colonna di tipo non supportato nella tabella o nella query, non crea un campo per tale colonna.Accesso a firewall e database
Per consentire a Data Studio di connettersi ai database protetti da firewall e di eseguire query su questi ultimi, devi aprire l'accesso a uno dei seguenti indirizzi IP. Potrebbe anche essere necessario configurare il database in modo che accetti il traffico da questi indirizzi. Consulta la documentazione del tuo database specifico per istruzioni su come eseguire questa operazione.
Indirizzi IP
I seguenti indirizzi sono riservati all'infrastruttura globale di Data Studio:
142.251.74.0/232001:4860:4807::/48(facoltativo, per le piattaforme che supportano IPv6)
Se hai attivato la residenza dei dati per il tuo abbonamento a Data Studio Pro, utilizza i seguenti indirizzi:
142.251.56.0/242001:4860:4815::/48(facoltativo, per le piattaforme che supportano IPv6)
Limiti del connettore Cloud SQL per MySQL
- Data Studio non supporta le estensioni per dati spaziali di MySQL.
- Con questo connettore puoi eseguire query per un massimo di 150.000 righe per query. Se superi questo limite, i dati verranno troncati.
- Le intestazioni di colonna (nomi di campo) devono utilizzare solo caratteri ASCII. I caratteri non ASCII non sono supportati.
Risoluzione dei problemi
Consulta la guida alla risoluzione dei problemi di Data Studio per un elenco dei messaggi di errore più comuni e dei passaggi per risolverli.