Import a dotazování dat pomocí doplňku 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.

Tato stránka popisuje, jak pomocí doplňku Azure Databricks Excel importovat a analyzovat data z Azure Databricks v Excel. Tabulky Azure Databricks můžete procházet a importovat prostřednictvím intuitivního rozhraní, ve kterém nejsou potřeba žádné znalosti SQL. I když doplněk nabízí flexibilitu při spouštění vlastních dotazů SQL, je volitelné.

Požadavky

Vyberte SQL sklad

Vyberte, který SQL Warehouse se má použít:

  1. V pravém horním rohu podokna doplňku Azure Databricks v Excelu klikněte na rozevírací nabídku.
  2. Vyberte, který SQL Warehouse chcete použít.

Import dat z Azure Databricks

Importujte data z Azure Databricks v Excel výběrem tabulky, zápisem dotazu SQL nebo importem kontingenční tabulky.

Poznámka:

Zobrazení metrik katalogu Unity můžete importovat pomocí kontingenčních tabulek, dotazů SQL a vlastních funkcí.

Vytvoření kontingenčních tabulek

Chcete-li vytvořit kontingenční tabulku z tabulek a zobrazení v katalogu Unity v Excelu:

  1. V podokně doplňku Azure Databricks Excel, na kartě Nový import, vyberte Výběr dat jako metodu importu.

  2. V části Katalog vyberte tabulku, ze které chcete vytvořit kontingenční tabulku, a klikněte na Vybrat.

  3. Zaškrtněte políčko Kontingenční data .

  4. Podle potřeby nakonfigurujte řádek, sloupec, hodnotu a filtry .

  5. (Volitelné) Chcete-li zobrazit ukázku importu, klikněte na Náhled.

  6. (Volitelné) Nastavte limit řádku pro import.

  7. Importujte výsledky. Vyberte jednu z následujících možností:

    • Kliknutím na Save a import uložte dotaz pro opakované použití v sešitu Excel a naimportujte výsledky.
    • Klikněte na šipku dolů a potom kliknutím na Importovat výsledky importujte výsledky bez uložení dotazu. Tuto možnost použijte, pokud chcete pokračovat v úpravách importu.

    Poznámka:

    Kontingenční tabulky je možné importovat pouze do nového listu.

Při práci s metrikami katalogu Unity v kontingenčních tabulkách se může zobrazit Sum(measure) ve výsledcích. Toto chování je očekávané a nedojde k žádné další agregaci. Excel vyžaduje, aby hodnoty měly agregační funkci, ale protože data obsahují jedinečné hodnoty, nedojde k žádné agregaci.

Výběr tabulek

Data se naimportují jako objekt Excel table. Tabulku můžete přesunout nebo přejmenovat a doplněk Excel aktualizuje data v novém umístění.

Pokud chcete importovat data z tabulky Azure Databricks, postupujte takto:

  1. V podokně doplňku Azure Databricks Excel, na kartě Nový import, vyberte Výběr dat jako metodu importu.

  2. Zvolte tabulku, která se má importovat z Průzkumníka katalogu. Katalog můžete filtrovat podle vlastníka, certifikačního stavu a dalších vlastností pomocí ikony posuvníky.

  3. Klepněte na tlačítko Vybrat.

  4. V části Sloupce klikněte na šipku dolů a zrušte výběr sloupců, které nechcete importovat, nebo ponechte všechny sloupce vybrané k importu celé tabulky.

  5. (Volitelné) Pokud chcete nastavit filtry, klikněte na + tlačítko Vedle filtrů, vyberte sloupec, u kterého chcete filtr použít, a zadejte podmínku filtru. Seznam dostupných filtrů najdete v tématu Podporované filtry.

    U filtrů, které vyžadují hodnotu, můžete provést jednu z následujících věcí:

    • Zadejte hodnotu.
    • Pokud chcete vygenerovat seznam až 1 000 jedinečných hodnot filtru, které můžete použít, klikněte na Hodnoty a potom na Získat hodnoty filtru. Klikněte na šipku dolů a vyberte jednu nebo více hodnot ze seznamu.
    • Pokud chcete použít odkaz na buňku, klikněte na Buňky, vyberte buňku nebo oblast buněk a potom klikněte na tlačítko kurzoru.

  6. (Volitelné) Chcete-li zobrazit ukázku importu, klikněte na Náhled.

  7. (Volitelné) Omezení počtu importovaných řádků můžete nastavit tak, aby se omezil počet importovaných řádků.

  8. (Volitelné) Pokud chcete snadno identifikovat importovaná data, můžete zadat název importu.

  9. V části Cíl výstupu zvolte import dat do nového listu nebo aktuálního listu. Pokud importujete do aktuálního listu, data začínají odkazem na buňku, kterou zadáte (ve výchozím nastavení A1).

  10. Importujte výsledky. Vyberte jednu z následujících možností:

    • Kliknutím na Save a import uložte dotaz pro opakované použití v sešitu Excel a naimportujte výsledky.
    • Klikněte na šipku dolů a potom kliknutím na Importovat výsledky importujte výsledky bez uložení dotazu. Tuto možnost použijte, pokud chcete pokračovat v úpravách importu.

