Looker fornisce più versioni API e più SDK per i linguaggi che utilizzano queste API. Questo documento descrive lo stato e i criteri di assistenza per le versioni dell'API Looker e gli SDK dei linguaggi.
Livelli di supporto
Le versioni e gli SDK dell'API Looker hanno diversi livelli di assistenza:
I livelli di assistenza sono descritti nelle sezioni seguenti.
Supporto di Looker
Looker supporta queste versioni API e questi SDK per i linguaggi. I ticket di assistenza possono essere presentati all'assistenza Looker e conformi alle linee guida dell'assistenza Looker.
Supportato dalla community
Questo livello si applica solo agli SDK per i linguaggi. I problemi vengono registrati e gestiti nel repository open source utilizzato per l'SDK.
Un SDK per le lingue può essere applicato al livello di assistenza della community per diversi motivi:
- Non dispone delle funzionalità necessarie per raggiungere il livello supportato da Looker.
- Ha bisogno di più infrastruttura di supporto e automazione (test automatici, pacchettizzazione, documentazione, esempi ecc.) prima di poter essere completamente supportata da Looker.
- Si basa su una tecnologia deprecata.
- Non è stato testato da un numero sufficiente di utenti diversi per essere considerato pronto per uscire dallo stato "alpha".
Non supportata
Non viene fornita assistenza. Al momento, solo la versione dell'API 3.0 non è supportata.
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. È ancora in corso la creazione di nuovi endpoint, argomenti e proprietà della struttura, nonché di modifiche ai tipi.La maggior parte degli SDK per il linguaggio di Looker utilizza l'API 4.0, che è l'ambiente in cui viene fatto lo sviluppo delle nuove API. 4.0 corregge i tipi di proprietà codificati in modo errato dai payload dell'API 3.1. |
Eventuali versioni future dell'API verranno introdotte come alpha e quindi sposteranno nei cicli di vita beta, stabili e deprecati.
SDK per i linguaggi
Gli SDK per il linguaggio di Looker si sono evoluti nel corso del ciclo di 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 assistenza degli SDK per i linguaggi è descritto nella tabella seguente.
| linguaggio | Assistenza | Strumenti | Descrizione |
|---|---|---|---|
| Ruby | Looker | Scritto a mano | L'SDK Ruby corrente legge la specifica dell'API Looker per costruire dinamicamente i metodi SDK. |
| Python | Looker | codegen | L'SDK Python viene utilizzato ovunque sia possibile usare Python. Consulta il leggimi dell'SDK Python per le informazioni più recenti sulle versioni Python supportate. |
| TypeScript | Looker | codegen | L'SDK TypeScript viene utilizzato per applicazioni sia di nodi che di browser. |
| Kotlin | Community | codegen | L'SDK Kotlin viene utilizzato per le applicazioni Android Mobile e Java Virtual Machine (JVM). |
| Swift | Community | codegen | L'SDK Swift viene utilizzato per le applicazioni per iOS e macOS. |
| R | Community | Spavaldo | LookR è l'SDK Looker per il linguaggio di programmazione R e funziona con R Studio. |
| Altro | Community | codegen | Gli SDK di altri linguaggi generati dal progetto codegen di Looker, come C# (Look#) e Go (GoLook), sono supportati dalla community. I problemi devono essere registrati 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 OpenSource Generatore di codice Swagger. Per i linguaggi di programmazione non direttamente supportati 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 che sia necessaria alcuna generazione di codice.
Controllo delle versioni degli SDK
Looker ha recentemente adottato uno schema di controllo delle versioni che associa gli SDK del linguaggio alla release di Looker utilizzata per generarli. Ad esempio, un SDK prodotto utilizzando le specifiche Looker 21.10 avrà una versione che inizia con 21.10.*.
SDK per i linguaggi
Gli SDK del linguaggio più recenti (prodotti dal codegen di Looker) corrispondono alle versioni di release di Looker. Ad esempio, gli SDK Python e TypeScript corrispondono alle rispettive versioni di release di Looker.
Man mano che trasferiamo i nostri SDK del linguaggio precedente alla generazione di codice o pubblichiamo gli SDK codegen esistenti nei relativi gestori di pacchetti, la versione dell'SDK verrà impostata in modo che corrisponda alla versione di release di Looker.
Versioni del pacchetto della libreria di runtime
L'SDK TypeScript dipende da un pacchetto RTL (Runtime Library) separato, scritto da Looker, che supporta genericamente le API REST. Poiché non è specifico per nessuna release di Looker, il controllo delle versioni di questo pacchetto viene eseguito indipendentemente dagli SDK del linguaggio che lo utilizzano.
Quando gli SDK per altri linguaggi vengono pubblicati per i gestori di pacchetti, i relativi RTL potrebbero diventare un pacchetto separato. Qualsiasi pacchetto RTL separato utilizzerà il controllo delle versioni semantico anziché le versioni di release di Looker corrispondenti.