Databricks 도우미 사용

Important

이 기능은 현재 공개 미리 보기제공됩니다. 미리 보기 중에는 이 기능을 무료로 사용할 수 있습니다. 최종 가격은 GA(일반 공급) 전에 설정되고 전달됩니다.

Databricks Assistant는 Databricks Notebook, SQL 편집기 및 파일 편집기에서 사용할 수 있는 컨텍스트 인식 AI 도우미. Databricks Assistant를 사용하면 대화형 인터페이스를 사용하여 데이터를 쿼리하여 Databricks 내에서 생산성을 높일 수 있습니다. 작업을 영어로 설명하고 도우미 Python 코드 또는 SQL 쿼리를 생성하고 복잡한 코드를 설명하고 오류를 자동으로 수정할 수 있습니다. 이 도우미 Unity 카탈로그 메타데이터를 사용하여 회사 전체의 테이블, 열, 설명 및 인기 있는 데이터 자산을 이해하여 개인 설정된 응답을 제공합니다.

Databricks Assistant는 다음 작업을 수행할 수 있습니다.

  • 코드를 생성합니다.
  • 오류에 대한 수정 사항을 식별하고 제안하는 것을 포함하여 코드를 디버그합니다.
  • 코드를 변환하고 최적화합니다.
  • 코드를 설명합니다.
  • Azure Databricks 설명서에서 관련 정보를 찾을 수 있습니다.

Databricks Assistant는 기본적으로 사용하도록 설정됩니다. 관리자는 계정의 모든 작업 영역에 대해 Databricks Assistant를 사용하지 않도록 설정하거나 사용하도록 설정할 수 있습니다. 관리자가 작업 영역 설정 재정의를 허용한 경우 작업 영역 관리자는 특정 작업 영역에 대해 Databricks Assistant를 사용하거나 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 Databricks Assistant 사용 또는 사용 안 함을 참조 하세요.

계정에 대한 Databricks Assistant의 사용은 감사 로그에서 계정 이벤트로 캡처됩니다. 계정 수준 계정 이벤트를 참조하세요.

추가 정보

다음 문서에는 Databricks Assistant 사용에 대한 추가 정보가 포함되어 있습니다.

Databricks 길잡이를 사용하는 방법

Databricks Assistant는 Notebook, SQL 편집기, 파일 편집기 및 대시보드에서 사용할 수 있습니다. 이 문서에서는 Notebook에 중점을 둡니다. 다른 제품의 사용량도 비슷합니다. Databricks Assistant를 사용하여 대시보드에 대한 시각화를 만드는 방법에 대한 자세한 내용은 Databricks Assistant를 사용하여 시각화 만들기를 참조하세요.

Notebook에서 Databricks Assistant는 길잡이 창 또는 코드 셀의 인라인에서 사용할 수 있습니다.

Notebook 셀에서 Databricks Assistant 사용

코드 셀에서 직접 Databricks Assistant를 사용하려면 MacOS 또는 Ctrl + i Windows를 누릅니 Cmd + i 다. 셀 내에 텍스트 상자가 나타납니다. 영어로 질문이나 메모를 입력한 다음 Enter 키를 눌러(셀을 실행하는 것처럼 Shift+Enter가 아님) 도우미 응답을 생성할 수 있습니다.

사용 중인 인라인 도우미 스크린샷

셀의 코드를 설명하고, 코드에 오류가 있는 경우 수정 사항을 제안하고/doc, /fix 코드에 대한 설명서 주석을 제안하는 등의 /explain 일반적인 명령 목록을 표시하도록 입력 / 할 수도 있습니다.

사용 /fix 하거나 /doc사용하는 경우 도우미 diff 창에 제안된 변경 내용을 표시합니다. 제안된 변경 내용을 적용하려면 [수락]을 선택하고 원래 코드를 유지하려면 [거부]를 선택합니다. 제안된 코드를 수락하면 코드가 자동으로 실행되지 않습니다. 코드를 실행하기 전에 검토할 수 있습니다. 생성된 코드가 원하는 코드가 아닌 경우 메모에 더 많은 세부 정보 또는 정보를 추가하여 다시 시도합니다. Databricks Assistant 사용에 대한 팁 참조하세요.

코드 자동 완성의 경우 Notebook 셀보다 길잡이 창을 사용하는 것이 성능이 더 좋을 수 있습니다.

전자 필기장 셀에서 Assistant를 종료하려면 셀의 오른쪽 위 모서리를 클릭합니다 도우미 닫기 . 생성된 코드를 수락하거나 거부하면 도우미가 자동으로 닫힙니다.

도우미 창 사용

길잡이 창을 열려면 왼쪽 사이드바를 클릭합니다 Databricks 도우미 아이콘 .

사용 중인 도우미 창의 스크린샷

길잡이 창 아래쪽의 텍스트 상자에 질문을 입력하고 Enter 키를 누르거나 텍스트 상자 오른쪽을 클릭합니다도우미 텍스트 입력. 길잡이가 대답을 표시합니다. 다음 스크린샷은 길잡이 창에서 도우미가 코드를 생성한 후 수행할 수 있는 작업을 보여 줍니다.

도우미 창의 코드 상자 맨 위에 있는 아이콘

동일한 쿼리를 다시 실행하여 다른 답변을 생성할 수 있습니다. 이렇게 하려면 커서를 답변 위로 마우스로 가리킨 다음 클릭합니다 쿼리 다시 생성 아이콘.

창을 닫려면 아이콘을 다시 클릭하거나 셀의 오른쪽 위 모서리를 클릭합니다 도우미 닫기 . 클릭하여 창을 전체 너비로 확장할 수 있습니다. 클릭하여 전체 너비 열기 아이콘전체 너비 닫기 아이콘 창을 기본 너비로 반환합니다.

