Looker API 4.0이 Looker 22.4에서 정식 버전으로 제공된다는 소식을 전해드립니다. 정식 API 4.0 버전(API 4.0 GA)에는 여러 엔드포인트를 베타에서 공개 버전으로 승격하는 브레이킹 및 추가 변경사항이 여러 개 있습니다. API 참조에서 자세한 API 4.0 사양을 확인하세요. 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에는 이 페이지의 추가 API 4.0 GA 기능 섹션에 나열된 여러 새로운 기능과 개선사항이 도입되었습니다.
마무리
API 4.0에 추가될 새로운 기능과 추가 변경사항을 예상할 수 있으며 API 참조에서 언제든지 최신 변경사항을 확인할 수 있습니다. 자세한 내용은 API 및 SDK 지원 정책과 API 버전 관리를 참조하세요. 브레이킹 체인지가 이상적인 것은 아닙니다. 심각한 문제가 발생하지 않는 한 정식 버전인 API 4.0에 관한 어떤 브레이킹 체인지도 적용하지 않습니다. 정식 버전인 Looker API 4.0이 Looker 플랫폼에서 더 생산적으로 쉽게 개발하는 데 도움이 되기를 바랍니다.