Konfigurowanie dodatku Azure Databricks Excel

Note

Dodatek Azure Databricks Excel nie jest dostępny w regionach Azure Government lub Azure Chinach.

Dodatek Azure Databricks Excel łączy twoją przestrzeń Azure Databricks z Microsoft Excel, przenosząc zarządzane dane Lakehouse bezpośrednio do arkuszy kalkulacyjnych. Dodatek jest w pełni obsługiwany zarówno w wersji przeglądarkowej, jak i desktopowej programu Excel dla systemów Windows i macOS.

Na tej stronie opisano dwie dostępne metody konfigurowania dodatku programu Excel usługi Azure Databricks w programie Microsoft Excel. Ten dodatek używa uwierzytelniania logowania jednokrotnego (SSO) w celu nawiązania połączenia z obszarem roboczym Azure Databricks i obsługuje Unity Catalog na potrzeby zarządzania danymi i kontroli dostępu.

Warunki wstępne

Przed zainstalowaniem dodatku programu Excel sprawdź, czy masz następujące elementy:

  • Dostęp do obszaru roboczego Azure Databricks z włączonym Unity Catalog.
  • Adres URL Azure Databricks workspace dla każdego obszaru roboczego, z którym Excel powinien się połączyć.
  • Masz dostęp do usługi Azure Databricks SQL oraz co najmniej uprawnienie CAN USE do magazynu SQL. Aby importować dane z niskim opóźnieniem, możesz też użyć magazynu Lakehouse//RT , który obsługuje tylko import.
  • Uprawnienia do odczytywania danych z tabel katalogu Unity w środowisku roboczym.
  • Jedną z następujących wersji Excel:
    • Program Excel 2019 lub nowszy na komputerze Mac
    • Excel w Windows (Microsoft 365)
    • Excel w sieci
    • Excel na komputerze Mac (Microsoft 365)
  • Jeśli używasz zapory lub platformy zabezpieczeń w chmurze, dodaj do listy dozwolonych adresy URL obszaru roboczego Azure Databricks zawarte w dodatku.
  • Jeśli Twój Microsoft Entra Tenant blokuje zgodę użytkownika na aplikacje firm trzecich, administrator Microsoft Entra musi udzielić zgody administratora na aplikację enterprise Azure Databricks z pojedynczym logowaniem, zanim użytkownicy będą mogli zalogować się za pomocą narzędzia wyboru konta. Nie jest to wymagane, jeśli użytkownicy logują się poprzez bezpośrednie wpisanie adresu URL przestrzeni roboczej. Zobacz komunikat "Potrzebujesz zatwierdzenia przez administratora" podczas logowania.

Konfigurowanie pliku dodatku

Note

Jeśli jesteś administratorem wdrażającym dodatek za pośrednictwem witryny Microsoft Marketplace, pomiń tę sekcję. Wdrożenie Marketplace konfiguruje dostęp do środowiska pracy za pomocą programu PowerShell zamiast używać pliku dodatku. Zobacz Wdrażanie za pośrednictwem sklepu Microsoft Marketplace.

Plik dodatku to mały plik łącznika, który informuje Excel, jak bezpiecznie nawiązać połączenie z Azure Databricks. Działa jako cyfrowy uścisk dłoni, który zapewnia prawidłowe ładowanie dodatku i jego stałą aktualność za każdym razem, gdy otworzysz Excel.

Pobierz i skonfiguruj plik dodatku, aby korzystać z dodatku programu Excel usługi Azure Databricks. Pojedynczy plik dodatku może łączyć się z wieloma przestrzeniami roboczymi Azure Databricks.

  1. Pobierz plik Azure Databricks Excel add-in:

    Pobierz plik dodatku programu Excel

  2. Edytuj plik dodatku, określając adres URL obszaru roboczego<AppDomain> jako element w ramach AppDomains sekcji. Adres URL obszaru roboczego to podstawowy adres URL używany do uzyskiwania dostępu do obszaru roboczego usługi Azure Databricks w przeglądarce. Aby przełączać się między wieloma obszarami roboczymi usługi Azure Databricks, dodaj każdy adres URL obszaru roboczego do pliku dodatku.

    Aby zalogować się za pomocą niestandardowego adresu URL, dodaj zarówno niestandardowy adres URL, jak i powiązany adres URL obszaru roboczego jako oddzielne wpisy <AppDomain>, jak pokazano w poniższych przykładach. Logowanie może przekierować na dowolny adres 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>
   <!-- TO USE A CUSTOM URL, ADD BOTH THE CUSTOM URL AND ITS ASSOCIATED WORKSPACE URL -->
   // highlight-next-line
   <AppDomain>https://<custom-url>.azuredatabricks.net</AppDomain>
