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 기준으로 문서화된 세 가지 API 버전과 지원 수준이 나와 있습니다.
| 버전 | 지원 | 상태 | 설명 |
|---|---|---|---|
| 3.0 | 지원되지 않음 | 삭제됨 | 이 API는 Looker에서 삭제되었습니다. |
| 3.1 | 지원되지 않음 | 삭제됨 | 이 API는 Looker에서 삭제되었습니다. |
| 4.0 | Looker | 정식 | 현재 출시 버전입니다. 새 엔드포인트, 인수, 구조 속성은 계속 추가할 수 있습니다. 지원되는 모든 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 리드미를 참조하세요. |
| 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의 코드 생성 프로젝트에서 생성되는 다른 언어 SDK(예: C#(Look#) 및 Go(GoLook))는 커뮤니티에서 지원됩니다. 문제는 sdk-codegen 저장소에 제출해야 합니다. |
도구 범례
- codegen — Looker의 SDK codegen 프로젝트에 의해 생성되며 각 SDK에 직접 작성한 런타임 라이브러리를 사용합니다.
- Swagger — Swagger 코드 생성기 OpenSource 도구에서 생성됩니다. Looker의 코드 생성기에서 직접 지원하지 않는 프로그래밍 언어의 경우 codegen 저장소에 커스텀 생성을 간소화해야 하는 기존 생성기 옵션이 제공됩니다. 이 '기존' 생성기는 Swagger 코드 생성기를 대체하는 OpenSource OpenAPI 코드 생성기를 사용합니다.
- 직접 작성 — 모든 소스 코드는 코드 생성 없이 수동으로 작성됩니다.
SDK 버전 관리
최근 Looker는 언어 SDK를 생성하는 데 사용된 Looker 출시와 일치하는 버전 관리 체계를 채택했습니다. 예를 들어 Looker 21.10 사양을 사용하여 생성된 SDK에는 21.10.*로 시작하는 버전이 있습니다.
언어 SDK
최신 언어 SDK(Looker codegen에서 생성됨)가 Looker 출시 버전과 일치합니다. 예를 들어 Python 및 TypeScript SDK는 각각의 Looker 출시 버전과 일치합니다.
이전 언어 SDK를 codegen으로 이동하거나 기존 codegen SDK를 패키지 관리자에 게시하면 SDK 버전이 Looker 출시 버전과 일치하도록 설정됩니다.
런타임 라이브러리 패키지 버전
TypeScript SDK는 Looker에서 작성한 별도의 런타임 라이브러리(RTL) 패키지에 종속되며 일반적으로 REST API를 지원합니다. 이 패키지는 Looker 출시에만 국한되지 않으므로 이 패키지를 사용하는 언어 SDK와는 별개로 버전이 지정됩니다.
다른 언어 SDK가 패키지 관리자에 게시되면 RTL이 별도의 패키지가 될 수 있습니다. 모든 개별 RTL 패키지는 Looker 출시 버전을 일치시키는 대신 시맨틱 버전 관리를 사용합니다.