Siamo lieti di annunciare che l'API Looker 4.0 è disponibile a livello generale in Looker 22.4. L'API 4.0 in disponibilità generale (API 4.0 GA) presenta molteplici modifiche dirompenti e aggiuntive e promuove molteplici endpoint da beta a stabile. Consulta il nostro riferimento API per le specifiche dettagliate dell'API 4.0. Abbiamo aggiornato gli SDK supportati da Looker e dalla community per supportare gli endpoint GA 4.0 dell'API Looker. Per saperne di più, consulta le norme relative al supporto di API e SDK e il controllo delle versioni delle API. Il resto di questo articolo descrive le modifiche che provocano errori, le mitigazioni e le funzionalità che puoi aspettarti quando esegui la migrazione all'API 4.0 GA.
Chi dovrebbe leggerlo?
Questo documento è rivolto a te se utilizzi l'API Looker tramite gli SDK supportati da Looker, quelli supportati dalla community o l'API stessa. Leggi la sezione seguente che corrisponde alla versione dell'API Looker in uso.
Utenti dell'API pre-GA 4.0
Se utilizzi l'API 4.0, leggi questa sezione. Descrive le modifiche che provocano errori e le mitigazioni disponibili quando esegui la migrazione all'API 4.0 GA.
L'API 4.0 GA include la modifica di tutti i campi ID entità dal tipo numerico integer
al tipo string
. Ad esempio, GET /groups/{group_id}
endpoint restituisce id
di tipo string
anziché di tipo int64
.
Leggi la tabella seguente per l'impatto e le mitigazioni specifiche per l'utilizzo dell'endpoint API 4.0:
Utilizzo | Impatto potenziale1 | Prevenzione |
App mobile di Looker | Le installazioni obsolete delle app mobile Looker smetteranno di funzionare | Chiedi agli utenti di eseguire l'aggiornamento alla versione più recente delle app mobile Looker |
SDK2 supportati da Looker | ||
SDK TypeScript (API 4.0) | Nessun impatto | Nessuna azione richiesta |
SDK Python (API 4.0) | Nessun impatto | Nessuna azione richiesta |
SDK Ruby (API 4.0) | Nessun impatto | Nessuna azione richiesta |
SDK2 supportati dalla community | ||
SDK Swift | Eccezioni di runtime | Aggiorna l'SDK alla versione 22.0+ e risolvi gli eventuali errori di tipo risultanti |
SDK Kotlin | Nessun impatto | Nessuna azione richiesta |
SDK Looker | Nessun impatto | Nessuna azione richiesta |
SDK C# | Nessun impatto | Nessuna azione richiesta |
SDK Go | Eccezioni di runtime | Aggiorna l'SDK alla versione 22.0+ e risolvi gli eventuali errori di tipo risultanti |
Altro | ||
Utilizzare l'API 4.0 senza un SDK (o con librerie fornite esternamente) | Possibili errori di runtime, in base alla sensibilità del tipo di lingua | Rivedi il codice per verificare la presenza di dipendenze dal tipo di campi ID e aggiungi il supporto per i campi ID di tipo stringa. Consulta anche queste indicazioni aggiuntive. |
1: presupposto modelli di utilizzo comuni che possono includere l'uso dei campi ID di Looker, ma non modelli di utilizzo insoliti, come l'applicazione di operazioni numeriche agli ID.
2: Supporto per SDK e API Looker. Le librerie supportate dalla community non sono ufficialmente supportate da Looker.
Utenti API 3.1
Se utilizzi l'API 3.1, leggi questa sezione. Descrive le funzionalità e le modifiche aggiuntive messe a tua disposizione dall'API 4.0. Tieni presente che tutti i nostri SDK supportati da Looker e dalla community supportano principalmente l'API 4.0. Per ulteriori informazioni, consulta le norme relative al supporto di SDK e API.
Funzionalità GA aggiuntive dell'API 4.0
Per praticità, elenchiamo le modifiche aggiuntive più importanti e utili all'API 4.0 più importanti:
- Creazione e gestione di consigli, elementi e sezioni del consiglio di amministrazione. Per ulteriori informazioni sulle bacheche, consulta la pagina della documentazione relativa alle bacheche.
- Esegui query aggiuntive su informazioni di connessione come database, schemi, colonne e tabelle. Imposta e aggiorna campi di connessione aggiuntivi.
- Creazione e gestione di app OAuth e utenti. Per ulteriori informazioni su OAuth, consulta la pagina della documentazione relativa a OAuth.
- Cerca i gruppi con gerarchia e ruoli.
- Cerca ruoli con conteggio utenti.
- Ottieni e configura le impostazioni dell'istanza Looker. Per ulteriori informazioni sulle impostazioni, consulta la pagina della documentazione relativa alle impostazioni.
- Creazione e gestione degli avvisi. Per ulteriori informazioni sugli avvisi, consulta la pagina della documentazione sugli avvisi.
- Creazione, gestione e test di tunnel SSH e server SSH. Per ulteriori informazioni su SSH, consulta la pagina della documentazione relativa a SSH.
- Spostare e copiare le dashboard.
- Ottieni URL relativi per le nuove dashboard.
- Spostare e copiare i Look.
- Incorporamento firmato e secret di incorporamento non firmato, URL, nonché creazione e gestione degli utenti.
- Ottieni il token di aggiornamento per aggiornare il token di accesso per l'accesso.
- Limita e compensa i risultati ottenuti con tutti i modelli LookML e tutti gli utenti.
- Limita e compensa i risultati della ricerca di utenti.
- Ottieni le specifiche dell'API dell'istanza Looker in Swagger 2.x JSON.
Modifiche relative al ritiro GA 4.0
L'API 4.0 GA sostituisce diversi endpoint API 3.1 deprecati con funzionalità migliorate. Di seguito sono elencati gli endpoint interessati:
- Gli endpoint della home page deprecati sono stati rimossi. Utilizza gli endpoint della bacheca anziché le home page. Vedi Presentare contenuti tramite bacheche.
- Gli endpoint dello spazio deprecati sono stati rimossi. Utilizza gli endpoint delle cartelle anziché lo spazio. Vedi Organizzazione e gestione dell'accesso ai contenuti.
Utenti dell'API 3.0
L'API 3.0 è ritirata e ti consigliamo di eseguire la migrazione all'API 4.0.
- Per semplificare lo sviluppo, solo l'API 4.0 supporta tutti gli SDK supportati da Looker e dalla community. Consulta il nostro repository SDK.
- L'API 4.0 introduce vari miglioramenti e nuove funzionalità come elencato nella sezione Funzionalità aggiuntive dell'API 4.0 GA in questa pagina.
Conclusione
Puoi aspettarti l'aggiunta di nuove funzionalità e modifiche aggiuntive all'API 4.0 e puoi sempre trovare le modifiche più recenti nel nostro riferimento API. Per saperne di più, consulta le norme relative al supporto di API e SDK e il controllo delle versioni delle API. Sappiamo che i cambiamenti radicali non sono l'ideale. A meno che non si verifichi un problema estremo, non apporteremo modifiche che provocano errori alla nostra API 4.0 in disponibilità generale. Ci auguriamo che la nostra API Looker 4.0 in disponibilità generale ti aiuti a sviluppare in modo più produttivo e semplice sulla piattaforma Looker.