Azure Databricks Excel 추가 기능 설정

Azure Databricks Excel 추가 기능은 Azure Databricks 작업 영역을 Microsoft Excel 연결하여 관리되는 Lakehouse 데이터를 스프레드시트로 직접 가져와 데이터에서 의사 결정으로 더 빠르게 이동할 수 있도록 합니다. 추가 기능은 Windows 및 macOS 모두에 대해 웹용 Excel 및 데스크톱 버전에서 완전히 지원됩니다.

이 페이지에서는 Microsoft Excel Azure Databricks Excel 추가 기능을 설정하는 데 사용할 수 있는 두 가지 방법을 설명합니다. 이 추가 기능은 SSO(Single Sign-On) 인증을 사용하여 Azure Databricks 작업 영역에 연결하고 데이터 거버넌스 및 액세스 제어를 위해 Unity Catalog 지원합니다.

필수 구성 요소

Excel 추가 기능을 설치하기 전에 다음이 있는지 확인합니다.

• Unity 카탈로그를 사용하도록 설정된 Azure Databricks 작업 영역에 액세스합니다.
• 작업 영역 관리자는 Excel 커넥터 미리 보기를 사용하도록 설정해야 합니다. Azure Databricks 미리 보기 관리를 참조하세요.
• Excel이 연결해야 하는 각 작업 영역의 Azure Databricks workspace URL. 사용자 지정 계정 URL은 지원되지 않습니다.
• 실행 중인 SQL 웨어하우스에 대한 액세스
• 작업 영역의 Unity 카탈로그 테이블에서 데이터를 읽을 수 있는 권한입니다.
• 다음 Excel 버전 중 하나입니다.
  • Mac에서 Excel 2019 이상
  • Windows Excel(Microsoft 365)
  • 웹에서의 Excel
  • Mac에서 Excel(Microsoft 365)
• 방화벽 또는 클라우드 보안 플랫폼을 사용하는 경우 추가 기능 파일에 포함된 Azure Databricks 작업 영역 URL을 허용 목록에 추가합니다.

추가 기능 파일 설정

추가 기능 파일은 Excel Azure Databricks 안전하게 연결하는 방법을 알려주는 작은 커넥터 파일입니다. 추가 기능이 올바르게 로드되고 Excel 열 때마다 최신 상태로 유지되도록 하는 디지털 핸드셰이크 역할을 합니다.

Azure Databricks Excel 추가 기능을 사용하도록 추가 기능 파일을 다운로드하고 설정합니다.

1. 다음 링크를 클릭하여 추가 기능 파일을 엽니다.

   Azure Databricks Excel 추가 기능 파일

2. 페이지를 로컬 컴퓨터에 파일로 .xml 저장합니다. 대부분의 브라우저에서 페이지를 마우스 오른쪽 단추로 클릭하고 로 저장을 선택하거나 Ctrl+S(Windows) 또는 Command+S(macOS)를 누릅니다.

3. 작업 영역 URL을 <AppDomain> 섹션 내에서 AppDomains로 지정하여 추가 기능 파일을 편집합니다. 작업 영역 URL은 브라우저에서 Azure Databricks 작업 영역에 액세스하는 데 사용하는 기본 URL입니다. 여러 Azure Databricks 작업 영역 간에 전환하려면 각 작업 영역 URL을 추가 기능 파일에 추가합니다.

   <AppDomains>
      <!-- DO NOT CHANGE -->
      <AppDomain>https://www.databricks.com</AppDomain>
      <AppDomain>https://login.databricks.com</AppDomain>
      <!-- ADD WORKSPACE URLS AS SHOWN BELOW; PUT EACH WORKSPACE URL IN ITS OWN <AppDomain> TAG  -->
      <!-- EXAMPLE -->
      // highlight-next-line
      <AppDomain>https://adb-<workspace1-id>.<random-number>.azuredatabricks.net</AppDomain>
      // highlight-next-line
      <AppDomain>https://adb-<workspace2-id>.<random-number>.azuredatabricks.net</AppDomain>
   </AppDomains>
   

   메모

   서식을 지정하지 않고 작업 영역 URL을 일반 텍스트로 붙여넣습니다. 대부분의 텍스트 편집기에서 Ctrl+Shift+V(Windows) 또는 Command+Shift+V(macOS)를 사용합니다.

