Nastavte doplněk Azure Databricks Excel

Důležité

Tato funkce je ve verzi Public Preview.

Poznámka:

Doplněk Azure Databricks Excel není k dispozici v oblastech Azure Government ani v Azure v Číně.

Doplněk Azure Databricks Excel připojí váš pracovní prostor Azure Databricks k Microsoftu Excel, čímž přímo do tabulek přidá data z modelu Lakehouse, aby vám pomohl rychleji přejít od dat k rozhodnutím. Doplněk je plně podporovaný v Excel pro web a desktopových verzích pro Windows i macOS.

Tato stránka popisuje dvě metody, které jsou k dispozici k nastavení Azure Databricks Excel doplňku Microsoft Excel. Tento doplněk používá ověřování jednotného přihlašování (SSO) pro připojení k pracovnímu prostoru Azure Databricks a podporuje Unity Catalog pro zásady správného řízení dat a řízení přístupu.

Požadavky

Před instalací doplňku Excel ověřte, že máte následující:

  • Přístup do pracovního prostoru Azure Databricks s povoleným Unity Catalogem.
  • Správce pracovního prostoru musí povolit Excel Connector Preview. Viz Manage Azure Databricks preview.
  • Adresa URL pracovního prostoru Azure Databricks workspace pro každý pracovní prostor, ke kterému se má Excel připojit. Nepodporují se vlastní adresy URL účtů.
  • Máte přístup ke službě Azure Databricks SQL a alespoň oprávnění CAN USE k datovému skladu SQL.
  • Oprávnění ke čtení dat z tabulek katalogu Unity ve vašem pracovním prostoru
  • Jedna z následujících verzí Excel:
    • Excel 2019 nebo novější na Macu
    • Excel na Windows (Microsoft 365)
    • Excel na webu
    • Excel na Macu (Microsoft 365)
  • Pokud používáte bránu firewall nebo platformu cloudového zabezpečení, přidejte do souboru doplňku seznam povolených adres URL Azure Databricks pracovního prostoru.
  • Pokud váš Microsoft Entra tenant blokuje souhlas uživatele pro aplikace třetích stran, musí správce Microsoft Entra udělit souhlas správce Azure Databricks podnikové aplikaci s jednotným přihlašováním, aby se uživatelé mohli přihlásit. Přečtěte si zprávu "Potřebujete schválení správcem" při přihlášení.

Nastavení souboru doplňku

Poznámka:

Pokud jste správcem, který doplněk nasazuje prostřednictvím Microsoft Marketplace, přeskočte tuto část. Nasazení na marketplace využívá PowerShell ke konfiguraci přístupu k pracovnímu prostoru místo souboru doplňku. Podívejte se na Nasazení prostřednictvím Microsoft Marketplace.

Soubor doplňku je malý soubor konektoru, který aplikaci Excel říká, jak se bezpečně připojit k Azure Databricks. Funguje jako digitální handshake, který zajišťuje správné načtení doplňku a zůstane aktuální při každém otevření Excel.

Stáhněte a nastavte soubor doplňku, abyste mohli používat doplněk pro Azure Databricks Excel.

Databricks doporučuje použít manifest s více pracovními prostory, abyste mohli mít konsolidovaný manifest. Pokud ale nemůžete použít login.databricks.com , protože nemáte nastavené jednotné přihlašování na úrovni účtu, musíte použít metodu manifestu s jedním pracovním prostorem.

  1. Stáhněte si soubor Azure Databricks Excel add-in:

    Stažení souboru Excel add-in

  2. Upravte soubor doplňku zadáním adresy URL pracovního prostoru jako <AppDomain> v oddílu AppDomains. Adresa URL pracovního prostoru je základní adresa URL, kterou používáte pro přístup k pracovnímu prostoru Azure Databricks v prohlížeči. Pokud chcete přepínat mezi více Azure Databricks pracovními prostory, přidejte do souboru doplňku každou adresu URL pracovního prostoru.

    <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>

    Poznámka:

    Vložte adresu URL pracovního prostoru jako prostý text bez formátování. Ve většině textových editorů používejte Ctrl+Shift+V (Windows) nebo Command+Shift+V (macOS).

  3. Uložte provedené změny. Ověřte, že je soubor správně naformátovaný jako .xml soubor.

Manifest s jedním pracovním prostorem

Tento postup platí, pokud nemáte nastavené jednotné přihlašování na úrovni účtu.

Poznámka:

