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 berbeda-beda:

Tingkat dukungan dijelaskan di bagian berikut.

Didukung Looker

Looker mendukung versi API dan SDK bahasa ini. Tiket dukungan dapat diajukan ke Dukungan Looker dan mematuhi 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:

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

Tidak didukung

Tidak ada dukungan yang diberikan. Versi API 3.0 dan 3.1 tidak didukung.

Versi API

Tabel berikut mencantumkan tiga versi API yang didokumentasikan pada 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 berpindah melalui siklus proses beta, stabil, dan tidak digunakan lagi.

SDK bahasa

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

Bahasa Dukungan 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 file 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 dibuat oleh project codegen Looker — seperti C# (Look#) dan Go (GoLook) — didukung Komunitas. Masalah harus diajukan di repositori sdk-codegen.

Legenda alat

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

Pemberian versi SDK

Looker baru-baru ini mengadopsi skema pemberian versi yang cocok dengan 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 (yang dibuat oleh codegen Looker) cocok dengan versi rilis Looker. Misalnya, Python dan TypeScript SDK 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 khusus untuk rilis Looker tertentu, 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. Paket RTL terpisah akan menggunakan pemberian versi semantik, bukan mencocokkan versi rilis Looker.