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 변경사항을 나열합니다.
- 보드, 보드 항목, 보드 섹션 생성 및 관리. 보드에 대한 자세한 내용은 보드 문서 페이지를 참조하세요.
- 데이터베이스, 스키마, 열, 테이블과 같은 추가 연결 정보 쿼리. 추가 연결 필드를 설정하고 업데이트합니다.
- OAuth 앱 및 사용자의 생성과 관리. OAuth에 대한 자세한 내용은 OAuth 문서 페이지를 참조하세요.
- 계층 구조와 역할로 그룹 검색
- 사용자 수로 역할 검색
- Looker 인스턴스 설정 가져오기 및 설정. 설정에 대한 자세한 내용은 설정 문서 페이지를 참조하세요.
- 알림 만들기 및 관리. 알림에 대한 자세한 내용은 알림 문서 페이지를 참조하세요.
- SSH 터널 및 SSH 서버 만들기, 관리, 테스트. SSH에 대한 자세한 내용은 SSH 문서 페이지를 참조하세요.
- 대시보드 이동 및 복사
- 새 대시보드의 상대 URL 가져오기
- Look 이동 및 복사
- 보안 비밀, URL, 사용자 만들기 및 관리에 대한 서명된 삽입 및 비서명된 삽입
- 갱신 토큰을 가져와서 로그인 액세스 토큰 새로고침
- 모든 LookML 모델 및 모든 사용자 가져오기를 수행할 때 제한 및 상쇄로 결과 제어
- 사용자 검색을 수행할 때 제한 및 상쇄로 결과 제어
- Swagger 2.x JSON에서 Looker 인스턴스 API 사양 가져오기
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 플랫폼에서 더 생산적으로 쉽게 개발하는 데 도움이 되기를 바랍니다.