OpenSearch
Esegui query SQL in sola lettura sul tuo cluster OpenSearch e porta i risultati nel foglio.
Il connettore OpenSearch esegue una query SQL di tua scelta, in sola lettura, su un cluster OpenSearch che gestisci tu: non richiede OAuth, usa host, porta, utente e password che inserisci al momento della connessione. Usa il plugin SQL integrato di OpenSearch (non un driver JDBC, e non il linguaggio di query JSON nativo di OpenSearch), quindi scrivi una normale query SQL specificando l'indice direttamente nella clausola FROM (es. SELECT * FROM mio_indice) - non c'è un "database" separato da scegliere al momento della connessione.
Non è ammessa nessuna query diversa da SELECT (anche precedute da WITH): niente DELETE o altre operazioni di scrittura, verificato prima di ogni esecuzione.
Campi array: se un campo del tuo indice contiene più valori (un array), il connettore li unisce in un unico testo separato da virgole quando scrive il report, perché una cella del foglio non può contenere una lista nativa.
Suggerimento per aggiornamenti giornalieri: per scaricare automaticamente solo i dati nuovi ogni giorno (es. con uno schedule e "Append new results to old" attivo), non serve nessun meccanismo speciale: scrivi direttamente nella query una condizione su un campo data, calcolata al momento dell'esecuzione, ad esempio WHERE event_datetime >= NOW() - INTERVAL 1 DAY. La query salvata resta sempre la stessa stringa, ma il risultato cambia ogni giorno perché la condizione viene calcolata quando il report viene eseguito, non quando scrivi la query una volta.
Metriche disponibili
Non esistono metriche o dimensioni fisse: le colonne del report sono esattamente le colonne restituite dalla tua query SQL (i nomi delle colonne o degli alias usati nella SELECT).
Limiti noti
- Solo query SELECT (o WITH)Una sola istruzione per query, niente DELETE o altre operazioni di scrittura: verificato prima di ogni esecuzione. Da notare che il plugin SQL di OpenSearch supporta nativamente anche DELETE oltre a SELECT, quindi questo controllo è l'unico argine reale, non solo una precauzione aggiuntiva. Una query che non supera il controllo mostra un errore invece di essere eseguita.
- Nessun test al momento della connessioneLa pagina di connessione salva i dati inseriti senza verificarli: il test vero avviene la prima volta che selezioni quella connessione per configurare un report, non quando la crei.
- Il server deve essere raggiungibile da internetNon funziona con reti locali o dietro VPN. Usa il plugin SQL di OpenSearch via HTTP (non JDBC), che deve essere abilitato sul cluster (attivo di default): il firewall del server deve autorizzare gli intervalli IP pubblicati da Google su gstatic.com/ipranges/goog.json, e la porta deve essere 1025 o superiore (9200 standard va bene).
- HTTP di default, con opzione HTTPSDi default la connessione usa HTTP semplice (porta 9200). Se il tuo server OpenSearch richiede una connessione cifrata — comune sui servizi gestiti, che di solito la richiedono — spunta "Usa HTTPS" al momento della connessione. Usa sempre un utente dedicato con permessi di sola lettura, indipendentemente da questa impostazione.