Siamo lieti di annunciare che l'API Looker 4.0 è in disponibilità generale in Looker 22.4. L’API 4.0 (API 4.0 GA) in disponibilità generale ha molteplici modifiche di interruzione e addizione e promuove più endpoint da beta a stabile. Consulta il nostro riferimento API per le specifiche dettagliate dell'API 4.0. Abbiamo aggiornato i nostri SDK supportati da Looker e dalla community per supportare gli endpoint GA dell'API Looker 4.0. Per ulteriori informazioni, consulta le norme di supporto di API e SDK e il controllo delle versioni delle API. Il resto di questo articolo illustra le modifiche che provocano un errore, 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 SDK supportati da Looker, SDK supportati dalla community o l'API stessa. Leggi la sezione seguente mappata alla versione dell'API Looker che utilizzi.
Utenti dell'API pre-GA 4.0
Se utilizzi l'API 4.0, leggi questa sezione. Descrive le modifiche che provocano un errore 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 dell'ID entità dal tipo numerico integer
al tipo string
. Ad esempio, GET /groups/{group_id}
endpoint restituisce id
come tipo string
anziché come tipo int64
.
Leggi la tabella seguente per conoscere l'impatto e le mitigazioni specifiche per l'utilizzo dell'endpoint API 4.0:
Utilizzo | Impatto potenziale1 | Prevenzione |
App mobile Looker | Le installazioni obsolete delle app mobile di Looker smetteranno di funzionare | Chiedere agli utenti di eseguire l'aggiornamento all'ultima versione delle app mobile di Looker |
SDK supportati da Looker2 | ||
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 |
SDK supportati dalla community2 | ||
SDK Swift | Eccezioni di runtime | Aggiorna l'SDK alla versione 22.0+; quindi risolvi eventuali errori di tipo risultanti |
SDK Kotlin | Nessun impatto | Nessuna azione richiesta |
SDK LookerR | Nessun impatto | Nessuna azione richiesta |
SDK C# | Nessun impatto | Nessuna azione richiesta |
SDK Go | Eccezioni di runtime | Aggiorna l'SDK alla versione 22.0+; quindi risolvi eventuali errori di tipo risultanti |
Altro | ||
Utilizzare l'API 4.0 senza un SDK (o con librerie fornite esternamente) | Possibili errori di runtime, a seconda della sensibilità del tipo di lingua | Esamina il codice per individuare le dipendenze relative al tipo di campi ID e aggiungi il supporto per i campi ID di tipo stringa. Leggi anche queste indicazioni aggiuntive. |
1: Ipotizziamo pattern di utilizzo comuni che potrebbero includere l'uso di campi ID di Looker, ma non pattern di utilizzo insoliti come l'applicazione di operazioni numeriche agli ID.
2. Supporto di API e SDK Looker. Le librerie supportate dalla community non sono ufficialmente supportate da Looker.
Utenti dell'API 3.1
Se utilizzi l'API 3.1, leggi questa sezione. Descrive le funzionalità aggiuntive e le modifiche che l'API 4.0 mette a tua disposizione. Tieni presente che tutti gli SDK supportati da Looker e dalla community supportano principalmente l'API 4.0. Per saperne di più, consulta le norme di supporto di SDK e API.
Ulteriori funzionalità GA dell'API 4.0
Per praticità, abbiamo elencato le modifiche più importanti e utili relative all'API additive 4.0:
- Creazione e gestione delle sezioni del tabellone, degli elementi e delle sezioni del tabellone. Per saperne di più sulle lavagne, consulta la pagina della documentazione relativa alle lavagne.
- Esegui query su informazioni aggiuntive sulla connessione come database, schemi, colonne e tabelle. Imposta e aggiorna campi di connessione aggiuntivi.
- Creazione e gestione di app e utenti OAuth. Per saperne di più su OAuth, consulta la pagina della documentazione relativa a OAuth.
- Cerca gruppi con gerarchia e ruoli.
- Cerca ruoli con numero di utenti.
- Ottieni e configura le impostazioni dell'istanza di 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 relativa agli avvisi.
- Creazione, gestione e test di tunnel SSH e server SSH. Per ulteriori informazioni su SSH, consulta la pagina della documentazione SSH.
- Sposta e copia le dashboard.
- Ottenere URL relativi per le nuove dashboard.
- Sposta e copia Look.
- Creazione e gestione di utenti e secret di incorporamento incorporati e non firmati.
- Richiedi il token di aggiornamento per aggiornare il token di accesso di accesso.
- Limita e compensa i risultati derivanti dal recupero di tutti i modelli LookML e di tutti gli utenti.
- Limita e compensa i risultati della ricerca di utenti.
- Scarica le specifiche dell'API dell'istanza di Looker in JSON Swagger 2.x.
Modifiche relative al ritiro di GA API 4.0
L'API 4.0 GA sostituisce diversi endpoint deprecati dell'API 3.1 con funzionalità migliorate. Sono interessati i seguenti endpoint:
- Gli endpoint della home page deprecati sono stati rimossi. Usa gli endpoint della scheda invece delle home page. Vedi Presentare contenuti con le bacheche.
- Gli endpoint dello spazio deprecati sono stati rimossi. Usa gli endpoint delle cartelle anziché lo spazio. Vedi Organizzare e gestire l'accesso ai contenuti.
Utenti dell'API 3.0
L'API 3.0 è deprecata 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 diversi nuovi miglioramenti e funzioni, come elencato nella sezione Funzionalità GA aggiuntive dell'API 4.0 di questa pagina.
Conclusione
Puoi aspettarti l'aggiunta di nuove funzionalità e modifiche additive all'API 4.0 e puoi sempre trovare le modifiche più recenti nel nostro Riferimento API. Per ulteriori informazioni, consulta le norme di supporto di API e SDK e il controllo delle versioni delle API. Sappiamo che le modifiche che provocano un errore non sono l'ideale. A meno che non si verifichi un problema estremo, non apporteremo modifiche che provocano un errore all'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.