Podporované filtry

Při importu dat výběrem tabulky můžete výsledky zúžit pomocí filtrů. Následující tabulka popisuje každý dostupný filtr a očekávaný vstup.

Filtr Očekávaný vstup Description
IS NULL None Vyhledá řádky, ve kterých je hodnota sloupce null.
IS NOT NULL None Vyhledá řádky, ve kterých hodnota sloupce nemá hodnotu null.
EQUALS Jeden číselný nebo textový řetězec Vyhledá řádky, ve kterých hodnota sloupce přesně odpovídá zadané hodnotě.
NOT EQUALS Jeden číselný nebo textový řetězec Vyhledá řádky, ve kterých hodnota sloupce neodpovídá zadané hodnotě.
IN Jedno nebo více čísel nebo textových řetězců oddělených čárkami Vyhledá řádky, ve kterých hodnota sloupce odpovídá libovolné zadané hodnotě.
NOT IN Jedno nebo více čísel nebo textových řetězců oddělených čárkami Vyhledá řádky, ve kterých hodnota sloupce neodpovídá žádné zadané hodnotě.
LIKE Jeden vzor používající % (libovolné znaky) a _ (jeden znak) jako zástupné znaky.
%smith odpovídá libovolné hodnotě končící na "smith".
t_p odpovídá hodnotám, jako je "tap", "tip" nebo "top".		 Vyhledá řádky, ve kterých hodnota sloupce odpovídá vzoru. Rozlišují se malá a velká písmena.
NOT LIKE Jeden vzor používající % (libovolné znaky) a _ (jeden znak) jako zástupné znaky.
%test% vyloučí hodnoty obsahující "test".
_at vyloučí hodnoty jako "bat", "cat" nebo "hat".		 Vyhledá řádky, ve kterých hodnota sloupce neodpovídá vzoru. Rozlišují se malá a velká písmena.
ILIKE Jeden vzor používající % (libovolné znaky) a _ (jeden znak) jako zástupné znaky.
%Smith odpovídá hodnotám jako "smith", "Smith" nebo "SMITH".
_ob odpovídá "Bob", "rob" nebo "Rob".		 Vyhledá řádky, ve kterých hodnota sloupce odpovídá vzoru. Nerozlišující velikost písmen.
STARTS WITH Jeden textový řetězec Vyhledá řádky, ve kterých hodnota sloupce začíná zadaným textem.
ENDS WITH Jeden textový řetězec Vyhledá řádky, kde hodnota sloupce končí zadaným textem.
CONTAINS Jeden textový řetězec Vyhledá řádky, ve kterých hodnota sloupce obsahuje zadaný text kdekoli v řetězci.

Psaní dotazů SQL

Metoda Write SQL importu podporuje funkce SQL a uložené procedury.

