Looker は、複数の API バージョンと、それらの API を使用する複数の言語 SDK を提供しています。このドキュメントでは、Looker API のバージョンと言語 SDK のステータスおよびサポート ポリシーについて説明します。
サポートレベル
Looker API のバージョンと SDK のサポートレベルはさまざまです。
サポートレベルについては、以降のセクションで説明します。
Looker のサポート
Looker は、これらの API バージョンと言語 SDK をサポートしています。サポート チケットは Looker サポートで提出でき、Looker サポート ガイドラインを遵守しています。
コミュニティのサポート
このレベルは言語 SDK にのみ適用されます。問題は SDK に使用される Open Source リポジトリで記録、管理されます。
次の理由により、言語 SDK がコミュニティ サポートレベルになる場合があります。
- Looker でサポートされているレベルを達成するために必要な機能が不足している。
- Looker で完全にサポートされる前に、より多くのサポートと自動化インフラストラクチャ（自動テスト、パッケージ化、ドキュメント、例など）が必要である。
- サポートが終了したテクノロジーに基づいている。
- 十分な数の異なるユーザーによるテストが行われていないため、「アルファ版」ステータスから移行する準備ができていないと考えられる。
非対応
サポートは提供されていません。現時点では、API バージョン 3.0 のみがサポート対象外です。
API バージョン
次の表に、Looker 22.4 以降の 3 つのドキュメント API バージョンとサポートレベルを示します。
| バージョン | サポート | ステータス | 説明 |
|---|---|---|---|
| 3.0 | 非対応 | 削除 | この API は Looker から削除されました。 |
| 3.1 | 非対応 | 削除 | この API は Looker から削除されました。 |
| 4.0 | Looker | Stable | 現在のリリース。新しいエンドポイント、引数、構造プロパティと、タイプへの変更はまだ作成中です。ほとんどの Looker 言語 SDK では API 4.0 が使用され、そこで新しい API 開発が行われます。4.0 は、API 3.1 ペイロードによって不適切にエンコードされたプロパティ タイプを修正します。 |
将来の 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 | C#（Look#）や Go（GoLook）など、Looker の Codegen プロジェクトによって生成された他の言語 SDK もコミュニティでサポートされています。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 は、REST API を通常サポートする、Looker が作成した個別のランタイム ライブラリ（RTL）パッケージに依存しています。Looker リリースに固有ではないため、このパッケージは、パッケージを使用する言語 SDK とは関係なくバージョニングされます。
他の言語 SDK をパッケージ マネージャーに公開すると、RTL が別のパッケージになる場合があります。個別の RTL パッケージでは、Looker のリリース バージョンを一致させるのではなく、セマンティック バージョニングを使用します。