Každý soubor doplňku se připojí k jednomu pracovnímu prostoru Azure Databricks. Pokud se chcete připojit k více pracovním prostorům, opakujte tento postup pro každý pracovní prostor a nahrajte samostatný soubor doplňku svázaný s každým pracovním prostorem.

  1. Otevřete soubor doplňku pro jeden pracovní prostor kliknutím na následující odkaz:

    Soubor doplňku pro jeden pracovní prostor

  2. Uložte stránku jako .xml soubor do místního počítače. Ve většině prohlížečů klikněte pravým tlačítkem myši na stránku a vyberte Save jako nebo stiskněte Ctrl+S (Windows) nebo Command+S (macOS).

  3. Upravte soubor doplňku nahrazením následujících zástupných symbolů:

    • YOUR-SERVER-HOSTNAME — Hostitelský název serveru pracovního prostoru.
    • YOUR-WORKSPACE-ID — Číselné ID vašeho pracovního prostoru.

    Adresa URL vašeho pracovního prostoru se konfiguruje prostřednictvím těchto zástupných symbolů, nikoli jako samostatná <AppDomain> položka.

  4. Uložte provedené změny. Ověřte, že je soubor správně naformátovaný jako .xml soubor.

Možnost 1: Spravováno správcem

Jako globální správce můžete doplněk Azure Databricks Excel nasadit uživatelům ve vaší organizaci. Doplněk můžete nasadit jako vlastní aplikaci pomocí souboru doplňku nebo ho nainstalovat z Microsoft Marketplace.

Pokud chcete doplněk Azure Databricks Excel nainstalovat jako Správa Microsoftu 365, musíte mít oprávnění global admin. Jako správce můžete určit, kteří uživatelé ve vaší organizaci můžou používat doplňky. Další informace o globálních správcích na Microsoft 365 najdete v dokumentaci k Microsoft.

Poznámka:

Databricks doporučuje nasadit doplněk Azure Databricks Excel jako vlastní aplikaci.

Nasazení jako vlastní aplikace

Nasaďte doplněk pomocí vlastního souboru manifestu. Stáhněte a nastavte soubor doplňku uvedený v části Požadavky.

  1. V Centrum pro správu Microsoftu 365 přejděte na Nastavení > Integrované aplikace a klikněte na odkaz Přidání.
  2. Klepněte na tlačítko Nasadit doplněk a klepněte na tlačítko Další.
  3. Klikněte na Nahrát vlastní aplikace jako možnost pro nasazení nového doplňku.
  4. Vyberte možnost pro nahrání manifestu. Klikněte na Zvolit soubor a nahrajte soubor doplňku.
  5. Vyberte, kteří uživatelé mají mít přístup k doplňku.
  6. Klikněte na Deploy.

Podrobné pokyny k nahrání doplňku Azure Databricks Excel najdete v dokumentaci k Microsoft.

Nasazení z webu Microsoft Marketplace

Nainstalujte doplněk z Microsoft Marketplace a pomocí PowerShellu nakonfigurujte přístup k pracovnímu prostoru.

Předpoklady

  • Na vašem počítači je nainstalovaný PowerShell.
  • Musíte spustit Windows PowerShellu jako správce.

Nainstalujte doplněk

  1. V Centrum pro správu Microsoftu 365 přejděte na Nastavení > integrované aplikace a klikněte na odkaz Get Apps.
  2. Vyhledejte doplněk Azure Databricks pro Excel.
  3. Klikněte na Získat.
  4. Doplněk nasaďte sami výběrem možnosti Jen já v části Přiřadit uživatele.
  5. Klikněte na Deploy.

Podrobný postup nasazení doplňku Azure Databricks Excel z Microsoft Marketplace najdete v dokumentaci Microsoft.

Konfigurace přístupu k pracovnímu prostoru

Po instalaci doplňku použijte PowerShell pro přidání adres URL pracovního prostoru Azure Databricks na seznam povolených.

Poznámka:

Vypršení časového limitu připojení PowerShellu k Centru pro správu Office 365 může nastat. Pokud příkaz selže, otevřete PowerShell znovu a připojte se znovu spuštěním příkazu Connect-OrganizationAddInService.

  1. Otevřete PowerShell a spusťte ho jako správce. Další informace najdete v dokumentaci k Microsoft.

  2. Nainstalujte a naimportujte modul Office 365 centralizovaného nasazení:

    Install-Module -Name O365CentralizedAddInDeployment
Import-Module O365CentralizedAddInDeployment

  3. Připojte se ke svému tenantovi Office 365 a přihlaste se jako správce:

    Connect-OrganizationAddInService

  4. Potvrďte, že byl doplněk nasazen. Doplněk Azure Databricks pro Excel by se měl zobrazit v seznamu.

    Get-OrganizationAddIn

    Pokud se doplněk nezobrazí, může být nutné ho znovu nasadit, nebo může být stále ve fázi nasazování.

  5. Seznam povolených Azure Databricks adres URL pracovního prostoru Nahraďte každý <workspace-url> URL adresou pracovního prostoru, který chcete povolit. Můžete zahrnout tolik adres URL pracovního prostoru, kolik potřebujete.

    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"

    ID produktu pro Azure Databricks je d75dbea5-bf93-49b8-9a49-bdf4e9d6f052.

  6. Potvrďte správné zařazení na seznam povolených. Adresy URL pracovního prostoru, které jste povolili, by se měly zobrazit v AppDomains části.

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