</AppDomains>

    Note

    Wklej adres URL obszaru roboczego jako zwykły tekst bez formatowania. W większości edytorów tekstowych użyj Ctrl+Shift+V (Windows) lub Command+Shift+V (macOS).

  3. Zapisz swoje zmiany. Sprawdź, czy plik jest poprawnie sformatowany jako .xml plik.

Opcja 1: Wdrożenie z Centrum administracyjne platformy Microsoft 365

Jako administrator globalny możesz wdrożyć dodatek Azure Databricks Excel dla użytkowników w organizacji. Dodatek można wdrożyć jako aplikację niestandardową przy użyciu pliku dodatku lub zainstalować go z witryny Microsoft Marketplace.

Aby zainstalować dodatek Azure Databricks Excel jako Administracja Microsoft 365, musisz mieć uprawnienie global admin. Jako administrator możesz określić, którzy użytkownicy w organizacji mogą używać dodatków. Aby uzyskać więcej informacji na temat administratorów globalnych na platformie Microsoft 365, zobacz dokumentację firmy Microsoft.

Dostęp do Centrum administracyjne platformy Microsoft 365 znajdziesz tutaj.

Note

Usługa Databricks zaleca wdrożenie dodatku Azure Databricks Excel jako aplikacji niestandardowej.

Wdrażanie jako aplikacja niestandardowa

Wdróż dodatek przy użyciu niestandardowego pliku manifestu. Pobierz i skonfiguruj plik dodatku podany w wymaganiach wstępnych.

  1. W centrum administracyjnym platformy Microsoft 365 przejdź do pozycji Ustawienia > Zintegrowane aplikacje i kliknij link Dodatki .
  2. Kliknij pozycję Wdróż dodatek , a następnie kliknij przycisk Dalej.
  3. Kliknij pozycję Przekaż aplikacje niestandardowe jako opcję wdrożenia nowego dodatku.
  4. W rozwijanym menu typu aplikacji wybierz Dodatek Office.
  5. Wybierz opcję Prześlij plik manifestu (.xml) z urządzenia. Kliknij pozycję Wybierz plik i prześlij plik dodatku.
  6. Wybierz użytkowników, którzy powinni mieć dostęp do dodatku.
  7. Kliknij Wdróż.

Note

Jeśli opcja dodatku Office nie jest wyświetlana, upewnij się, że Twoja organizacja spełnia wymagania Microsoft 365 dotyczące scentralizowanego wdrożenia, takie jak Exchange Online. Zobacz w dokumentacji Microsoft Jak ustalić, czy scentralizowane wdrażanie dodatków działa w Twojej organizacji.

Aby uzyskać szczegółowe instrukcje dotyczące przekazywania dodatku programu Excel usługi Azure Databricks, zobacz dokumentację firmy Microsoft.

Wdrażanie z witryny Microsoft Marketplace

Zainstaluj dodatek z witryny Microsoft Marketplace i skonfiguruj dostęp do obszaru roboczego przy użyciu programu PowerShell. Samo zainstalowanie dodatku nie powoduje połączenia go z obszarami roboczymi usługi Azure Databricks. Wykonaj wszystkie poniższe kroki, w tym dodanie adresów URL obszaru roboczego do listy dozwolonych za pomocą programu PowerShell.

Prerequisites

  • Program PowerShell jest zainstalowany na maszynie.
  • Musisz uruchomić program Windows PowerShell jako administrator.

Instalowanie dodatku

  1. W Centrum administracyjne platformy Microsoft 365 przejdź do Ustawienia > Zintegrowane aplikacje i kliknij link Pobierz aplikacje.
  2. Wyszukaj "Dodatek Azure Databricks do programu Excel".
  3. Kliknij Pobierz teraz.
  4. Wdróż dodatek samodzielnie, wybierając opcję Tylko ja w obszarze Przypisz użytkowników.
  5. Kliknij Wdróż.

Aby uzyskać szczegółowe instrukcje dotyczące wdrażania dodatku Azure Databricks Excel z witryny Microsoft Marketplace, zobacz dokumentację Microsoft.

Konfigurowanie dostępu do obszaru roboczego

Po zainstalowaniu dodatku użyj programu PowerShell, aby zezwolić na wyświetlanie adresów URL obszaru roboczego Azure Databricks.

Note

