최신 Databricks SQL API 버전으로 업데이트

  • 아티클

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

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

쿼리 API 변경 내용

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

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

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

경고 API 변경 내용

새 경고 API에는 보다 설명적인 필드 이름 및 형식, 목록 엔드포인트에 대한 페이지를 매긴 응답 및 부분 업데이트 지원이 포함된 사용자 친화적인 환경이 포함되어 있습니다. 다음 목록에서는 경고 API의 변경 내용을 설명합니다.

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

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

사용 권한 API 변경 내용

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

레거시로 표시된 데이터 원본 API

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