도우미 창 맨 위에 있는 아이콘

도우미 창은 창이나 전자 필기장을 닫아도 대화를 추적합니다. 이전 대화를 지우려면 길잡이 창의 오른쪽 상단을 클릭합니다 clear-도우미 .

AI 기반 자동 완성

Important

이 기능은 공개 미리 보기 상태입니다.

AI 기반 자동 완성은 Databricks Notebook, SQL 편집기 및 파일 편집기를 입력할 때 인라인 코드 제안을 제공합니다. 인라인 코드 제안은 Python 및 SQL에 사용할 수 있습니다.

인라인 코드 제안 사용 및 사용 안 함

이 기능은 다음과 같이 각 사용자에 대해 사용하도록 설정해야 합니다.

  1. 사용자 설정 아이콘설정을 클릭합니다.
  2. 실험적 기능에서 Databricks Assistant 자동 완성을 토글합니다.

참고 항목

  • 작업 영역에 대해 이 기능을 사용하지 않도록 설정하려면 Databricks에 문의하세요.
  • 인라인 코드 제안은 FedRAMP 규정 준수를 사용하는 Azure Government 지역 또는 작업 영역에서 사용할 수 없습니다.

인라인 코드 제안 사용

입력하면 제안이 자동으로 표시됩니다. Tab 키를 눌러 제안을 수락합니다. 제안을 수동으로 트리거하려면 Option + Shift + Space(macOS) 또는 Control + Shift + Space(Windows)를 누릅니다.

코드 완료 SQL

코드 완료 Python

AI 기반 자동 완성은 주석에서 코드를 생성할 수도 있습니다.

주석에서 완료된 코드

코드 디버그

Databricks Assistant를 사용하여 코드를 수정하려면 길잡이 창에서 질문을 하거나 오류가 발생할 때 셀 결과에 나타나는 오류 진단 단추를 클릭합니다. 아래 탭에서는 Python 및 SQL 코드에 대한 예제를 보여 줍니다.

Python

도우미 디버깅 예제

Sql

도우미 디버깅 예제

코드 설명

Databricks Assistant는 코드 조각에 대한 자세한 설명을 제공할 수 있습니다. 입력한 프롬프트에서 "간결함" 또는 "코드 줄별 설명"이라는 용어를 포함시켜 제공된 설명에 대한 세부 수준을 요청할 수 있습니다. Databricks Assistant에 코드에 주석을 추가하도록 요청할 수도 있습니다.

Azure Databricks 설명서에서 관련 정보 찾기

Databricks 길잡이는 Notebook 편집기에서 직접 Databricks 설명서를 기반으로 질문에 답변하는 데 도움이 될 수 있습니다.

Databricks 설명서를 기반으로 질문 답변

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에서 제공하는 구조와 세부 정보는 동일한 프롬프트에 대해서도 때때로 다릅니다. 원하는 형식, 세부 수준 등으로 원하는 정보를 반환할 수 있도록 가능한 한 많은 지침을 도우미 제공해 보세요. 예시:

  • "이 코드를 몇 문장으로 설명" 또는 "이 코드를 줄별로 설명"합니다.
  • "MatPlotLib을 사용하여 시각화 만들기" 또는 "Seaborn을 사용하여 시각화 만들기"

행 수준 데이터 값의 예제 제공

Databricks Assistant는 행 수준 데이터를 사용하지 않으므로 가장 정확한 답변을 얻으려면 프롬프트에 더 자세한 정보를 제공해야 할 수 있습니다. 카탈로그 탐색기에서 테이블 또는 열 주석을 사용하여 샘플 데이터 줄을 추가합니다. 예를 들어 높이 열이 형식 feet-inches이라고 가정합니다. 도우미 데이터를 해석하는 데 도움이 되도록 "높이 열은 문자열 형식이며 하이픈으로 구분됩니다. 예: '6-2'." 테이블 및 열 주석에 대한 자세한 내용은 markdown 주석을 사용하여 카탈로그 탐색기의 문서 데이터를 참조 하세요.

작업을 수행하기 위해 열 데이터 형식 변환이 필요한 경우 세부 정보를 제공해야 할 수도 있습니다. 예를 들어 "pandas DataFrame을 PySpark DataFrame으로 변환하고 열 변동의 데이터 형식을 부울에서 정수로 변경하는 데 필요한 코드를 포함하여 이 코드를 pandas에서 PySpark로 변환합니다."

Shift+Enter를 사용하여 채팅 텍스트 상자에 새 줄 추가

Shift+Enter를 사용하여 길잡이 채팅 텍스트 상자에 새 줄을 추가할 수 있습니다. 이렇게 하면 Databricks Assistant로 메시지의 서식을 쉽게 지정하고 구성할 수 있습니다.

Databricks 길잡이 채팅 창에서 코드 편집 및 실행

도우미 창에서 코드를 실행하여 유효성을 검사하거나 스크래치 패드로 사용할 수 있습니다. 코드를 실행하려면 길잡이 창에서 코드 상자의 왼쪽 위 모서리를 클릭합니다 코드 실행 아이콘 . 아래 탭에서는 Python 및 SQL 코드에 대한 예제를 보여 줍니다.

Python

도우미 창에서 코드 실행

Sql

도우미 창에서 코드 실행

도우미 창에서 코드를 실행하면 출력이 표시되고 Notebook에서 변수를 사용할 수 있게 됩니다.

코드를 Notebook으로 이동하기 전에 Databricks Assistant가 도우미 채팅 상자에서 직접 생성하는 코드를 편집할 수도 있습니다.