Kebijakan dukungan Looker API dan SDK

Looker menyediakan beberapa versi API dan beberapa SDK bahasa yang menggunakan API tersebut. Dokumen ini menjelaskan status dan kebijakan dukungan untuk versi Looker API dan SDK bahasa.

Tingkat dukungan

Versi dan SDK Looker API memiliki berbagai tingkat dukungan:

Tingkat dukungan dijelaskan di bagian berikut.

Looker didukung

Looker mendukung SDK bahasa dan versi API ini. Tiket dukungan dapat diajukan dengan Dukungan Looker dan sesuai dengan panduan Dukungan Looker.

Didukung komunitas

Tingkat ini hanya berlaku untuk SDK bahasa. Masalah diajukan dan dikelola di repositori OpenSource yang digunakan untuk SDK tersebut.

SDK bahasa dapat berada di tingkat dukungan komunitas karena beberapa alasan:

  • Looker tidak memiliki fitur yang diperlukan untuk mencapai level yang didukung Looker.
  • Looker memerlukan lebih banyak dukungan dan infrastruktur otomatisasi (pengujian otomatis, pengemasan, dokumentasi, contoh, dll.) agar dapat didukung sepenuhnya oleh Looker.
  • Kebijakan ini didasarkan pada teknologi yang tidak digunakan lagi.
  • Status belum diuji oleh cukup banyak pengguna yang berbeda untuk dianggap siap untuk keluar dari status "alfa".

Tidak didukung

Dukungan tidak diberikan. Saat ini, hanya API versi 3.0 yang tidak didukung.

Versi API

Tabel berikut mencantumkan tiga versi API yang didokumentasikan per Looker 22.4 dan menunjukkan tingkat dukungannya.

Versi Support Status Deskripsi
3.0 Tidak didukung Dihapus API ini telah dihapus dari Looker.
3.1 Tidak didukung Dihapus API ini telah dihapus dari Looker.
4.0 Looker Stabil Rilis saat ini. Endpoint, argumen, dan properti struktur baru, serta perubahan jenis, masih dalam proses pembuatan.

Sebagian besar SDK bahasa Looker menggunakan API 4.0, yang merupakan tempat pengembangan API baru dilakukan. 4.0 mengoreksi jenis properti yang tidak dienkode dengan benar oleh payload API 3.1.

Semua versi API mendatang akan diperkenalkan sebagai alfa, kemudian beralih ke siklus proses beta, stabil, dan tidak digunakan lagi.

SDK Bahasa

SDK bahasa Looker telah berkembang sepanjang masa penggunaan Looker dan diproduksi dengan berbagai alat dan teknik. Semua SDK secara langsung atau tidak langsung menggunakan dokumen spesifikasi API Looker. Status dukungan SDK bahasa dijelaskan dalam tabel berikut.

Pemodelan bahasa Support Alat Deskripsi
Ruby Looker Tulisan tangan Ruby SDK saat ini membaca spesifikasi Looker API untuk membuat metode SDK secara dinamis.
Python Looker codegen Python SDK digunakan di mana pun Python dapat digunakan. Lihat readme Python SDK untuk informasi terbaru tentang versi Python yang didukung.
TypeScript Looker codegen TypeScript SDK digunakan untuk aplikasi node dan browser.
Kotlin Komunitas codegen Kotlin SDK digunakan untuk aplikasi Java Virtual Machine (JVM) dan seluler Android.
Swift Komunitas codegen Swift SDK digunakan untuk aplikasi iOS dan macOS.
R Komunitas Pemenang LookR adalah Looker SDK untuk bahasa pemrograman R dan bekerja dengan R Studio.
Lainnya Komunitas codegen SDK bahasa lain yang dibuat oleh project codegen Looker — seperti C# (Look#) dan Go (GoLook) — didukung Komunitas. Masalah harus dilaporkan di repositori sdk-codegen.

Legenda alat

  • codegen — Dihasilkan oleh project codegen SDK Looker dan menggunakan library run-time tulisan tangan untuk setiap SDK.
  • Swagger — Dihasilkan oleh alat OpenSource Pembuat kode Swagger. Untuk bahasa pemrograman yang tidak secara langsung didukung oleh generator kode Looker, kami telah menyediakan opsi generator lama di repositori codegen yang akan menyederhanakan pembuatan kustom. Generator "lama" ini menggunakan generator kode OpenAPI OpenSource, yang merupakan pengganti generator kode Swagger.
  • Tulisan tangan — Semua kode sumber ditulis secara manual tanpa melibatkan pembuatan kode.

Pembuatan versi SDK

Looker baru-baru ini mengadopsi skema pembuatan versi yang mencocokkan SDK bahasa dengan rilis Looker yang digunakan untuk membuatnya. Misalnya, ini berarti SDK yang dibuat menggunakan spesifikasi Looker 21.10 akan memiliki versi yang dimulai dengan 21.10.*.

SDK Bahasa

SDK bahasa terbaru (diproduksi oleh codegen Looker) cocok dengan versi rilis Looker. Misalnya, SDK Python dan TypeScript cocok dengan versi rilis Looker masing-masing.

Saat kami memindahkan SDK bahasa lama ke codegen, atau memublikasikan SDK codegen yang ada ke pengelola paket, versi SDK akan ditetapkan agar cocok dengan versi rilis Looker.

Versi paket library runtime

SDK TypeScript bergantung pada paket library runtime (RTL) terpisah yang ditulis oleh Looker, yang secara umum mendukung REST API. Karena tidak khusus untuk rilis Looker apa pun, paket ini dibuat secara terpisah dari SDK bahasa yang menggunakannya.

Saat SDK bahasa lain dipublikasikan ke pengelola paket, RTL mereka dapat menjadi paket terpisah. Setiap paket RTL terpisah akan menggunakan pembuatan versi semantik, bukan versi rilis Looker yang cocok.