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 Looker API dan SDK memiliki tingkat dukungan yang bervariasi:

Tingkat dukungan dijelaskan di bagian berikut.

Didukung Looker

Looker mendukung versi API dan SDK bahasa ini. Tiket dukungan dapat diajukan ke Dukungan Looker dan sesuai dengan panduan Dukungan Looker. Hanya API 4.0 yang didukung 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:

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

Tidak didukung

Dukungan tidak diberikan. API versi 3.0 dan 3.1 tidak didukung.

Versi API

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

Versi Dukungan 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 masih dapat ditambahkan. Semua SDK bahasa Looker yang didukung menggunakan API 4.0.

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

SDK Bahasa

SDK bahasa Looker telah berkembang selama masa aktif Looker dan dibuat 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.

Bahasa Dukungan Alat Deskripsi
Ruby Looker Tulis tangan SDK Ruby 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 mengetahui 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 seluler Android dan Java Virtual Machine (JVM).
Swift Komunitas codegen Swift SDK digunakan untuk aplikasi iOS dan macOS.
R Komunitas Swagger LookR adalah Looker SDK untuk bahasa pemrograman R dan berfungsi dengan R Studio.
Lainnya Komunitas codegen SDK bahasa lain yang dihasilkan oleh project codegen Looker — seperti C# (Look#) dan Go (GoLook) — didukung oleh Komunitas. Masalah harus diajukan di repositori sdk-codegen.

Legenda alat

  • codegen — Dibuat oleh project codegen SDK Looker dan menggunakan library runtime yang ditulis tangan untuk setiap SDK.
  • Swagger — Dibuat oleh alat OpenSource generator kode Swagger. Untuk bahasa pemrograman yang tidak didukung secara langsung 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.
  • Ditulis tangan — Semua kode sumber ditulis dengan tangan tanpa melibatkan pembuatan kode.

Pembuatan versi SDK

Looker baru-baru ini mengadopsi skema pemberian 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 paketnya, versi SDK akan ditetapkan agar cocok dengan versi rilis Looker.

Versi paket library runtime

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

Saat SDK bahasa lain dipublikasikan ke pengelola paket, RTL-nya dapat menjadi paket terpisah. Setiap paket RTL terpisah akan menggunakan pembuatan versi semantik, bukan mencocokkan versi rilis Looker.