Databricks Assistant에서 코딩 도움말 보기
이 문서에서는 Databricks Assistant를 사용하여 Notebook을 코딩하고 디버그하는 방법을 설명하고 도우미를 최대한 활용하는 방법에 대한 팁을 제공합니다.
Databricks 도우미가 어떤 도움을 줄 수 있나요?
Databricks Assistant는 대화형 인터페이스를 사용하여 상호 작용할 수 있는 컨텍스트 인식 AI 도우미로, Databricks 내에서 생산성을 높일 수 있습니다. 작업을 영어로 설명하고 도우미가 Python 코드 또는 SQL 쿼리를 생성하고 복잡한 코드를 설명하고 오류를 자동으로 수정하도록 할 수 있습니다. 도우미는 Unity 카탈로그 메타데이터를 사용하여 회사 전체의 테이블, 열, 설명 및 인기 있는 데이터 자산을 이해하여 맞춤형 응답을 제공합니다.
Databricks Assistant는 다음 작업을 수행하는 데 도움이 될 수 있습니다.
- 코드를 생성합니다.
- 오류에 대한 수정 사항을 식별하고 제안하는 것을 포함하여 코드를 디버그합니다.
- 코드를 변환하고 최적화합니다.
- 코드를 설명합니다.
- Azure Databricks 설명서에서 관련 정보를 찾을 수 있습니다.
Databricks Assistant를 설정하고 사용해보는 방법에 대한 정보는 Databricks Assistant 사용 활성화 및 사용해보기를 참조하세요. Databricks Assistant에 대한 일반적인 내용은 DatabricksIQ 기반 기능참조하세요.
노트북에 대한 어시스턴트 명령 바로 가기
Notebook에서 Databricks Assistant는 도우미 창 또는 코드 셀 내에서 제공됩니다.
코드 셀에서 Databricks Assistant를 직접 사용하려면 MacOS에서 Cmd+I 누르거나 Windows에서 Ctrl+I 누릅니다. 셀에 텍스트 상자가 나타납니다. 영어로 질문이나 메모를 입력한 다음 Enter(셀을 실행하는 것처럼 Shift+Enter아님)을 눌러 Assistant가 응답을 생성하도록 할 수 있습니다.
프롬프트에 슬래시 명령 사용
슬래시 명령은 일반적인 프롬프트를 만들기 위한 바로 가기입니다.
| 프롬프트 텍스트 | 길잡이가 하는 일 |
|---|---|
/ |
일반적인 명령을 표시합니다. |
/doc |
diff 보기에서 코드 주석 달기 |
/explain |
셀의 코드에 대한 설명을 제공합니다. |
/fix |
diff 보기의 코드 오류에 대한 수정 제안 |
/findTables |
Unity 카탈로그 메타데이터를 기반으로 관련 테이블을 검색합니다. 기능 또는 기능 테이블을 찾으려면 쿼리에서 "기능" 또는 "기능 테이블"을 언급합니다. Databricks Assistant사용하여 기능 및 기능 테이블 찾기를 참조하세요. |
/findQueries |
Unity 카탈로그 메타데이터를 기반으로 관련 쿼리를 검색합니다. |
/optimize |
비효율적인 SQL 쿼리를 개선합니다. |
/prettify |
가독성을 위해 코드를 포맷합니다. |
/rename |
컨텍스트에 따라 Notebook 셀 및 기타 요소에 업데이트된 이름을 제안합니다. |
/settings |
Assistant에서 직접 전자 필기장 설정을 조정합니다. |
/fix 또는 /doc을 사용할 때, diff 창에서 제안된 변경을 적용하려면 수락을 선택하거나, 원래 코드를 유지하려면 거부을 선택하세요. 제안된 코드를 수락하면 코드가 자동으로 실행되지 않습니다. 코드를 실행하기 전에 검토할 수 있습니다. 생성된 코드가 원하는 코드가 아닌 경우 메모에 더 많은 세부 정보 또는 정보를 추가하여 다시 시도합니다. Databricks Assistant 사용하기 위한팁을 참조하세요.
코드 조각에 대한 자세한 설명을 가져옵니다.
/explain 프롬프트를 사용하고 "간결하게" 또는 "코드 줄 단위 설명"과 같은 용어를 포함하여 원하는 세부 수준을 요청합니다. Databricks Assistant에 코드에 주석을 추가하도록 요청할 수도 있습니다.
코드 자동 완성의 경우 Notebook 셀보다 길잡이 창을 사용하는 것이 성능이 더 좋을 수 있습니다.
수락하거나 생성된 코드에 거부를 경우 도우미가 자동으로 닫힙니다.
을 사용하여 프롬프트의 참조 테이블 @
길잡이 프롬프트에서 테이블을 빠르게 참조하려면 @ 기호를 사용합니다.
코드 도움말 보기
Databricks Assistant는 SQL 및 Python의 코드에 도움이 됩니다.
- Databricks Notebook, SQL 편집기 및 파일 편집기에서 AI 기반 자동 완성
- 자연어 프롬프트를 사용하여 데이터 필터링
- 진단 오류(공개 미리 보기)를 사용한 코드 디버깅
메모
인라인 코드 제안은 FedRAMP 규정 준수를 사용하는 Azure Government 지역 또는 작업 영역에서 사용할 수 없습니다.
인라인 코드 제안 가져오기: Python 및 SQL 예제
입력하면 제안이 자동으로 표시됩니다.
Tab 눌러 제안을 수락합니다. 제안을 수동으로 트리거하려면 Option+Shift+Space(macOS) 또는 Control+Shift+Space(Windows)를 누릅니다.
SQL 코드 완성의 애니메이션 GIF 
python용 코드 완성의 애니메이션 GIF 
AI 기반 자동 완성은 주석에서 코드를 생성할 수도 있습니다.
댓글에서 코드 완성의 애니메이션 GIF입니다. 
자연어 프롬프트를 사용하여 데이터 필터링
Databricks Assistant를 사용하여 자연어 프롬프트를 사용하여 데이터 출력을 필터링합니다.
자연어를 사용하여 출력을 필터링하려면 출력 테이블에서 필터 아이콘을 클릭하고 프롬프트를 입력합니다. 예를 들어 다음 애니메이션 예제와 같이 "70세 이상의 남성만 표시하라"는 메시지를 표시할 수 있습니다.
디버그 코드: Python 및 SQL 예제
중요하다
이 기능은 공개 미리 보기.
Databricks Assistant를 사용하여 코드를 수정하려면 다음 중 하나라도 수행합니다.
- 길잡이 창에서 질문을 합니다.
- 오류가 발생할 때 셀 결과에 나타나는 진단 오류 단추를 클릭합니다.
- 디버그 클릭하여 코드 줄을 대화형으로 단계별로 실행하고, 중단점을 설정하고, 변수를 검사하고, 프로그램의 실행을 분석합니다.
아래 탭은 Python 및 SQL 코드의 예를 보여 줍니다.
파이썬
SQL
SQL의 
오류 진단을 클릭하면 도우미가 자동으로 /fix를 실행합니다.
빠른 수정
코드가 오류를 반환하는 경우 빠른 수정은 한 줄 변경으로 수정할 수 있는 기본 오류에 대한 수정을 자동으로 권장합니다.
수락을 클릭하고 실행하여 권장되는 수정을 수행하고 코드를 계속 실행합니다.
Databricks 길잡이를 사용하기 위한 팁
이 섹션에는 Databricks Assistant를 사용할 때의 몇 가지 일반적인 팁과 모범 사례가 포함되어 있습니다.
Databricks Assistant는 컨텍스트를 사용하여 더 나은 답변을 제공합니다.
Databricks Assistant는 테이블 및 열 스키마 및 메타데이터에 액세스할 수 있습니다. 이렇게 하면 자연어를 사용하고 보다 정확한 쿼리를 생성할 수 있습니다. 예를 들어 테이블에 State열이 있는 경우 Databricks Assistant에 미시간주에 거주하는 사용자 목록을 생성하도록 요청할 수 있습니다.
Databricks Assistant는 다음 컨텍스트를 사용합니다.
- 현재 Notebook 셀 또는 Databricks SQL 편집기 탭의 코드 또는 쿼리입니다.
- 테이블 및 열 이름 및 설명입니다.
- 이전 프롬프트 질문
- 즐겨찾기 및 활성 테이블
- 진단 오류 기능의 경우, 오류 출력의 스택 추적은 다음과 같습니다.
DataFrame에서 열을 선택할 때 시작 쿼리를 제공하여 보다 정확한 결과를 얻을 수 있습니다. 예를 들어 SELECT * FROM <table_name>같은 문장을 제시하세요. 이렇게 하면 Databricks Assistant가 열 이름을 가져올 수 있으며 추측할 필요가 없습니다.
Databricks Assistant는 대화 기록을 사용하여 더 정확하고 정확한 답변을 제공하기 때문에 전체 프롬프트를 다시 작성하지 않고도 Databricks Assistant에 이전 응답의 출력을 변경하도록 요청할 수 있습니다. 길잡이의 채팅 기록을 사용하여 길잡이 창에서 데이터 프레임을 반복적으로 정리, 탐색, 필터링 및 조각화할 수 있습니다.
구체적이어야 합니다.
Databricks Assistant에서 제공하는 구조와 세부 정보는 동일한 프롬프트에 대해서도 때때로 다릅니다. 원하는 형식, 세부 수준 등으로 원하는 정보를 반환하는 데 도움이 되도록 최대한 많은 지침을 Assistant에 제공해 보세요. 예를 들어:
- "이 코드를 몇 문장으로 설명" 또는 "이 코드를 줄별로 설명"합니다.
- "MatPlotLib을 사용하여 시각화 만들기" 또는 "Seaborn을 사용하여 시각화 만들기"
행 수준 데이터 값의 예제 제공
Databricks Assistant는 행 수준 데이터를 사용하지 않으므로 가장 정확한 답변을 얻으려면 프롬프트에 더 자세한 정보를 제공해야 할 수 있습니다. 카탈로그 탐색기에서 테이블 또는 열 주석을 사용하여 샘플 데이터 줄을 추가합니다. 예를 들어 높이 열이 feet-inches형식이라고 가정합니다. Assistant가 데이터를 해석하는 데 도움이 되도록 "높이 열이 문자열 형태로 되어 있으며, 하이픈으로 구분됩니다. 예: '6-2'." 테이블 및 열 주석에 대한 정보는 데이터 및 AI 자산에 주석 추가하기를 참조하세요.
열 데이터 형식 변환을 사용하여 작업을 실행해야 하는 경우 세부 정보를 제공해야 할 수 있습니다. 예를 들어 "pandas DataFrame을 PySpark DataFrame으로 변환하고 열 변동의 데이터 형식을 부울에서 정수로 변경하는 데 필요한 코드를 포함하여 이 코드를 pandas에서 PySpark로 변환합니다."
Shift+Enter를 사용하여 채팅 텍스트 상자에 새 줄 추가
Shift+Enter 사용하여 길잡이 채팅 텍스트 상자에 새 줄을 추가합니다. 이렇게 하면 Databricks Assistant로 메시지의 서식을 쉽게 지정하고 구성할 수 있습니다.
Databricks 길잡이 채팅 창에서 코드 편집 및 실행
도우미 창에서 코드를 실행하여 유효성을 검사하거나 스크래치 패드로 사용합니다. 코드를 실행하려면 길잡이 창에서 코드 상자의 왼쪽 위 모서리에 있는
run code icon실행 코드 아이콘을 클릭합니다.
아래 탭에서는 Python 및 SQL 코드에 대한 예제를 보여 줍니다.
파이썬
SQL
도우미 창에서 코드를 실행하면 출력이 표시되고 Notebook에서 변수를 사용할 수 있게 됩니다.
코드를 Notebook으로 이동하기 전에 Databricks Assistant가 도우미 채팅 상자에서 직접 생성하는 코드를 편집할 수도 있습니다.
추가 정보
다음 문서에는 Databricks Assistant 사용에 대한 추가 정보가 포함되어 있습니다.