Looker 22.4에서 Looker API 4.0이 정식 버전으로 제공된다는 소식을 전해드립니다. 정식 버전인 API 4.0 (API 4.0 GA)에서는 여러 가지 브레이킹 체인지와 추가 변경사항이 있으며 베타에서 공개 버전으로 여러 엔드포인트를 승격합니다. API 3.1 및 3.0은 영향을 받지 않습니다. 자세한 API 4.0 사양은 API 참조를 확인하세요. Looker API 4.0 GA 엔드포인트를 지원하도록 Looker 지원 SDK와 커뮤니티 지원 SDK를 업데이트했습니다. 자세한 내용은 API 및 SDK 지원 정책과 API 버전 관리를 확인하세요. 이 도움말의 나머지 부분에서는 API 4.0 GA로 마이그레이션할 때 기대할 수 있는 브레이킹 체인지, 완화 및 기능에 대해 설명합니다.
누가 읽어야 할까요?
이 문서는 Looker 지원 SDK, 커뮤니티 지원 SDK 또는 API 자체를 통해 Looker API를 사용하는 경우에 적용됩니다. 현재 사용 중인 Looker API 버전에 매핑되는 다음 섹션을 읽어보세요.
GA 이전 API 4.0 사용자
API 4.0을 사용하는 경우 이 섹션을 읽어보세요. Looker 22.4에서 API 4.0 GA로 이전할 때 브레이킹 체인지와 사용 가능한 완화 방법을 다룹니다.
API 4.0 GA에는 모든 항목 ID 필드가 숫자 integer 유형에서 string 유형으로 변경됩니다. 예를 들어 GET /groups/{group_id} 엔드포인트는 id를 int64 유형 대신 string 유형으로 반환합니다.
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와 커뮤니티 지원 SDK는 주로 API 4.0을 지원합니다. 자세한 내용은 SDK 및 API 지원 정책을 참조하세요.
추가 API 4.0 GA 기능
편의를 위해 가장 주목할 만한 추가 API 4.0 변경사항을 나열해 두었습니다.
- 보드, 보드 항목, 보드 섹션 생성 및 관리 보드 문서는 여기에서 확인할 수 있습니다.
- 데이터베이스, 스키마, 열, 테이블과 같은 추가 연결 정보를 쿼리합니다. 추가 연결 필드를 설정하고 업데이트합니다.
- OAuth 앱 및 사용자 생성 및 관리 OAuth 문서는 여기에서 확인하세요.
- 계층 구조 및 역할이 있는 검색 그룹
- 사용자 수가 포함된 검색 역할
- Looker 인스턴스 설정을 가져오고 설정합니다. 설정 문서는 여기에서 확인할 수 있습니다.
- 알림 생성 및 관리 알림 문서는 여기에서 확인할 수 있습니다.
- SSH 터널과 SSH 서버 생성, 관리, 테스트 여기에서 SSH 관련 문서를 참고하세요.
- 대시보드를 이동하고 복사합니다.
- 새 대시보드의 상대 URL을 확인합니다.
- 스타일 이동 및 복사
- SSO 및 비SSO 삽입 보안 비밀, 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 3.0은 기존 API로, 지원 중단된 API로 간주되므로 사용하지 않는 것이 좋습니다. API 4.0으로 이전하는 것이 좋습니다.
- 개발을 간소화하기 위해 API 4.0에서만 모든 Looker 지원 SDK와 커뮤니티 지원 SDK를 지원합니다. SDK 저장소를 확인하세요.
- API 4.0에는 위에 나열된 여러 새로운 기능과 개선사항이 도입되었습니다.
요약
API 4.0에 추가될 새로운 기능과 추가 변경사항을 기대하고 API 참조에서 언제든지 최신 변경사항을 확인할 수 있습니다. 자세한 내용은 API 및 SDK 지원 정책과 API 버전 관리를 참고하세요. 브레이킹 체인지가 바람직하지 않음을 잘 알고 있습니다. 극단적인 문제가 발생하지 않는 한 일반적으로 사용 가능한 API 4.0에는 브레이킹 체인지가 없습니다. 정식 버전 Looker API 4.0이 Looker 플랫폼에서 더욱 생산적이고 쉽게 개발하는 데 도움이 되기를 바랍니다.