Siamo lieti di annunciare che l'API Looker 4.0 è disponibile a livello generale in Looker 22.4. L'API 4.0 disponibile a livello generale (API 4.0 GA) presenta più modifiche che richiedono l'interruzione del servizio e aggiuntive e promuove più endpoint dalla versione beta a quella stabile. Consulta il nostro riferimento API per 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 saperne di più, consulta le norme relative all'assistenza per API e SDK e la pagina Versionamento API. Il resto di questo articolo illustra le modifiche non compatibili, le mitigazioni e le funzionalità che puoi aspettarti durante la migrazione all'API GA 4.0.
Per chi è pensata questa pagina?
Questo documento è rivolto a chi utilizza l'API Looker tramite SDK supportati da Looker, SDK supportati dalla community o l'API stessa. Leggi la sezione seguente relativa alla versione dell'API Looker che utilizzi.
Utenti dell'API 4.0 pre-GA
Se utilizzi l'API 4.0, leggi questa sezione. Copre le modifiche incompatibili e le mitigazioni disponibili durante la migrazione all'API 4.0 GA.
La versione GA dell'API 4.0 include la modifica di tutti i campi ID entità dal tipo numerico integer al tipo string. Ad esempio, l'endpoint GET /groups/{group_id} restituisce id come tipo string anziché int64.
Leggi la tabella seguente per conoscere l'impatto e le misure di mitigazione specifiche per l'utilizzo dell'endpoint dell'API 4.0:
| Utilizzo | Impatto potenziale1 | Prevenzione |
| App mobile di Looker | Le installazioni obsolete delle app mobile di Looker smettono di funzionare | Chiedi agli utenti di eseguire l'aggiornamento alla versione più recente delle app mobile di Looker |
| SDK supportati da2 Looker | ||
| SDK TypeScript (API 4.0) | Nessun impatto | Nessuna azione necessaria |
| SDK Python (API 4.0) | Nessun impatto | Nessuna azione necessaria |
| SDK Ruby (API 4.0) | Nessun impatto | Nessuna azione necessaria |
| SDK supportati dalla community2 | ||
| SDK Swift | Eccezioni di runtime | Aggiorna l'SDK alla versione 22.0 o successive, quindi risolvi gli eventuali errori di tipo risultanti |
| SDK Kotlin | Nessun impatto | Nessuna azione necessaria |
| SDK LookR | Nessun impatto | Nessuna azione necessaria |
| SDK C# | Nessun impatto | Nessuna azione necessaria |
| SDK Go | Eccezioni di runtime | Aggiorna l'SDK alla versione 22.0 o successive, quindi 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, a seconda della sensibilità al tipo di linguaggio | Esamina il codice per verificare le dipendenze dal tipo di campi ID e aggiungi il supporto per i campi ID di tipo stringa. Consulta anche queste linee guida aggiuntive. |
1: si presumeno modelli di utilizzo comuni che possono includere l'utilizzo dei campi ID di Looker, ma non modelli di utilizzo insoliti come l'applicazione di operazioni numeriche agli ID.
2: Assistenza per l'API e l'SDK di Looker. Le librerie supportate dalla community non sono supportate ufficialmente da Looker.
Utenti dell'API 3.1
Se utilizzi l'API 3.1, leggi questa sezione. Copre 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 all'assistenza per SDK e API.
Ulteriori funzionalità GA dell'API 4.0
Per comodità, di seguito sono elencate le modifiche più importanti e utili dell'API 4.0 additiva:
- Creazione e gestione di bacheche, elementi della bacheca e sezioni della bacheca. Per ulteriori informazioni sulle bacheche, consulta la pagina della documentazione relativa alle bacheche.
- Esegui query su ulteriori informazioni di connessione, ad esempio database, schemi, colonne e tabelle. Imposta e aggiorna altri campi di connessione.
- Creazione e gestione di app e utenti OAuth. Per ulteriori informazioni su OAuth, consulta la pagina della documentazione di OAuth.
- Cerca gruppi con gerarchia e ruoli.
- Cerca i ruoli con il numero di utenti.
- Ottieni e imposta 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 di SSH.
- Sposta e copia le dashboard.
- Ottieni gli URL relativi per le nuove dashboard.
- Sposta e copia i Look.
- Incorporamento firmato e secret di incorporamento non firmato, URL e creazione e gestione degli utenti.
- Ottieni il token di aggiornamento per aggiornare il token di accesso.
- Limita e compensa i risultati ottenuti da tutti i modelli LookML e da tutti gli utenti.
- Limita e compensa i risultati provenienti dagli utenti che effettuano ricerche.
- Ottieni le specifiche dell'API istanza Looker in JSON Swagger 2.x.
Modifiche al ritiro dell'API 4.0 in versione GA
La versione GA dell'API 4.0 sostituisce diversi endpoint dell'API 3.1 deprecati con funzionalità migliorate. Sono interessati i seguenti endpoint:
- Gli endpoint della home page obsoleti sono stati rimossi. Utilizza gli endpoint delle bacheche anziché le home page. Consulta l'articolo Presentare i contenuti con le bacheche.
- Gli endpoint di Space deprecati sono stati rimossi. Utilizza gli endpoint delle cartelle anziché Spazio. Consulta Organizzare e gestire l'accesso ai contenuti.
Utenti dell'API 3.0
L'API 3.0 è obsoleta e ti consigliamo di eseguire la migrazione all'API 4.0.
- Solo l'API 4.0 supporta tutti gli SDK supportati da Looker e dalla community per semplificare lo sviluppo. Consulta il nostro repository SDK.
- L'API 4.0 introduce diverse nuove funzionalità e miglioramenti, come elencato nella sezione Funzionalità GA aggiuntive dell'API 4.0 di questa pagina.
Conclusione
Puoi aspettarti nuove funzionalità e modifiche additive all'API 4.0 e puoi sempre trovare le modifiche più recenti nel nostro riferimento API. Per saperne di più, consulta le norme relative all'assistenza per API e SDK e la pagina Versionamento API. Sappiamo che le modifiche che provocano un errore non sono ideali. A meno che non si verifichi un problema estremo, non apporteremo modifiche che comportino interruzioni all'API 4.0 in disponibilità generale. Ci auguriamo che la nostra API Looker 4.0 disponibile a livello generale ti aiuti a sviluppare più facilmente e in modo più produttivo sulla piattaforma Looker.