Połączenie programu PowerShell z centrum administracyjnym Office 365 może wygasnąć. Jeśli polecenie zakończy się niepowodzeniem, uruchom ponownie program PowerShell i połącz się ponownie, uruchamiając polecenie Connect-OrganizationAddInService.

  1. Otwórz program PowerShell i uruchom go jako administrator. Aby uzyskać więcej informacji, zobacz dokumentację firmy Microsoft.

  2. Zainstaluj i zaimportuj scentralizowany moduł wdrażania usługi Office 365:

    Install-Module -Name O365CentralizedAddInDeployment
Import-Module O365CentralizedAddInDeployment

  3. Połącz się z tenantem Office 365 i zaloguj się jako administrator.

    Connect-OrganizationAddInService

  4. Upewnij się, że dodatek został wdrożony. Dodatek usługi Azure Databricks dla programu Excel powinien zostać wyświetlony na liście.

    Get-OrganizationAddIn

    Jeśli dodatek nie jest wyświetlany, może być konieczne ponowne wdrożenie lub może być nadal wdrażane.

  5. Wprowadź adresy URL obszaru roboczego Azure Databricks na listę dozwolonych. Zastąp każdy <workspace-url> adresem URL obszaru roboczego, na który chcesz zezwolić. Możesz dołączyć dowolną liczbę adresów URL obszaru roboczego. Aby obsługiwać niestandardowy adres URL, należy podać zarówno niestandardowy adres URL, jak i adres URL powiązanej przestrzeni roboczej.

    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", "https://<custom-url>.azuredatabricks.net"

    Identyfikator produktu dla usługi Azure Databricks to d75dbea5-bf93-49b8-9a49-bdf4e9d6f052.

    Polecenie może zwrócić There was an error uploading the Add-In nawet wtedy, gdy adresy URL przestrzeni roboczej zostaną pomyślnie dodane do listy dozwolonych. Zanim wykonasz polecenie ponownie, wykonaj kolejny krok, aby sprawdzić, czy zastosowano listę dozwolonych.

  6. Potwierdź poprawną listę dozwolonych. Umieszczone na liście dozwolonych adresy URL obszaru roboczego powinny zostać wyświetlone w sekcji AppDomains.

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

Testowanie dodatku

  1. W programie Excel znajdź dodatek usługi Azure Databricks.
  2. Zaloguj się i połącz się z jednym z dozwolonych obszarów roboczych.

Note

Zmiany w dodawaniu do listy dozwolonych mogą wymagać trochę czasu na synchronizację. Jeśli uwierzytelnianie się nie powiedzie, upewnij się, że łączysz się z obszarem roboczym z listy dozwolonych. Jeśli przestrzeń robocza jest poprawna, zamknij Excel i spróbuj ponownie później.

Wdrażanie w organizacji

  1. W Centrum administracyjne platformy Microsoft 365 przejdź do Ustawienia > Zintegrowane aplikacje.
  2. Wybierz dodatek Azure Databricks, który zainstalowałeś i skonfigurowałeś.
  3. Kliknij kartę Użytkownicy i wybierz, czy chcesz wdrożyć w całej organizacji, czy w określonej grupie użytkowników.

Note

Jako administrator udostępnij nazwę konta skojarzonego z obszarami roboczymi dozwolonymi dla użytkowników, którzy planują korzystać z dodatku programu Excel usługi Azure Databricks. Zobacz Logowanie się do dodatku.

Opcja 2: Wdrożenie jako użytkownik indywidualny

Kroki instalacji różnią się w zależności od platformy programu Excel. Pobierz i skonfiguruj plik dodatku podany w wymaganiach wstępnych.

Excel dla sieci

Aby zainstalować dodatek Excel i nawiązać z nim połączenie w Excel w sieci Web, wykonaj następujące czynności:

  1. Otwórz Excel dla sieci web i utwórz lub otwórz skoroszyt.
  2. Na karcie Narzędzia główne kliknij pozycję Dodatki>zaawansowane.
  3. Kliknij Wgraj mój dodatek.
  4. Przekaż plik dodatku.
  5. Kliknij Przekaż.
  6. Znajdź i kliknij dodatek Azure Databricks z menu Dodatek.
  7. Zaloguj się do konta usługi Azure Databricks. Jeśli wystąpi błąd, upewnij się, że włączono wyskakujące okna dialogowe.
  8. Jeśli skonfigurowano wiele adresów URL obszaru roboczego, wybierz żądaną nazwę konta usługi Azure Databricks. Musisz wybrać tylko określony obszar roboczy, jeśli adresy URL znajdują się na tym samym koncie. Aby uzyskać więcej informacji na temat nazw kont, zobacz Lokalizowanie identyfikatora konta.

