Looker API 4.0 정식 버전

Looker API 4.0이 Looker 22.4에서 정식 버전으로 제공된다는 소식을 전해드립니다. 정식 API 4.0 버전(API 4.0 GA)에는 여러 엔드포인트를 베타에서 공개 버전으로 승격하는 브레이킹 및 추가 변경사항이 여러 개 있습니다. 자세한 API 4.0 사양은 API 참조를 확인하세요. Looker 지원 및 커뮤니티 지원 SDK가 Looker API 4.0 GA 엔드포인트를 지원하도록 업데이트되었습니다. 자세한 내용은 API 및 SDK 지원 정책API 버전 관리를 참조하세요. 이 문서의 나머지 부분에서는 API 4.0 GA로 마이그레이션할 때 기대할 수 있는 브레이킹 체인지, 해결 방법, 기능을 간략하게 보여줍니다.

대상 독자

이 문서는 Looker 지원 SDK, 커뮤니티 지원 SDK 또는 API 자체를 통해 Looker API를 사용하는 경우 도움이 됩니다. 아래에서 사용 중인 Looker API 버전에 해당되는 섹션을 읽어보세요.

GA 이전 API 4.0 사용자

API 4.0을 사용하는 경우 이 섹션을 참조하세요. 여기에서는 API 4.0 GA로 마이그레이션할 때의 브레이킹 체인지와 사용 가능한 완화 방법을 다룹니다.

API 4.0 GA에서는 모든 항목 ID 필드가 숫자 integer 유형에서 string 유형으로 변경되었습니다. 예를 들어 GET /groups/{group_id} 엔드포인트int64 유형 대신 string 유형으로 id를 반환합니다.

API 4.0 엔드포인트 사용과 관련된 영향 및 해결 방법을 보려면 다음 표를 검토하세요.

용도 잠재적 영향력1 예방 방법
Looker 모바일 앱 오래된 Looker 모바일 앱 설치가 작동을 중지합니다. 사용자가 최신 버전의 Looker 모바일 앱으로 업데이트하도록 합니다.
Looker 지원2 SDK
TypeScript SDK(4.0 API) 영향 없음 조치 불필요
Python SDK(4.0 API) 영향 없음 조치 불필요
Ruby SDK(4.0 API) 영향 없음 조치 불필요
커뮤니티 지원2 SDK
Swift SDK 런타임 예외 SDK를 v22.0 이상으로 업데이트, 이후 결과적으로 발생하는 유형 오류 해결(있는 경우)
Kotlin SDK 영향 없음 조치 불필요
LookR SDK 영향 없음 조치 불필요
C# SDK 영향 없음 조치 불필요
Go SDK 런타임 예외 SDK를 v22.0 이상으로 업데이트, 이후 결과적으로 발생하는 유형 오류 해결(있는 경우)
기타
SDK 없이(또는 외부에서 제공된 라이브러리로) 4.0 API 사용 언어 유형 민감도에 따른 가능한 런타임 오류 코드에서 ID 필드 유형에 대한 종속 항목을 검토하고 문자열 유형의 ID 필드 지원을 추가합니다. 또한 이 추가 안내를 검토하세요.

1: Looker의 ID 필드 사용을 포함할 수 있지만 ID에 숫자 연산을 적용하는 등 비정상적인 사용 패턴은 포함하지 않는 일반적인 사용 패턴을 가정합니다.

2: Looker API 및 SDK 지원. 커뮤니티 지원 라이브러리는 Looker에서 공식적으로 지원되지 않습니다.

API 3.1 사용자

API 3.1을 사용하는 경우 이 섹션을 참조하세요. 여기에서는 API 4.0에서 사용할 수 있는 추가 기능과 변경사항을 다룹니다. 모든 Looker 지원 및 커뮤니티 지원 SDK는 기본적으로 API 4.0을 지원합니다. 자세한 내용은 SDK 및 API 지원 정책을 참조하세요.

추가 API 4.0 GA 기능

편의를 위해 가장 주목할 만하고 유용한 추가 API 4.0 변경사항을 나열합니다.

API 4.0 GA 지원 중단 변경사항

API 4.0 GA는 지원 중단된 여러 API 3.1 엔드포인트를 향상된 기능으로 대체합니다. 영향을 받는 엔드포인트는 다음과 같습니다.

API 3.0 사용자

API 3.0이 지원 중단되었고 API 4.0으로 마이그레이션하는 것이 좋습니다.

  • API 4.0만 모든 Looker 지원 및 커뮤니티 지원 SDK를 지원하여 개발을 용이하게 해줍니다. SDK 저장소를 확인하세요.
  • 이 페이지의 추가 API 4.0 GA 기능 섹션에 표시된 대로 API 4.0에 여러 가지 새로운 기능과 개선 사항이 도입되었습니다.

마무리

API 4.0에 추가될 새로운 기능과 추가 변경사항을 예상할 수 있으며 API 참조에서 언제든지 최신 변경사항을 확인할 수 있습니다. 자세한 내용은 API 및 SDK 지원 정책API 버전 관리를 참조하세요. Google은 브레이킹 체인지가 이상적이지 않음을 알고 있습니다. 심각한 문제가 발생하지 않는 한 정식 버전인 API 4.0에 관한 어떤 브레이킹 체인지도 적용하지 않습니다. 정식 버전인 Looker API 4.0이 Looker 플랫폼에서 더 생산적으로 쉽게 개발하는 데 도움이 되기를 바랍니다.