Disponibilità generale dell'API Looker 4.0

Siamo felici di annunciare che l'API Looker 4.0 è disponibile pubblicamente in Looker 22.4. L'API 4.0 in disponibilità generale (API 4.0 GA) presenta diverse modifiche che causano interruzioni e aggiuntive e promuove più endpoint dalla versione beta alla versione 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 dell'API Looker 4.0 GA. 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 si rivolge questo articolo?

Questo documento è rivolto agli utenti che utilizzano l'API Looker tramite gli SDK supportati da Looker, gli SDK supportati dalla community o l'API stessa. Leggi la sezione seguente che corrisponde alla versione dell'API Looker che utilizzi.

Utenti dell'API 4.0 pre-GA

Se utilizzi l'API 4.0, leggi questa sezione. Vengono illustrate le modifiche che causano interruzioni 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 come tipo string anziché come tipo int64.

Consulta la tabella seguente per l'impatto e le mitigazioni specifiche per l'utilizzo dell'endpoint dell'API 4.0:

Utilizzo	Impatto potenziale^1	Prevenzione
App mobile Looker	Le installazioni obsolete delle app mobile Looker smettono di funzionare	Chiedi agli utenti di eseguire l'aggiornamento all'ultima versione delle app mobile Looker
SDK supportati da Looker^2
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 community^2
SDK Swift	Eccezioni di runtime	Aggiorna l'SDK alla versione 22.0 o successive, quindi risolvi 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 eventuali errori di tipo risultanti
Altro
Utilizzo dell'API 4.0 senza un SDK (o con librerie fornite esternamente)	Possibili errori di runtime, a seconda della sensibilità al tipo del linguaggio	Esamina il codice per le dipendenze dal tipo di campi ID e aggiungi il supporto per i campi ID di tipo stringa. Consulta anche queste indicazioni aggiuntive.

1: presupponendo pattern di utilizzo comuni che potrebbero includere l'utilizzo dei campi ID di Looker, ma non pattern di utilizzo insoliti come l'applicazione di operazioni numeriche agli ID.

assistenza per l'API e l'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 saperne di più, consulta le norme di assistenza per SDK e API.

Funzionalità aggiuntive dell'API 4.0 GA

Per comodità, di seguito sono elencate le modifiche aggiuntive più importanti e utili dell'API 4.0:

• Creazione e gestione di schede, elementi della scheda e sezioni della scheda. Per saperne di più sulle schede, consulta la pagina della documentazione relativa alle schede.
• Esegui query su informazioni di connessione aggiuntive, come database, schemi, colonne e tabelle. Imposta e aggiorna i campi di connessione aggiuntivi.
• Creazione e gestione di utenti e app OAuth. Per saperne di più su OAuth, consulta la pagina della documentazione relativa a OAuth.
• Cerca gruppi con gerarchia e ruoli.
• Cerca i ruoli con il conteggio degli utenti.
• Recupera e imposta le impostazioni dell'istanza Looker. Per saperne di più sulle impostazioni, consulta la pagina della documentazione relativa alle impostazioni.
• Creazione e gestione degli avvisi. Per saperne di più sugli avvisi, consulta la pagina della documentazione relativa agli avvisi.
• Creazione, gestione e test di tunnel e server SSH. Per saperne di più su SSH, consulta la pagina della documentazione relativa a SSH.
• Sposta e copia le dashboard.
• Recupera gli URL relativi per le nuove dashboard.
• Sposta e copia i Look.
• Creazione e gestione di secret, URL e utenti di incorporamento firmati e non firmati.
• Recupera il token di aggiornamento per aggiornare il token di accesso.
• Limita e compensa i risultati ottenuti da tutti i modelli LookML e tutti gli utenti.
• Limita e compensa i risultati da ricerca utenti.
• Recupera la specifica dell'API dell'istanza Looker in Swagger 2.x JSON.

Modifiche di ritiro dell'API 4.0 GA

L'API 4.0 GA sostituisce diversi endpoint dell'API 3.1 ritirati con funzionalità migliorate. Sono interessati i seguenti endpoint:

• Gli endpoint della home page ritirati sono stati rimossi. Utilizza gli endpoint della scheda anziché le home page. Consulta Presentazione dei contenuti con le schede.
• Gli endpoint dello spazio ritirati sono stati rimossi. Utilizza gli endpoint della cartella anziché lo spazio. Consulta 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.

• 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 indicato nella sezione Funzionalità aggiuntive dell'API 4.0 GA in questa pagina.

Conclusione

Puoi aspettarti nuove funzionalità e modifiche aggiuntive che verranno aggiunte 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 causano interruzioni non sono l'ideale. A meno che non si verifichi un problema grave, non apporteremo modifiche che causano interruzioni all'API 4.0 in disponibilità generale. Ci auguriamo che l'API Looker 4.0 in disponibilità generale ti aiuti a sviluppare in modo più produttivo e semplice sulla piattaforma Looker.