Excel Desktop (Windows)

Nie instaluj dodatku z zakładki Store . Dodatek zainstalowany w ten sposób nie łączy się z twoim workspace. Zainstaluj dodatek Excel w Excel Desktop for Windows z zakładki Folder współdzielony:

  1. Utwórz folder o nazwie Manifest na dysku lokalnym (na przykład C:\Manifest).
  2. Skopiuj plik dodatku do C:\Manifest folderu .
  3. Otwórz właściwości folderu i udostępnij folder:
    1. Kliknij prawym przyciskiem myszy Manifest folder i wybierz polecenie Właściwości.
    2. Kliknij Udostępnianie>Udostępnij i dodaj siebie jako użytkownika z uprawnieniami do odczytu i zapisu.
  4. Otwórz program Excel Desktop.
  5. Skonfiguruj program Excel tak, aby ufał folderowi manifestu:
    1. Kliknij Plik>Opcje>Centrum zaufania>Ustawienia centrum zaufania.
    2. Na pasku bocznym kliknij pozycję Zaufane wykazy dodatków.
    3. W polu Adres URL wykazu wprowadź ścieżkę do folderu udostępnionego, w którym znajduje się plik dodatku (na przykład \\YourComputerName\Manifest).
    4. Kliknij pozycję Dodaj wykaz.
    5. Zaznacz pole wyboru Pokaż w menu .
    6. Kliknij przycisk OK , aby zapisać zmiany.
  6. Uruchom ponownie program Excel Desktop.
  7. W zakładce Home kliknij Add-ins>More Add-ins.
  8. W sekcji Shared Folder wybierz Azure Databricks Add-in for Excel.
  9. Ukończ proces logowania do konta Azure Databricks.
  10. Jeśli skonfigurowano wiele adresów URL obszaru roboczego, wybierz żądaną nazwę konta usługi Azure Databricks. Musisz wybrać tylko określony obszar roboczy, jeśli adresy URL znajdują się na tym samym koncie. Aby uzyskać więcej informacji na temat nazw kont, zobacz Lokalizowanie identyfikatora konta.

Excel Desktop (macOS)

Aby zainstalować dodatek Excel w programie Excel Desktop dla systemu macOS, wykonaj następujące czynności:

  1. Skopiuj plik dodatku do folderu Microsoft Office Add-ins. wef Jeśli folder nie istnieje, utwórz go.

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

  2. Otwórz lub uruchom ponownie program Excel Desktop.

  3. Na pasku nawigacyjnym kliknij pozycję Dodatki>Moje dodatki.

  4. Kliknij dodatek Azure Databricks.

  5. Ukończ proces logowania do konta Azure Databricks.

  6. Jeśli skonfigurowano wiele adresów URL obszaru roboczego, wybierz żądaną nazwę konta usługi Azure Databricks. Musisz wybrać tylko określony obszar roboczy, jeśli adresy URL znajdują się na tym samym koncie. Aby uzyskać więcej informacji na temat nazw kont, zobacz Lokalizowanie identyfikatora konta.

Zaloguj się do dodatku

Jeśli administrator w organizacji wdrożył dodatek programu Excel usługi Azure Databricks, zaloguj się i połącz się z obszarem roboczym usługi Azure Databricks z programu Excel.

  1. W Excel na karcie Strona główna kliknij dodatek Azure Databricks.

  2. Przy pierwszym logowaniu połącz się z przestrzenią roboczą, korzystając z jednej z następujących opcji:

    • Wprowadź adres URL obszaru roboczego (zalecane): Wprowadź adres URL obszaru roboczego usługi Azure Databricks. Ta opcja umożliwia zalogowanie się za pomocą SSO obszaru roboczego. Aby zalogować się za pomocą niestandardowego adresu URL, sprawdź, czy zarówno niestandardowy adres URL, jak i powiązany adres URL obszaru roboczego zostały dodane do pliku dodatku. Zobacz, jak skonfigurować plik dodatku.
    • Użyj selektora konta: Kliknij Wybierz selektor konta, aby otworzyć login.databricks.com, a następnie wybierz konto z listy dozwolonych i obszar roboczy.

  3. Kliknij Zaloguj się i zakończ proces uwierzytelniania, aby uzyskać dostęp do dodatku Azure Databricks Excel.

Po pierwszym zalogowaniu dodatek zapamiętuje twoje przestrzenie robocze. Podczas późniejszych logowań wybierz przestrzeń roboczą z menu rozwijanego lub użyj jednej z powyższych opcji, aby połączyć się z inną przestrzenią pracy.