Otestujte doplněk

  1. V Excel vyhledejte doplněk Azure Databricks.
  2. Přihlaste se a připojte se k jednomu z pracovních prostorů, které jste povolili.

Poznámka:

Synchronizace změn v seznamu povolených může trvat několik minut. Pokud se ověření nezdaří, ověřte, že se připojujete k pracovnímu prostoru se seznamem povolených. Pokud je pracovní prostor správný, zavřete Excel, počkejte několik minut a zkuste to znovu.

Nasadit do vaší organizace

  1. V Centrum pro správu Microsoftu 365 přejděte na Settings > Integrated apps.
  2. Vyberte doplněk Azure Databricks, který jste nainstalovali a nakonfigurovali.
  3. Klikněte na kartu Uživatelé a zvolte, jestli se má nasadit do celé organizace nebo konkrétní skupiny uživatelů.

Poznámka:

Jako správce sdílejte název účtu přidružený k pracovním prostorům, které jste povolili, s uživateli, kteří plánují používat doplněk Azure Databricks Excel. Viz Přihlášení k doplňku.

Možnost 2: Samoobslužná služba

Postup instalace se liší v závislosti na Excel platformě. Stáhněte a nastavte soubor doplňku uvedený v části Požadavky.

Excel pro web

Pokud chcete nainstalovat a připojit se k doplňku Excel pro web, postupujte následovně:

  1. Otevřete Excel pro web a vytvořte nebo otevřete sešit.
  2. V kartě Domů klikněte na Doplňky>Upřesnit.
  3. Klikněte na Nahrát můj doplněk.
  4. Nahrajte soubor doplňku.
  5. Klikněte na tlačítko Odeslat.
  6. V nabídce Add-ins vyhledejte a klikněte na Azure Databricks Add-in.
  7. Přihlaste se ke svému účtu Azure Databricks. Pokud dojde k chybě, nezapomeňte povolit automaticky otevírané dialogy.
  8. Pokud jste nakonfigurovali více adres URL pracovního prostoru, vyberte požadovaný název účtu Azure Databricks. Pokud jsou adresy URL ve stejném účtu, stačí vybrat konkrétní pracovní prostor. Další informace o názvech účtů najdete v tématu Vyhledání ID účtu.

Desktopová aplikace Excel (Windows)

Pokud chcete nainstalovat doplněk Excel pro stolní počítače pro Windows, postupujte takto:

  1. Vytvořte složku s názvem Manifest na místním disku (například C:\Manifest).
  2. Zkopírujte soubor doplňku do složky C:\Manifest.
  3. Otevřete vlastnosti složky a nasdílejte složku:
    1. Klikněte pravým tlačítkem na Manifest složku a vyberte Vlastnosti.
    2. Klikněte na Sdílet>a přidejte se jako uživatel s oprávněními ke čtení a zápisu.
  4. Otevřete Excel Desktop.
  5. Nakonfigurujte Excel tak, aby důvěřovala složce manifestu:
    1. Klikněte na Soubor>Možnosti>Centrum zabezpečení>Nastavení Centra zabezpečení.
    2. Na bočním panelu klikněte na Důvěryhodné katalogy doplňků.
    3. V adrese URL katalogu zadejte cestu ke sdílené složce, kde se nachází soubor doplňku (například \\YourComputerName\Manifest).
    4. Klikněte na Přidat katalog.
    5. Zaškrtněte políčko Zobrazit v nabídce .
    6. Kliknutím na TLAČÍTKO OK uložte provedené změny.
  6. Restartujte Excel Desktop.
  7. Do vyhledávacího pole v záhlaví vyhledejte "Vložit jako doplněk" a vyberte ho z výsledků.
  8. Vyberte konektor Azure Databricks a klikněte na Přidat.
  9. Klikněte na Azure Databricks doplněk a dokončete proces přihlášení ke svému Azure Databricks účtu.
  10. Pokud jste nakonfigurovali více adres URL pracovního prostoru, vyberte požadovaný název účtu Azure Databricks. Pokud jsou adresy URL ve stejném účtu, stačí vybrat konkrétní pracovní prostor. Další informace o názvech účtů najdete v tématu Vyhledání ID účtu.

Desktopová aplikace Excel (macOS)