Pokud chcete spouštět vlastní dotazy SQL v pracovním prostoru Azure Databricks, postupujte takto:

  1. V podokně doplňku Azure Databricks Excel, v části s kartou Nový import, vyberte možnost Write SQL jako metodu importu.

  2. Zadejte název dotazu, abyste ho později identifikovali.

  3. Napište nový dotaz nebo použijte existující dotaz z pracovního prostoru Azure Databricks.

    • Napište svůj dotaz SQL v editoru. Můžete se dotazovat na libovolnou tabulku v katalogu Unity, ke které máte oprávnění pro přístup.

      • Klikněte na ikonu Data. Průzkumník katalogu pro zobrazení schémat a tabulek

    • Pokud chcete použít dotaz z pracovního prostoru Azure Databricks nebo existujícího dotazu v Excelu, klikněte na Ikona. složku. Pokud použijete existující dotaz z pracovního prostoru Azure Databricks, neprojeví se úpravy provedené v Excel na Azure Databricks.

      Poznámka:

      Dotazy musí být explicitně uložené v Azure Databricks pomocí tlačítka Save v pravém horním rohu editoru dotazů, než se zobrazí v Excel.

  4. (Volitelné) Pokud chcete přidat parametry dotazu, klikněte na +Přidat vedle parametrů. Klikněte na parametr a zadejte název parametru a hodnotu parametru.

    • Pro hodnotu parametru můžete zadat konkrétní hodnotu nebo kliknutím na tlačítko se šipkou určit odkaz na buňku. Vyberte buňku nebo oblast buněk a kliknutím na šipku automaticky vyplňte hodnotu parametru.

  5. V části Cíl výstupu zvolte import dat do nového listu nebo aktuálního listu. Pokud importujete do aktuálního listu, data začínají odkazem na buňku, kterou zadáte (ve výchozím nastavení A1).

  6. Pokud chcete zobrazit náhled výsledků dotazu, klikněte na Spustit.

  7. Importujte výsledky. Vyberte jednu z následujících možností:

    • Kliknutím na Save a import uložte dotaz pro opakované použití v sešitu Excel a naimportujte výsledky.
    • Klikněte na šipku dolů a potom kliknutím na Importovat výsledky importujte výsledky bez uložení dotazu. Tuto možnost použijte, pokud chcete pokračovat v úpravách importu.

K přidání parametrů dotazu můžete použít také vlastní funkce. Viz také Zápis SQL.

Použití vlastních funkcí v Excel

Doplněk Excel poskytuje vlastní funkce, které můžete použít ve vzorcích Excel k importu dat z Azure Databricks.

Výběr tabulky

Funkce DATABRICKS.Table importuje data z tabulky Katalogu Unity.

Syntaxe:

=DATABRICKS.Table(catalog_name.schema_name.table_name, [column1, ...], [limit])

Parametry:

  • catalog_name.schema_name.table_name (povinné): Plně kvalifikovaný název tabulky.
  • columns (volitelné): Pole názvů sloupců, které se mají importovat. Vynecháte tento parametr pro import všech sloupců.
  • limit (volitelné): Maximální počet řádků, které se mají importovat. Vynecháte tento parametr pro import všech řádků až do limitu 10 MB.

Příklad:

=DATABRICKS.Table("main.default.customers", {"customer_id", "customer_name"}, 100)

Tento vzorec naimportuje customer_id sloupce a customer_name sloupce z main.default.customers tabulky, které jsou omezené na 100 řádků.

Napište SQL

Funkce DATABRICKS.SQL spustí dotaz SQL, který používá parametry dotazu a vrátí výsledky.

Syntaxe:

Zadejte parametry pomocí hodnot.

=DATABRICKS.SQL("query_text", {parameter1_name, parameter1_value; ...})

Zadejte parametry pomocí oblasti buněk. Parametry názvu a hodnoty musí být definovány v buňkách, které jsou ve stejném řádku.

=DATABRICKS.SQL("query_text", {param_name_cell: param_value_cell; ...})

Parametry:

  • query_text (povinné): Dotaz SQL, který se má spustit.
  • parameters (povinné): Mapování hodnot parametrů, které se mají nahradit do dotazu.

Příklad:

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE longitude > :long_param AND latitude > :lat_param LIMIT 10", {"long_param",20; "lat_param",10})

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE city = :city", M4:N4)

Tento vzorec spustí dotaz, který filtruje prodejní data pomocí longitudelatitudezadaných hodnot parametrů.

Správa dotazů

