Puoi connettere i tuoi database PostgreSQL a Data Studio per visualizzare e analizzare i tuoi dati. Utilizza il connettore PostgreSQL per trasformare i tuoi dati in dashboard e report interattivi. Puoi quindi condividere i tuoi insight con il tuo team o con gli stakeholder che non hanno accesso diretto al database.
Versioni supportate
Abbiamo provato Data Studio con le seguenti versioni di PostgreSQL:
- 9,6
- 10
- 11
- 12
- 13
- 14
Se hai problemi quando utilizzi una versione supportata, contattaci attraverso la community di Data Studio. Puoi anche aggiungere richieste di funzionalità e votare per quelle esistenti nell'Issue Tracker.
Come collegarsi a PostgreSQL
Il connettore PostgreSQL utilizza il driver JDBC PostgreSQL per collegare un'origine dati di Data Studio a una singola tabella di database PostgreSQL o a una query personalizzata fornita da te.
Per connetterti al database PostgreSQL:
- Accedi a Data Studio.
- Nella home page di Data Studio, fai clic su Crea e poi seleziona Origine dati.
- Seleziona il connettore PostgreSQL.
- Se richiesto, autorizza Data Studio ad accedere ai tuoi dati.
- 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
Connettiti utilizzando un nome host o un indirizzo IP
Nel riquadro di connessione, seleziona STANDARD. Inserisci i dettagli della connessione:
- Nome host o indirizzo IP
- Porta (facoltativo)
- Database
- Nome utente
- Password
Connettiti utilizzando un URL JDBC
Nel riquadro di connessione, seleziona URL JDBC. Inserisci i dettagli della connessione:
- URL JDBC
Esempio
jdbc:postgresql://HOSTNAME[:PORT]/DATABASE_NAMEPer Cloud SQL (IP privato)
jdbc:google:postgresql://< var>INSTANCE_CONNECTION_NAME/DATABASE_NAME
- Nome utente
- Password
Per connetterti utilizzando un indirizzo letterale IPv6, racchiudi l'indirizzo tra parentesi quadre. Ad esempio:
jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db
Connettiti utilizzando SSL
Data Studio supporta le connessioni sicure (criptate) al server tramite il protocollo TLS (Transport Layer Security) (TLS 1.2). Il protocollo TLS viene denominato anche SSL (Secure Sockets Layer).
Per attivare una connessione sicura, seleziona Abilita SSL e specifica i file di configurazione SSL.
Connettiti utilizzando l'autenticazione client
Quando la casella Abilita autenticazione client è selezionata, puoi caricare una chiave privata del client e un certificato client se questi ultimi sono necessari per accedere al tuo database.
Scopri di più sulle connessioni sicure di PostgreSQL.
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, Collega la nuova tabella nell'origine dati.
Tipi di dati supportati
Il connettore PostgreSQL supporta i seguenti tipi di dati:
- Numerico
- Basato su caratteri
- Booleano
- Data/ora (tranne gli intervalli)
Data Studio non crea campi per colonne di tipo non supportato.
Scopri di più sui tipi di dati di PostgreSQL.
Connessioni pubbliche e private
Data Studio supporta le connessioni IP pubbliche e private a PostgreSQL su Cloud SQL.
Per connetterti a un'istanza Cloud SQL per PostgreSQL utilizzando un IP privato, verifica i seguenti requisiti:
- Autorizzazioni di Identity and Access Management (IAM): concedi il ruolo IAM Cloud SQL Client (
roles/cloudsql.client) al progetto Google Cloudche contiene l'istanza Cloud SQL. Devi concedere questo ruolo all'account utente che autentica la connessione in Data Studio o al proprietario delle credenziali dell'origine dati. Se l'origine dati utilizza le credenziali del visualizzatore, assegna questo ruolo a ogni visualizzatore del report. - Impostazioni dell'istanza: seleziona l'opzione Percorso privato per i servizi Google Cloud nelle impostazioni dell'istanza Cloud SQL.
URL JDBC: nel riquadro di connessione, seleziona l'opzione di connessione URL JDBC e inserisci la stringa di connessione nel seguente formato:
jdbc:google:postgresql://INSTANCE_CONNECTION_NAME/DATABASE_NAME
Sostituisci quanto segue:
INSTANCE_CONNECTION_NAME: il nome della connessione dell'istanza nel formatoPROJECT_ID:REGION:INSTANCE_IDDATABASE_NAME: il nome del tuo database PostgreSQL
Ad esempio:
jdbc:google:postgresql://my-project:us-central1:my-instance/my-dbNon aggiungere il nome o l'ID dell'organizzazione come prefisso alla stringa di connessione e rimuovi eventuali spazi dall'URL.
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 invece i seguenti indirizzi:
142.251.56.0/242001:4860:4815::/48(facoltativo per le piattaforme che supportano IPv6)
Limiti del connettore PostgreSQL
Il connettore PostgreSQL non utilizza il proxy Cloud SQL per la connessione alle istanze PostgreSQL di Cloud SQL. Se ti connetti a un'istanza PostgreSQL di Cloud SQL utilizzando un IP pubblico, dovrai aggiungere gli IP indicati all'elenco delle reti autorizzate. Consulta la documentazione di Cloud SQL.
La connessione alle origini dati AlloyDB tramite SSL non è supportata, poiché AlloyDB non supporta l'esportazione dei certificati dell'autorità di certificazione (CA).
La selezione di una tabella esterna allo schema
publicnon è supportata. Tuttavia, puoi selezionare l'opzione QUERY PERSONALIZZATA per scrivere una query che includa tabelle in qualsiasi schema.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.