4. 변경 내용을 저장합니다. 파일이 .xml 파일 형식으로 올바르게 지정되었는지 확인합니다.

옵션 1: 관리자 관리

전역 관리자는 조직의 사용자에게 Azure Databricks Excel 추가 기능을 배포할 수 있습니다. 추가 기능 파일을 사용하여 추가 기능을 사용자 지정 앱으로 배포하거나 Microsoft Marketplace에서 설치할 수 있습니다.

Azure Databricks Excel 추가 기능을 Microsoft 365 관리 설치하려면 global admin 권한이 있어야 합니다. 관리자는 조직에서 추가 기능을 사용할 수 있는 사용자를 결정할 수 있습니다. Microsoft 365 전역 관리자에 대한 자세한 내용은 Microsoft 설명서 참조하세요.

사용자 지정 앱으로 배포

사용자 지정 매니페스트 파일을 사용하여 추가 기능을 배포합니다. 필수 구성 요소에 제공된 추가 기능 파일을 다운로드하고 설정합니다.

1. Microsoft 365 관리 센터 settings > 통합 앱로 이동하여 Add-ins 링크를 클릭합니다.
2. 추가 기능 배포를 클릭하고 다음을 클릭합니다.
3. 새 추가 기능을 배포하는 옵션으로 사용자 지정 앱 업로드 를 클릭합니다.
4. 매니페스트를 업로드하는 옵션을 선택합니다. 파일 선택을 클릭하고 추가 기능 파일을 업로드합니다.
5. 추가 기능에 액세스할 수 있는 사용자를 선택합니다.
6. 배포을 참조하십시오.

Azure Databricks Excel 추가 기능을 업로드하는 방법에 대한 자세한 단계는 Microsoft 설명서 참조하세요.

Microsoft Marketplace에서 배포

Microsoft Marketplace에서 추가 기능을 설치하고 PowerShell을 사용하여 작업 영역 액세스를 구성합니다.

사전 요구 사항

• PowerShell 이 컴퓨터에 설치됩니다.
• 관리자 권한으로 Windows PowerShell을 실행해야 합니다.

추가 기능 설치

1. Microsoft 365 관리 센터 settings > 통합 앱으로 이동하고 Get Apps 링크를 클릭합니다.
2. "Excel Azure Databricks 추가 기능"을 검색합니다.
3. 지금 가져오기를 클릭합니다.
4. 사용자 할당에서 저스트 미를 선택하여 추가 기능을 자신에게 배포합니다.
5. 배포을 참조하십시오.

Microsoft Marketplace에서 Azure Databricks Excel 추가 기능을 배포하는 방법에 대한 자세한 단계는 Microsoft 설명서 참조하세요.

작업 영역 액세스 구성

추가 기능을 설치한 후 PowerShell을 사용하여 Azure Databricks 작업 영역 URL을 허용 목록에 추가합니다.

1. PowerShell을 열고 관리자 권한으로 실행합니다. 자세한 내용은 Microsoft 설명서 참조하세요.

2. Office 365 중앙 집중식 배포 모듈을 설치하고 가져옵니다.

   Install-Module -Name O365CentralizedAddInDeployment
   Import-Module O365CentralizedAddInDeployment
   

3. Office 365 테넌트에 관리자로 연결하고 로그인합니다.

   Connect-OrganizationAddInService
   

4. 추가 기능이 배포되었는지 확인합니다. Excel 대한 Azure Databricks 추가 기능이 목록에 표시됩니다.

   Get-OrganizationAddIn
   

   추가 기능이 표시되지 않으면 다시 배포해야 하거나 배포 중일 수 있습니다.