Jeśli używasz uwierzytelniania Microsoft Entra ID i pojawi się komunikat "Potrzebna zgoda administratora", administrator Microsoft Entra musi zatwierdzić aplikację korporacyjną Azure Databricks, zanim będziesz mógł się zalogować. Zobacz komunikat "Potrzebujesz zatwierdzenia przez administratora" podczas logowania.

Zmień obszar roboczy Azure Databricks

Jeśli plik dodatku określa wiele obszarów roboczych usługi Azure Databricks, możesz przełączać się między tymi obszarami roboczymi. Aby uzyskać więcej informacji, zobacz Konfigurowanie pliku dodatku.

Aby nawiązać połączenie z innym obszarem roboczym usługi Azure Databricks, wykonaj następujące czynności:

  1. W prawym górnym rogu okienka dodatku Azure Databricks kliknij menu z trzema kropkami obok selektora zasobów obliczeniowych.
  2. Kliknij pozycję Zmień obszar roboczy.
  3. Wybierz konto, w którym znajduje się obszar roboczy, a następnie wybierz obszar roboczy, jeśli zostaniesz o to poproszony, i zaloguj się.

Rozwiązywanie problemów

Komunikat "Uwierzytelnianie w toku" podczas logowania

Jeśli podczas próby zalogowania się do usługi Azure Databricks z dodatku zostanie wyświetlone okno "Uwierzytelnianie w toku", obszar roboczy może nie zostać poprawnie dodany do niestandardowego pliku dodatku. Upewnij się, że swój obszar roboczy został poprawnie skonfigurowany w sekcji <AppDomains>.

Komunikat "Potrzebuję zatwierdzenia przez administratora" podczas logowania

Podczas logowania się do obszaru roboczego Azure Databricks za pomocą dodatku Excel pojawia się następujący komunikat: "Potrzebna zgoda administratora", ponieważ dzierżawa Microsoft Entra blokuje zgodę użytkownika dla aplikacji Azure Databricks. Dotyczy to tylko wtedy, gdy zalogujesz się za pomocą narzędzia wyboru konta (login.databricks.com); aby tego uniknąć, wpisz bezpośrednio adres URL swojego workspace przy logowaniu. Jeśli nie udzielono zgody administratora, Microsoft Entra ID nadal blokuje przepływ logowania, nawet jeśli masz bezpośredni dostęp do obszaru roboczego.

Komunikat o potrzebie zatwierdzenia przez administratora w dodatku Excel

Aby rozwiązać ten problem, użytkownik Microsoft Entra z odpowiednimi rolami administratora musi udzielić zgody administratora obejmującej całą dzierżawę dla aplikacji korporacyjnej Azure Databricks.

Poproś administratora Microsoft Entra, aby odwiedził następujący link. Zastąp element {TENANT_ID} identyfikatorem dzierżawy usługi Microsoft Entra:

https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

Jeśli link zakończy się niepowodzeniem, administrator może udzielić zgody ręcznie:

  1. W centrum administracyjne Microsoft Entra przejdź do Entra ID>Aplikacje dla przedsiębiorstw>Wszystkie aplikacje i znajdź aplikację Azure Databricks dla przedsiębiorstw używaną do logowania jednokrotnego. Aby zidentyfikować aplikację, wyszukaj identyfikator aaec40b0-c0ae-4211-a98b-6fc160abb71baplikacji .
  2. Udziel zgody administratora na uprawnienia żądane przez aplikację Azure Databricks dla przedsiębiorstw:
    1. W obszarze Zabezpieczenia kliknij pozycję Uprawnienia.
    2. Kliknij pozycję Udziel zgody administratora.

Aby uzyskać szczegółowe instrukcje, zobacz dokumentację Microsoft.

Nie można użyć zasobów

Jeśli nie możesz użyć zasobów Azure Databricks, takich jak magazyny SQL, w dodatku do Excel, spróbuj użyć jednej z następujących metod w zależności od tego, której wersji Excel używasz.

  • Excel dla sieci web: Uruchom ponownie arkusz lub zmień obszary robocze i zaloguj się ponownie do tego samego obszaru roboczego. Zobacz Zmienianie obszaru roboczego usługi Azure Databricks.
  • Excel Desktop: załaduj ponownie dodatek, klikając ikonę informacji w prawym górnym rogu i wybierając pozycję Załaduj ponownie.

Następne kroki

  • Ostatnia aktualizacja o