Pokud chcete nainstalovat doplněk Excel Excel Desktop pro macOS, postupujte takto:

  1. Najděte složku Microsoft Doplňky pro Office. Ve výchozím nastavení je adresář:

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

  2. Zkopírujte soubor doplňku do této složky.

  3. Otevřete nebo restartujte Excel Desktop.

  4. Na navigačním panelu klikněte na Doplňky>.

  5. Klikněte na doplněk Azure Databricks.

  6. Dokončete proces přihlášení ke svému Azure Databricks účtu.

  7. Pokud jste nakonfigurovali více adres URL pracovního prostoru, vyberte požadovaný název účtu Azure Databricks. Pokud jsou adresy URL ve stejném účtu, stačí vybrat konkrétní pracovní prostor. Další informace o názvech účtů najdete v tématu Vyhledání ID účtu.

Přihlášení k doplňku

Pokud správce ve vaší organizaci nasadil doplněk Azure Databricks Excel, přihlaste se a připojte se k pracovnímu prostoru Azure Databricks z Excel.

  1. V Excel klikněte na kartě Domů na doplněk Azure Databricks.
  2. Zadejte adresu URL pracovního prostoru nebo v rozevíracím seznamu vyberte dříve použitou adresu URL pracovního prostoru. Doplněk si pamatuje adresy URL pracovního prostoru, které jste nakonfigurovali vy nebo váš správce.
  3. Klikněte na Sign in a dokončete proces ověřování, abyste získali přístup ke všem funkcím doplňku Azure Databricks Excel.

Změna pracovního prostoru Azure Databricks

Pokud váš soubor doplňku určuje více Azure Databricks pracovních prostorů, můžete mezi těmito pracovními prostory přepínat. Další informace naleznete v tématu Nastavení souboru doplňku.

Pokud se chcete připojit k jinému pracovnímu prostoru Azure Databricks, postupujte takto:

  1. V pravém horním rohu podokna doplňku Azure Databricks klikněte na ikonu nabídky (tři tečky) vedle výběru výpočetních prostředků.
  2. Klikněte na Změnit pracovní prostor.
  3. Vyberte účet, ve kterém je váš pracovní prostor, zvolte pracovní prostor, pokud se zobrazí výzva, a přihlaste se.

Řešení potíží

Zpráva Probíhá ověřování při přihlášení

Pokud se při pokusu o přihlášení k Azure Databricks z doplňku zobrazí okno Probíhá ověřování, je možné, že váš pracovní prostor nebyl správně přidán do vlastního souboru doplňku. Ověřte, že jste pracovní prostor správně nakonfigurovali v části <AppDomains>.

Zpráva "Potřebuji schválení správcem" při přihlášení

Při přihlášení k pracovnímu prostoru Azure Databricks z Excel add-in se zobrazí následující zpráva "Potřebujete schválení správcem", protože tenant Microsoft Entra blokuje souhlas uživatele pro aplikaci Azure Databricks. Pokud se souhlas správce neudělí, Microsoft Entra ID bude i nadále blokovat tok přihlášení, i když máte přímý přístup k pracovnímu prostoru.

Zpráva vyžadující schválení administrátorem v Excel doplňku

Aby bylo možné tento problém vyřešit, musí uživatel Microsoft Entra s příslušnými rolemi správce udělit podnikové aplikaci Azure Databricks souhlas správce pro celého tenanta.

Požádejte správce Microsoft Entra, aby navštívil následující odkaz. Nahraďte {TENANT_ID} ID vašeho tenanta Microsoft Entra:

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

Pokud odkaz selže, správce může udělit souhlas ručně:

  1. V Centrum pro správu Microsoft Entra přejděte na Entra ID>Enterprise apps>Všechny aplikace a najděte Azure Databricks podnikovou aplikaci použitou pro jednotné přihlašování. Chcete-li identifikovat aplikaci, vyhledejte ID aaec40b0-c0ae-4211-a98b-6fc160abb71baplikace .
  2. Udělení souhlasu správce pro oprávnění požadovaná aplikací Azure Databricks Enterprise:
    1. V části Zabezpečení klikněte na Oprávnění.
    2. Klikněte na Udělit souhlas správce.

Podrobné pokyny najdete v dokumentaci k Microsoft.

Nejde použít prostředky

Pokud v doplňku Azure Databricks nemůžete použít Azure Databricks prostředky, například SQL Warehouse, vyzkoušejte jednu z následujících metod v závislosti na tom, jakou verzi Excel používáte:

  • Excel pro web: Restartujte list nebo změňte pracovní prostory a znovu se přihlaste ke stejnému pracovnímu prostoru. Viz Změna pracovního prostoru Azure Databricks.
  • Excel Desktop: Doplněk znovu načtěte kliknutím na ikonu informací v pravém horním rohu a výběrem možnosti Reload.

Další kroky

  • Last updated on