5. 허용 목록 Azure Databricks 작업 영역 URL입니다. 각각 <workspace-url> 을 허용하려는 작업 영역의 URL로 바꿉다. 필요한 만큼 작업 영역 URL을 포함할 수 있습니다.

   Set-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052 `
     -AppDomains "https://adb-<workspace1-id>.<random-number>.azuredatabricks.net", "https://adb-<workspace2-id>.<random-number>.azuredatabricks.net"
   

   Azure Databricks 제품 ID는 d75dbea5-bf93-49b8-9a49-bdf4e9d6f052.

6. 올바른 허용 목록을 확인합니다. 허용된 목록에 추가한 작업 영역 URL이 AppDomains 섹션에 표시되어야 합니다.

   Get-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052
   

추가 기능 테스트

1. Excel에서 Azure Databricks 추가 기능을 찾으세요.
2. 로그인하고 허용 목록에 있는 작업 영역 중 하나에 연결합니다.

조직에 배포

1. Microsoft 365 관리 센터에서 설정 > 통합 앱으로 이동하십시오.
2. 설치하고 구성한 Azure Databricks 추가 기능을 선택합니다.
3. 사용자 탭을 클릭하고 전체 조직 또는 특정 사용자 그룹에 배포할지 여부를 선택합니다.

옵션 2: 셀프 서비스

설치 단계는 Excel 플랫폼에 따라 달라집니다. 필수 구성 요소에 제공된 추가 기능 파일을 다운로드하고 설정합니다.

웹용 Excel

Excel 추가 기능을 설치하고 연결하려면, 웹용 Excel에서 다음을 수행합니다.

1. 웹에서 Excel을 열고 통합 문서를 만들거나 엽니다.
2. 홈 탭에서 추가 기능>을 클릭합니다.
3. 내 추가 기능 업로드를 클릭합니다.
4. 추가 기능 파일을 업로드합니다.
5. 업로드를 클릭합니다.
6. 추가 기능 메뉴에서 Azure Databricks 추가 기능을 찾아 클릭합니다.
7. Azure Databricks 계정에 로그인합니다. 오류가 있는 경우 팝업 대화 상자를 사용하도록 설정해야 합니다.
8. 여러 작업 영역 URL을 구성한 경우 원하는 Azure Databricks 계정 이름을 선택합니다. URL이 동일한 계정 내에 있는 경우에만 특정 작업 영역을 선택해야 합니다. 계정 이름에 대한 자세한 내용은 계정 ID 찾기를 참조하세요.

Excel Desktop(Windows)

Windows Excel Desktop에서 Excel 추가 기능을 설치하려면 다음을 수행합니다.

1. 로컬 드라이브에 이름이 지정된 Manifest 폴더를 만듭니다(예: C:\Manifest).
2. 추가 기능 파일을 폴더에 복사합니다 C:\Manifest .
3. 폴더 속성을 열고 폴더를 공유합니다.
   1. 폴더를 마우스 오른쪽 단추로 Manifest 클릭하고 속성을 선택합니다.
   2. 공유 공유>를 클릭하고 읽기 및 쓰기 권한이 있는 사용자로 자신을 추가합니다.
4. Excel Desktop을 엽니다.
5. 매니페스트 폴더를 신뢰하도록 Excel 구성합니다.
   1. 파일>옵션>보안 센터> 설정을 클릭합니다.
   2. 사이드바에서 신뢰할 수 있는 추가 기능 카탈로그를 클릭합니다.
   3. 카탈로그 URL에서 추가 기능 파일이 있는 공유 폴더의 경로를 입력합니다(예: \\YourComputerName\Manifest).
   4. 카탈로그 추가를 클릭합니다.
   5. 메뉴에 표시 확인란을 선택합니다.
   6. 확인을 클릭하여 변경 내용을 저장합니다.
6. Excel Desktop을 다시 시작합니다.
7. 제목 표시줄의 검색 상자에서 "추가 기능으로 삽입"을 검색하고 결과에서 선택합니다.
8. Azure Databricks 커넥터를 선택하고 Add 클릭합니다.
9. Azure Databricks 추가 기능을 클릭하고 Azure Databricks 계정에 대한 로그인 프로세스를 완료합니다.
10. 여러 작업 영역 URL을 구성한 경우 원하는 Azure Databricks 계정 이름을 선택합니다. URL이 동일한 계정 내에 있는 경우에만 특정 작업 영역을 선택해야 합니다. 계정 이름에 대한 자세한 내용은 계정 ID 찾기를 참조하세요.

Excel Desktop(macOS)

macOS용 Excel Desktop에서 Excel 추가 기능을 설치하려면 다음을 수행합니다.

1. Microsoft Office 추가 기능 폴더를 찾습니다. 기본적으로 디렉터리:

   /Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef
   

2. 이 폴더에 추가 기능 파일을 복사합니다.

3. Excel Desktop을 열거나 다시 시작합니다.

4. 탐색 모음에서 추가 기능>내 추가 기능을 클릭합니다.

5. Azure Databricks 추가 기능을 클릭합니다.

6. Azure Databricks 계정에 대한 로그인 프로세스를 완료합니다.

7. 여러 작업 영역 URL을 구성한 경우 원하는 Azure Databricks 계정 이름을 선택합니다. URL이 동일한 계정 내에 있는 경우에만 특정 작업 영역을 선택해야 합니다. 계정 이름에 대한 자세한 내용은 계정 ID 찾기를 참조하세요.

추가 기능에 로그인

조직의 관리자가 Azure Databricks Excel 추가 기능을 배포한 경우 로그인하여 Excel Azure Databricks 작업 영역에 연결합니다.

1. Excel 홈 탭에서 Azure Databricks 추가 기능을 클릭합니다.
2. 작업 영역 URL을 입력하거나 드롭다운에서 이전에 사용한 작업 영역 URL을 선택합니다. 추가 기능은 사용자 또는 관리자가 구성한 작업 영역 URL을 기억합니다.
3. 사인를 클릭하고 인증 프로세스를 완료하여 모든 Azure Databricks Excel 추가 기능 액세스 권한을 얻습니다.

Azure Databricks 작업 영역 변경

추가 기능 파일이 여러 Azure Databricks 작업 영역을 지정하는 경우 해당 작업 영역 간에 전환할 수 있습니다. 자세한 내용은 추가 기능 파일 설정을 참조하세요.

다른 Azure Databricks 작업 영역에 연결하려면 다음을 수행합니다.

1. Azure Databricks 추가 기능 창의 오른쪽 위에서 컴퓨팅 선택기 옆에 있는 세 개의 점 메뉴를 클릭합니다.
2. 작업 영역 변경을 클릭합니다.
3. 작업 영역이 포함된 계정을 선택하고, 필요하면 작업 영역을 선택한 후 로그인합니다.

문제 해결

로그인할 때 "인증 진행 중" 메시지

추가 기능에서 Azure Databricks 로그인하려고 할 때 "인증 진행 중" 창이 표시되면 작업 영역이 사용자 지정 추가 기능 파일에 올바르게 추가되지 않았을 수 있습니다. 에서 <AppDomains>작업 영역을 올바르게 구성했는지 확인합니다.

로그인할 때 "관리자 승인 필요" 메시지

Microsoft Entra 테넌트가 Azure Databricks 애플리케이션에 대한 사용자 동의를 차단하기 때문에 Excel 추가 기능 Azure Databricks 작업 영역에 로그인할 때 다음 "관리자 승인 필요" 메시지가 표시됩니다. 관리자 동의가 부여되지 않은 경우 직접 작업 영역 액세스 권한이 있더라도 Microsoft Entra ID 로그인 흐름을 계속 차단합니다.

이 문제를 해결하려면 적절한 관리자 역할을 가진 Microsoft Entra 사용자가 Azure Databricks 엔터프라이즈 애플리케이션에 테넌트 전체 관리자 동의를 부여해야 합니다.

1. Microsoft Entra 관리 센터에서 Entra ID>Enterprise 앱>모든 애플리케이션로 이동하여 Single Sign-On에 사용되는 Azure Databricks 엔터프라이즈 애플리케이션을 찾습니다.
2. Azure Databricks 엔터프라이즈 앱에서 요청한 권한에 대한 관리자 동의를 부여합니다.
   1. 보안에서 사용 권한을 클릭합니다.
   2. 관리자 동의 부여를 클릭합니다.

자세한 지침은 Microsoft 설명서 참조하세요.

리소스를 사용할 수 없음

Azure Databricks 추가 기능에서 SQL 웨어하우스와 같은 Azure Databricks 리소스를 사용할 수 없는 경우 사용 중인 Excel 버전에 따라 다음 방법 중 하나를 시도해 보세요.

• 웹용 Excel: 시트를 다시 시작하거나 작업 영역을 변경하고 동일한 작업 영역에 다시 로그인합니다. Azure Databricks 작업 영역 변경 참조하세요.
• Excel Desktop: 오른쪽 위 모서리에 있는 정보 아이콘을 클릭하고 Reload 선택하여 추가 기능을 다시 로드합니다.

다음 단계

• Azure Databricks Excel 추가 기능을 사용하여 데이터 가져오기 및 쿼리