Umožňuje spravovat existující importy ze stránky Importy.

Úprava existujícího importu

Úprava existujícího importu:

  1. V podokně doplňku Azure Databricks v Excel klikněte na kartu Imports.
  2. Najděte import, který chcete upravit.
  3. Klikněte na ikonu se třemi tečkami vedle importu.
  4. Chcete-li upravit import, klikněte na Upravit .

Aktualizace dat

Doplněk Excel neaktualizuje automaticky importovaná data. Aktualizace dat pomocí nejnovějších hodnot z Azure Databricks:

  • Pokud chcete aktualizovat jeden import, postupujte takto:
    1. V podokně doplňku Azure Databricks v Excel klikněte na kartu Imports.
    2. Klikněte na tlačítko Aktualizovat. Aktualizujte se vedle importu, který chcete aktualizovat.
  • Chcete-li aktualizovat všechny importy, postupujte takto:
    1. V podokně doplňku Azure Databricks klikněte na Refresh All.

Doplněk znovu spustí původní výběr dotazu nebo tabulky a aktualizuje list čerstvými daty.

Důležité

Při aktualizaci dat doplněk Excel vymaže všechna existující data v zadané tabulce a znovu načte nejnovější data z Azure Databricks. Během procesu aktualizace se odstraní všechny vlastní sloupce přidané do tabulky.

Důsledky sdílení

Když sdílíte Excel sešit, který obsahuje data Azure Databricks, zvažte následující důsledky přístupu k datům a zabezpečení:

Viditelnost importovaných dat

Když příjemce aktualizuje import, doplněk použije příjemcova oprávnění pro Unity Catalog. Pokud nemají přístup k podkladovým datům, aktualizace se nezdaří.

V sešitech, kde je problém s ochranou soukromí dat, můžete použít následující alternativní řešení:

  1. Vytvořte pracovní sešit se všemi potřebnými vzorci a datovými importy.
  2. Odstraňte importovaná data z listu.
  3. Sdílejte sešit s příjemcem.
  4. Požádejte příjemce, aby data aktualizoval.

Příjemce uvidí jenom data, ke kterým má přístup na základě svých oprávnění katalogu Unity.

Přístup k pracovním prostorům a datovým prostředkům

  • Uživatelé bez přístupu k objektům katalogu Unity odkazovaným v sešitu nemůžou aktualizovat data. Aby uživatelé mohli aktualizovat data, musí mít oprávnění ke čtení v podkladových tabulkách a zobrazeních v katalogu Unity.
  • Uživatelé musí mít přístup k podkladové tabulce v Azure Databricks, aby mohli upravovat existující importy.

Viditelnost dotazů

Uživatelé, kteří mají přístup k úpravám sešitu, můžou zobrazit dotazy použité k vygenerování dat prostřednictvím doplňku Azure Databricks, i když nemají přístup k podkladovým datům v katalogu Unity.

Alternativa k uložení ve formě šablony

Doplněk Azure Databricks Excel nepodporuje ukládání sešitu jako šablony, ale sešit můžete sdílet, aby ostatní uživatelé viděli importované dotazy. Podívejte se na aspekty sdílení přístupu k datům a zabezpečení.

Jako alternativní řešení pro sdílení sešitu jako šablony:

  • Sdílení místního souboru: Sdílejte místní soubor s jiným uživatelem. Příjemce může soubor přejmenovat a zobrazit uložené dotazy.
  • Sdílet prostřednictvím SharePoint: Na SharePoint sdílejte sešit s jiným uživatelem. Když soubor stáhne jiný uživatel, uložené importy se zachovají.

Omezení

  • Vlastní funkce: U vlastních funkcí jsou výsledky dotazů omezené na 25 MiB kvůli omezením rozhraní SQL Execution API.
  • Načítání dat: Načtení dat může selhat, pokud je některá buňka v sešitu v režimu úprav.
  • Excel limit řádků plochy: Excel Desktop podporuje maximálně 1 048 576 řádků na list.
  • Limit velikosti souboru pro Excel pro web: Excel pro web podporuje maximální velikost souboru sešitového přibližně 25 MB pro prohlížení a úpravy.
  • Last updated on