Looker fornisce più versioni dell'API e più SDK di linguaggio che utilizzano queste API. Questo documento descrive lo stato e le norme di assistenza per le versioni dell'API Looker e gli SDK di linguaggio.
Livelli di assistenza
Le versioni dell'API Looker e degli SDK hanno livelli di supporto diversi:
I livelli di assistenza sono descritti nelle sezioni seguenti.
Supporto di Looker
Looker supporta queste versioni dell'API e questi SDK di linguaggio. I ticket di assistenza possono essere inviati all'assistenza Looker e devono essere conformi alle linee guida per l'assistenza Looker. È supportata solo l'API 4.0 di Looker.
Supporto della community
Questo livello si applica solo agli SDK per le lingue. I problemi vengono registrati e gestiti nel repository open source utilizzato per l'SDK.
Un SDK linguistico può essere a livello di supporto della community per diversi motivi:
- Non dispone delle funzionalità necessarie per raggiungere il livello supportato da Looker.
- Prima di poter essere completamente supportato da Looker, ha bisogno di più infrastrutture di supporto e automazione (test automatizzati, packaging, documentazione, esempi e così via).
- Si basa su una tecnologia ritirata.
- Non è stato testato da un numero sufficiente di utenti diversi per essere considerato pronto a uscire dallo stato "alpha".
Non supportata
Non viene fornita assistenza. Le versioni 3.0 e 3.1 dell'API non sono supportate.
Versioni API
La tabella seguente elenca le tre versioni dell'API documentate a partire da Looker 22.4 e mostra i relativi livelli di supporto.
| Versione | Assistenza | Stato | Descrizione |
|---|---|---|---|
| 3,0 | Non supportata | Rimosso | Questa API è stata rimossa da Looker. |
| 3.1 | Non supportata | Rimosso | Questa API è stata rimossa da Looker. |
| 4.0 | Looker | Stabile | Release attuale. È comunque possibile aggiungere nuovi endpoint, argomenti e proprietà della struttura. Tutti gli SDK per i linguaggi Looker supportati utilizzano l'API 4.0. |
Le versioni future dell'API verranno introdotte come alpha e poi passeranno attraverso i cicli di vita beta, stabile e deprecato.
SDK in più linguaggi
Gli SDK per linguaggi di Looker si sono evoluti nel corso della vita di Looker e sono prodotti con una varietà di strumenti e tecniche. Tutti gli SDK utilizzano direttamente o indirettamente i documenti delle specifiche API di Looker. Lo stato di supporto degli SDK per le lingue è descritto nella tabella seguente.
| Lingua | Assistenza | Strumenti | Descrizione |
|---|---|---|---|
| Ruby | Looker | Scritta a mano | L'SDK Ruby attuale legge la specifica dell'API Looker per costruire dinamicamente i metodi dell'SDK. |
| Python | Looker | codegen | L'SDK Python viene utilizzato ovunque sia possibile utilizzare Python. Consulta il file Readme dell'SDK Python per le informazioni più recenti sulle versioni di Python supportate. |
| TypeScript | Looker | codegen | L'SDK TypeScript viene utilizzato sia per le applicazioni node che per quelle browser. |
| Kotlin | Community | codegen | L'SDK Kotlin viene utilizzato per le applicazioni mobile Android e Java Virtual Machine (JVM). |
| Swift | Community | codegen | L'SDK Swift viene utilizzato per le applicazioni iOS e macOS. |
| R | Community | Swagger | LookR è l'SDK Looker per il linguaggio di programmazione R e funziona con R Studio. |
| Altro | Community | codegen | Altri SDK di linguaggi generati dal progetto codegen di Looker, come C# (Look#) e Go (GoLook), sono supportati dalla community. I problemi devono essere segnalati nel repository sdk-codegen. |
Legenda degli strumenti
- codegen: generato dal progetto SDK codegen di Looker e utilizza una libreria di runtime scritta a mano per ogni SDK.
- Swagger: generato dallo strumento open source Swagger Code Generator. Per i linguaggi di programmazione non supportati direttamente dal generatore di codice di Looker, abbiamo fornito un'opzione di generatore legacy nel repository codegen che dovrebbe semplificare la generazione personalizzata. Questo generatore "legacy" utilizza il generatore di codice OpenAPI open source, che sostituisce il generatore di codice Swagger.
- Scritto a mano: tutto il codice sorgente è scritto a mano senza generazione di codice.
Controllo delle versioni dell'SDK
Di recente Looker ha adottato uno schema di controllo delle versioni che associa gli SDK di linguaggio alla release di Looker utilizzata per generarli. Ad esempio, un SDK prodotto utilizzando le specifiche di Looker 21.10 avrà una versione che inizia con 21.10.*.
SDK in più linguaggi
Gli SDK per i linguaggi più recenti (prodotti da Looker codegen) corrispondono alle versioni di rilascio di Looker. Ad esempio, gli SDK Python e TypeScript corrispondono alle rispettive versioni di rilascio di Looker.
Man mano che spostiamo gli SDK per linguaggi precedenti su codegen o pubblichiamo gli SDK codegen esistenti nei relativi gestori di pacchetti, la versione dell'SDK verrà impostata in modo che corrisponda alla versione di rilascio di Looker.
Versioni del pacchetto della libreria runtime
L'SDK TypeScript dipende da un pacchetto di librerie di runtime (RTL) separato, scritto da Looker, che supporta genericamente le API REST. Poiché non è specifico per nessuna release di Looker, questo pacchetto ha una versione indipendente dagli SDK per i linguaggi che lo utilizzano.
Quando gli SDK in altre lingue vengono pubblicati nei gestori di pacchetti, i relativi RTL potrebbero diventare un pacchetto separato. Qualsiasi pacchetto RTL separato utilizzerà il controllo delle versioni semantico anziché corrispondere alle versioni di rilascio di Looker.