Siamo felici 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 diverse modifiche additive e che causano interruzioni e promuove più endpoint dalla versione beta a quella 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 dell'API Looker 4.0. Per saperne di più, consulta le norme di assistenza per API e SDK e il controllo delle versioni delle API. Il resto di questo articolo descrive le modifiche che causano interruzioni, le mitigazioni e le funzionalità che puoi aspettarti quando esegui la migrazione all'API 4.0 GA.
A chi è destinato questo articolo?
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 che corrisponde alla versione dell'API Looker che utilizzi.
API Users 4.0 pre-GA
Se utilizzi l'API 4.0, leggi questa sezione. Vengono descritte le modifiche che causano interruzioni e le mitigazioni disponibili quando esegui 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é come tipo int64.
Consulta la tabella riportata di seguito 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 Looker smettono di funzionare | Chiedi agli utenti di eseguire l'aggiornamento all'ultima versione dell'app mobile Looker |
| SDK 2 supportati da Looker | ||
| SDK TypeScript (API 4.0) | Nessun impatto | Nessuna azione necessaria |
| SDK Python (API 4.0) | Nessun impatto | Nessuna azione necessaria |
| Ruby SDK (API 4.0) | Nessun impatto | Nessuna azione necessaria |
| SDK 2 supportati dalla community | ||
| SDK Swift | Eccezioni di runtime | Aggiorna l'SDK alla versione 22.0 o successive, quindi risolvi gli errori di tipo risultanti, se presenti. |
| 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 errori di tipo risultanti, se presenti. |
| Altro | ||
| Utilizzo dell'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 indicazioni aggiuntive. |
1: Supponendo schemi di utilizzo comuni che possono includere l'utilizzo dei campi ID di Looker, ma non schemi di utilizzo insoliti come l'applicazione di operazioni numeriche agli ID.
2: Supporto dell'API e dell'SDK 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. Vengono illustrate le funzionalità e le modifiche aggiuntive 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 ulteriori informazioni, consulta le norme di assistenza per SDK e API.
Funzionalità GA aggiuntive dell'API 4.0
Per comodità, elenchiamo le modifiche più importanti e utili dell'API 4.0 aggiuntiva:
- Creazione e gestione di bacheche, elementi della bacheca e sezioni della bacheca. Per ulteriori informazioni sulle bacheche, consulta la pagina di documentazione delle bacheche.
- Esegui query su ulteriori informazioni di connessione, come database, schemi, colonne e tabelle. Imposta e aggiorna i campi di connessione aggiuntivi.
- Creazione e gestione di app e utenti OAuth. Per saperne di più su OAuth, consulta la pagina della documentazione di OAuth.
- Cerca gruppi con gerarchia e ruoli.
- Cerca ruoli con conteggio utenti.
- Recupera 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 saperne di più sugli avvisi, consulta la pagina di documentazione relativa agli avvisi.
- Creazione, gestione e test di tunnel SSH e server SSH. Per saperne di più su SSH, consulta la pagina della documentazione SSH.
- Spostare e copiare le dashboard.
- Ottenere 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 di login.
- Limita e compensa i risultati ottenuti da tutti i modelli LookML e tutti gli utenti.
- Limita e compensa i risultati della ricerca degli utenti.
- Scarica la specifica dell'API dell'istanza Looker in Swagger 2.x JSON.
Modifiche al ritiro della disponibilità generale dell'API 4.0
L'API 4.0 GA sostituisce diversi endpoint API 3.1 deprecati con funzionalità migliorate. Sono interessati i seguenti endpoint:
- Gli endpoint della home page obsoleti sono stati rimossi. Utilizza gli endpoint della bacheca anziché le home page. Consulta Presentare contenuti con le bacheche.
- Gli endpoint Space deprecati sono stati rimossi. Utilizza gli endpoint delle cartelle anziché Spazio. Vedi Organizzazione e gestione dell'accesso ai contenuti.
Utenti 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, elencati nella sezione Funzionalità aggiuntive di GA dell'API 4.0 di questa pagina.
Conclusione
Puoi aspettarti nuove funzionalità e modifiche additive da aggiungere all'API 4.0 e puoi sempre trovare le ultime modifiche nel nostro riferimento API. Per saperne di più, consulta le norme di assistenza per 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 sostanziali alla nostra API 4.0 in disponibilità generale. Ci auguriamo che l'API Looker 4.0, disponibile a livello generale, ti aiuti a sviluppare in modo più produttivo e semplice sulla piattaforma Looker.