Azure Databricks UI에는 쿼리를 작성하고, 동료와 공동 작업하고, 사용 가능한 데이터를 찾고, 시각화를 만드는 데 사용할 수 있는 SQL 편집기가 포함되어 있습니다. 이 페이지에서는 새 SQL 편집기와 각 작업을 자세히 다루는 페이지에 대한 링크를 소개합니다.
이 페이지에서는 새 SQL 편집기를 설명합니다. 레거시 SQL 편집기를 사용하는 방법에 대한 자세한 내용은 레거시 SQL 편집기에서 쿼리 작성 및 데이터 탐색을 참조하세요.
참고
2026년 5월 말부터 모든 작업 영역에 대해 새 SQL 편집기가 기본적으로 사용하도록 설정됩니다. 작업 영역 수준에서 새 SQL 편집기를 해제하는 기능은 더 이상 사용할 수 없습니다. 개별 사용자는 이 기간 동안 레거시 편집기로 전환할 수 있습니다. 2026년 7월 말부터 레거시 SQL 편집기가 사용 중지되고 모든 사용자가 새 SQL 편집기를 사용합니다. 자세한 내용은 다음 을 참조하세요.
SQL 편집기 열기
Azure Databricks UI에서 SQL 편집기를 열려면 사이드바에서 
SQL 편집기 클릭합니다.
SQL 편집기가 마지막으로 열린 쿼리로 열립니다. 쿼리가 없거나 모든 쿼리가 명시적으로 닫힌 경우 SQL 편집기 방문 페이지가 열립니다.
새 SQL 편집기 켜기
카탈로그 및 스키마 드롭다운 선택기의 오른쪽에 있는 새 SQL 편집기 토글을 사용하여 새 편집기를 켜십시오. 좁은 디스플레이에서는 카탈로그 및 스키마 선택기의 오른쪽에 있는 케밥 메뉴 을 클릭하여 Kebab menu icon.새 SQL 편집기 토글을 찾을 수 있습니다.
소유한 쿼리에 대해 새 편집기를 사용하도록 설정합니다.
-
새 SQL 편집기: 끄기를 클릭합니다.
새 SQL 편집기 팝오버 메뉴가 열립니다.
- 모든 쿼리에 적용 확인 체크 박스가 기본적으로 선택되어 있습니다. 소유한 모든 쿼리에 대해 편집기를 사용하도록 설정하려면 이 설정을 유지합니다.
- 활성 쿼리에 대해서만 새 편집기를 사용하도록 설정하려면 모든 쿼리에 적용 확인란의 선택을 취소합니다.
- 새 SQL 편집기 토글을 켠 상태로 설정하십시오.
새 SQL 편집기를 모든 쿼리에 사용할 수 없습니다. 다음 중 어느 것이라도 true이면 쿼리에 대한 새 SQL 편집기로 전환할 수 없습니다.
- 쿼리를 소유하지 않습니다.
- 쿼리에는 지원되지 않는 쿼리 기반 드롭다운 목록이 포함됩니다. 명명된 매개 변수 표식 사용을 참조하세요.
새 SQL 편집기를 켜면 쿼리가 새 UI에서 다시 열립니다. 쿼리를 실행할 때까지 결과 집합은 비어 있습니다.
참고
쿼리 결과는 모든 공동 작업자와 공유되며 64,000개의 행으로 제한됩니다.
오리엔테이션
이 섹션에서는 UI의 주요 차이점을 강조하고 사용 가능한 기능을 찾고 사용하는 방법을 설명합니다.
- 작업 영역 파일 시스템을 엽니다. SQL 편집기에서 직접 작업 영역 개체를 열고 구성할 수 있습니다.
- 통합된 Genie Code: Genie Code와 채팅을 사용하여 쿼리를 작성, 구체화 또는 이해할 수 있습니다. 측면 창에서 Genie Code에서 생성된 코드를 실행합니다.
- 코드 섹션 축소: 코드 블록 왼쪽의 축소 화살표를 클릭하여 코드 섹션을 선택적으로 숨기고 확장합니다. 이렇게 하면 큰 파일을 더 쉽게 처리할 수 있습니다.
- 명령 팔레트 열기: 명령 팔레트에는 일반적인 작업, 바로 가기 키, 사용자 지정 테마 및 필요한 항목을 빠르게 찾을 수 있는 링크가 포함됩니다. 열면 검색 창을 사용하여 특정 도구 및 바로 가기를 찾습니다.
- 코드에 대한 설명: 공동 작업을 향상시키기 위해 코드에 주석을 추가합니다.
- 버전 기록 검토: 쿼리의 최근 변경 내용을 검토합니다.
SQL 편집기 작업
다음 페이지에서는 새 SQL 편집기에서 수행할 수 있는 기본 작업에 대해 설명합니다.
| 과업 | Description |
|---|---|
| 쿼리 작성 | 컴퓨팅에 연결하고, 데이터 자산을 찾아보고, 쿼리를 작성합니다. |
| 쿼리 실행 및 공유 | 단일 또는 다중 문 쿼리를 실행하고, 공유하고, 실시간으로 함께 편집합니다. |
| 쿼리 결과 보기 | 쿼리 결과를 탐색, 시각화, 다운로드 및 필터링합니다. |
| 매개 변수 사용 | 명명된 매개 변수를 사용하고 매개 변수 위젯을 구성합니다. |
| 사용자 지정 형식 SQL | SQL 자동 서식 옵션을 사용자 지정합니다. |
| 키보드 단축키 | 일반적인 바로 가기 키에 대한 참조입니다. |
레거시 쿼리 ID 복사
새 SQL 편집기로 마이그레이션한 쿼리에 대한 레거시 쿼리 ID를 가져오려면 파일 메뉴에서 복사합니다. 레거시 쿼리 ID는 API 호출 또는 이를 참조하는 다른 통합에 유용할 수 있습니다.
- 새 SQL 편집기에서 쿼리를 엽니다.
- 케밥 메뉴
을 클릭합니다. 편집기 맨 위에 있습니다. - 파일>레거시 쿼리 ID 복사를 클릭합니다.
새 SQL 편집기 사용 안 함
참고
2026년 5월 말부터 새 SQL 편집기를 위한 작업 영역 수준 옵트아웃이 제거됩니다. 개별 사용자는 레거시 SQL 편집기가 완전히 사용 중지되는 2026년 7월 말까지 레거시 편집기로 전환할 수 있습니다. 자세한 내용은 다음 을 참조하세요.
새 SQL 편집기를 해제하려면 다음을 수행합니다.
- 새 SQL 편집기: ON를 클릭합니다. 새 SQL 편집기 팝오버 메뉴가 열립니다.
- 새 SQL 편집기 토글을 OFF로 설정하세요.
- 확인 대화 상자에서 활성 쿼리에 대해서만 또는 적합한 모든 쿼리에 대해 새 편집기를 끌지 여부를 선택합니다.
- 모든 적격 쿼리에 대한 사용 안 함이 선택되지 않았습니다. 활성 쿼리에 대해서만 새 편집기를 해제하려면 이 설정을 유지합니다.
- 모든 쿼리에 대해 새 SQL 편집기를 해제하려면 모든 적격 쿼리에 대해 사용 안 함 확인란을 선택합니다.
쿼리가 새 SQL 편집기에서 자동으로 열리지 않도록 하려면 다음을 수행합니다.
- Azure Databricks 작업 영역에서 위쪽 표시줄에서 사용자 이름을 클릭하고 제팅 선택합니다.
- 왼쪽 창의 사용자 아래에서 [개발자 ] 탭을 클릭합니다.
- 새 SQL 편집기에서 적격 쿼리 만들기를 해제하고 모든 적격 쿼리를 엽니다.
작업 영역 관리자는 미리 보기 포털을 방문하여 SQL 편집기를 검색하여 작업 영역 수준에서 이 기능을 해제할 수 있습니다. Azure Databricks 미리 보기 관리 참조하세요.