최신 Databricks SQL API 버전으로의 Update

이 문서에서는 최신 버전의 Databricks SQL API에 포함된 쿼리, 경고, 권한 및 데이터 원본 API의 변경 내용을 설명합니다. 이 문서를 사용하여 애플리케이션 및 통합을 새 API 버전으로 마이그레이션할 수 있습니다.

레거시 API는 6개월 동안 계속 지원됩니다. 이 전환 기간은 이전 버전이 단계적으로 중단되기 전에 마이그레이션할 시간을 제공합니다.

새 쿼리 API에는 보다 설명적인 이름, 페이지를 매긴 응답 및 생성 시간별로 자동으로 정렬되는 list 응답이 포함된 사용자 친화적인 환경이 포함되어 있습니다. 다음 list 쿼리 API의 변경 내용을 설명합니다.

• 이제 api/2.0/sql/queriesAPI 경로가 .의 레거시 경로를 대체합니다 /api/2.0/preview/sql/queries.
• 더 설명적인 필드 이름 및 형식이 있는 새 쿼리 정의를 포함합니다.
• 이제 update 엔드포인트는 POST대신 PATCH 사용하여 부분 업데이트를 지원합니다.
• 이제 update 엔드포인트는 쿼리 소유권 이전을 지원합니다. 이전에는 전송 개체 소유권 API를 사용하여만 허용되었습니다.
• 이제 list 엔드포인트 응답은 토큰 기반 페이지 매김을 사용하여 페이지를 매깁니다.
• list 엔드포인트는 더 이상 이름 또는 사용자 지정 순서별 필터링을 지원하지 않습니다. 대신 액세스 가능한 모든 쿼리가 생성 시간별로 오름차순으로 반환되고 정렬됩니다.
• restore 엔드포인트는 더 이상 지원되지 않습니다. 휴지통 쿼리는 Azure Databricks UI를 통해 계속 복원될 수 있습니다.

업데이트된 쿼리 API에 대한 전체 설명서는 쿼리를 참조 하세요.

새 알림 API는 보다 사용자 친화적인 경험을 제공하며, 보다 설명적인 필드 이름 및 형식, list 엔드포인트에 대한 페이지를 매긴 응답, 그리고 부분 업데이트 지원을 포함하고 있습니다. 다음 list 경고 API의 변경 내용을 설명합니다.

• 이제 api/2.0/sql/alertsAPI 경로가 .의 레거시 경로를 대체합니다 /api/2.0/preview/sql/alerts.
• 더 설명적인 필드 이름과 형식이 사용되는 새 경고 정의를 포함합니다.
• 이제 update 엔드포인트는 POST대신 PATCH 사용하여 부분 업데이트를 지원합니다.
• 이제 update 엔드포인트는 쿼리 소유권 이전을 지원합니다. 이전에는 전송 개체 소유권 API를 사용하여만 허용되었습니다.
• 이제 list 엔드포인트 응답은 토큰 기반 페이지네이션을 사용하여 분할됩니다.
• 이제 삭제 엔드포인트는 경고를 영구적으로 삭제하는 대신 휴지통으로 경고를 이동합니다. 휴지통 경고는 30일 후에 자동으로 정리됩니다. 휴지통 경고는 Azure Databricks UI를 통해 삭제 후 30일 이내에 복원할 수 있습니다.

업데이트된 경고 API에 대한 전체 설명서는 경고를 참조 하세요.

Permissions API는 더 이상 Get 개체 ACL 및 Set 개체 ACL를 지원하지 않습니다. 작업 영역 API를 사용하여 이러한 작업에 대한 권한을 관리합니다.

이제 데이터 원본 API가 레거시로 표시됩니다. 현재 해당 기능은 SQL 웨어하우스의 list을 가져오는 것으로 제한되어 있습니다. 새 쿼리 API는 데이터 원본 ID 대신 SQL 웨어하우스 ID 전달 및 반환을 지원하므로 데이터 원본과 SQL 웨어하우스 간에 변환하기 위한 별도의 API 호출이 더 이상 필요하지 않습니다.