Looker では、複数の API バージョンと、それらの API を使用する複数の言語 SDK が提供されます。このドキュメントでは、Looker API のバージョンと言語 SDK のステータスおよびサポート ポリシーについて説明します。
サポートレベル
Looker API のバージョンと SDK には、さまざまなサポートレベルがあります。
サポートレベルについては、以降のセクションで説明します。
Looker のサポート
Looker で、これらの API バージョンと言語 SDK がサポートされています。サポート チケットは Looker サポートで提出でき、Looker サポート ガイドラインを遵守しています。 API 4.0 のみが Looker でサポートされています。
コミュニティのサポート
このレベルは言語 SDK にのみ適用されます。問題は、その SDK に使用されている OpenSource リポジトリで報告および管理されます。
言語 SDK がコミュニティ サポート レベルになる理由はいくつかあります。
- Looker のサポートレベルを達成するために必要な機能が不足している。
- Looker で完全にサポートされる前に、より多くのサポートと自動化インフラストラクチャ（自動テスト、パッケージ化、ドキュメント、例など）が必要である。
- サポートが終了したテクノロジーに基づいている。
- 十分な数の異なるユーザーによるテストが行われていないため、「アルファ版」ステータスから移行する準備ができていないと考えられる。
非対応
サポートが提供されていません。API バージョン 3.0 と 3.1 がサポートされていません。
API バージョン
次の表に、Looker 22.4 の時点で文書化された 3 つの API バージョンと、それらのサポートレベルを示します。
| バージョン | サポート | ステータス | 説明 |
|---|---|---|---|
| 3.0 | 非対応 | 削除済み | この API は Looker から削除されました。 |
| 3.1 | 非対応 | 削除済み | この API は Looker から削除されました。 |
| 4.0 | Looker | Stable | 現在のリリース。新しいエンドポイント、引数、構造プロパティは追加できます。サポートされているすべての Looker 言語 SDK で、API 4.0 が使用されます。 |
将来の API バージョンはアルファ版として導入され、ベータ版、安定版、非推奨のライフサイクルを推移します。
言語 SDK
Looker の言語 SDK は Looker のリリース以来進化し続けており、さまざまなツールと手法で作成されています。すべての SDK で、Looker の API 仕様ドキュメントが直接的または間接的に使用されます。言語 SDK のサポート状況は次の表のとおりです。
| 言語 | サポート | ツール | 説明 |
|---|---|---|---|
| Ruby | Looker | 手書き | 現在の Ruby SDK は、Looker API 仕様を読み取って SDK メソッドを動的に作成します。 |
| Python | Looker | codegen | Python SDK は、Python を使用できればどこでも使用できます。サポートされている Python バージョンの最新情報については、Python SDK の README をご覧ください。 |
| TypeScript | Looker | codegen | TypeScript SDK は、ノードアプリケーションとブラウザアプリケーションの両方で使用されます。 |
| Kotlin | コミュニティ | codegen | Kotlin SDK は、Android モバイルアプリと Java 仮想マシン（JVM）アプリケーションで使用されます。 |
| Swift | コミュニティ | codegen | Swift SDK は、iOS アプリと MacOS アプリケーションで使用されます。 |
| R | コミュニティ | Swagger | LookR は、R プログラミング言語向けの Looker SDK であり、R Studio と連携します。 |
| その他 | コミュニティ | codegen | Looker の codegen プロジェクトによって生成された他の言語 SDK（C#（Look#）や Go（GoLook）など）は、コミュニティでサポートされています。sdk-codegen リポジトリで問題を報告する必要があります。 |
ツールの凡例
- codegen - Looker の SDK codegen プロジェクトによって生成され、各 SDK に手書きのランタイム ライブラリを使用します。
- Swagger - Swagger コード ジェネレータ OpenSource ツールによって生成されます。Looker のコード生成ツールで直接サポートされていないプログラミング言語では、codegen リポジトリに以前のジェネレータ オプションが用意されており、カスタム生成を簡略化できます。この「レガシー」生成ツールでは、OpenSource OpenAPI コード ジェネレータが使用されます。これは、Swagger コード ジェネレータに代わるものです。
- 手書き - すべてのソースコードが手書きで記述され、コード生成は行われません。
SDK のバージョニング
Looker は最近、言語 SDK と、それらの生成に使用された Looker リリースを一致させるバージョニング スキームを採用しました。たとえば、Looker 21.10 仕様を使用して生成された SDK は、21.10.* で始まるバージョンになります。
言語 SDK
最新の言語 SDK（Looker Codegen が生成）は、Looker のリリース バージョンと一致します。たとえば、Python SDK と TypeScript SDK は、それぞれ対応する Looker リリース バージョンと一致します。
古い言語 SDK を codegen に移行するか、既存の codegen SDK をパパッケージ管理システムに公開すると、SDK のバージョンが Looker のリリース バージョンと一致するように設定されます。
ランタイム ライブラリ パッケージのバージョン
TypeScript SDK は、Looker で記述された、REST API を汎用的にサポートする個別のランタイム ライブラリ（RTL）パッケージに依存しています。Looker リリースに固有ではないため、このパッケージは、パッケージを使用する言語 SDK とは関係なくバージョニングされます。
他の言語の SDK がパッケージ管理システムに公開されると、それらの RTL は別のパッケージになる場合があります。個別の RTL パッケージでは、Looker のリリース バージョンを一致させるのではなく、セマンティック バージョニングが使用されます。