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

Rozšíření Azure Databricks Excel propojuje váš pracovní prostor Azure Databricks s Microsoft Excel, čímž přináší řízená data Lakehouse přímo do vašich tabulek.

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

• Před použitím Excel doplňku ověřte, že máte nastaven.
• Máte přístup ke službě Azure Databricks SQL a alespoň oprávnění CAN USE k SQL warehouse.

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. Nakonfigurujte řádek, sloupec a hodnotu přetažením každého pole do správné oblasti.

5. (Volitelné) Přidejte filtr. Další informace o filtrech najdete v tématu Filtrování importovaných dat.

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

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

8. 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í
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é) Přidejte filtr. Další informace o filtrech najdete v tématu Filtrování importovaných dat.
6. (Volitelné) Chcete-li zobrazit ukázku importu, klikněte na Náhled.
7. (Volitelné) Nastavte omezení počtu importovaných řádků.
8. (Volitelné) Pokud chcete identifikovat importovaná data, zadejte 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. Zvolte 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.

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

Filtrování importovaných dat

Při importu dat výběrem tabulky nebo vytvořením kontingenční tabulky můžete výsledky zúžit pomocí filtrů.

Filtry řetězců jsou necitlivé na velikost písmen a kaskádové. Když použijete více než jeden filtr, dostupné hodnoty pro každý filtr závisí na výběrech filtrů před ním. Například pokud filtrujete podle země a pak přidáte filtr podle města, filtr měst nabízí pouze města v rámci vybrané země.

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. U filtrů, které vyžadují hodnotu, můžete provést jednu z následujících věcí:

• Zadejte hodnotu.
• Pro vytvoření seznamu až 5 000 různých hodnot filtrů můžete použít:
  1. Klikněte na Hodnoty a potom Načíst hodnoty filtru.
  2. Klikněte na šipku dolů a vyberte jednu nebo více hodnot ze seznamu.
• Chcete-li použít odkaz na buňku:
  1. Klikněte na Buňky.
  2. Vyberte buňku nebo oblast buněk.
  3. Klikněte na

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

Kalkulovaná pole

Vypočítané pole je sloupec odvozený z existujících dat, například profit vypočtený z revenue a cost. Doplněk Excel nepodporuje vytváření vypočítaných polí pomocí metody Select data import. Pro přidání vypočítaného pole použijte jednu z následujících metod:

• Write SQL: Použijte metodu Write SQL import k výpočtu vypočítáných sloupců s jakýmkoli SQL výrazem. Viz Psaní dotazů SQL.
• Genie One: Požádejte Genie One, aby vám vrátil data s požadovanými vypočítánými sloupci, a pak importujte výsledky. Viz Použít Genie One v Microsoft Excel.

Databricks doporučuje používat Genie One pro vypočítaná pole.

Použití vlastních funkcí Azure Databricks 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. Definujte parametry názvu a hodnoty 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 automaticky neaktualizuje data. Způsob aktualizace dat závisí na tom, jak jste je naimportovali. Data importovaná pomocí metody importu (vyberte tabulku, napište dotaz SQL nebo vytvořte kontingenční tabulku) se aktualizují na kartě Importy . Data importovaná pomocí vlastní funkce se musí přepočítat.

Aktualizujte importy s nejnovějšími hodnotami z Azure Databricks. Doplněk znovu spustí původní výběr dotazu nebo tabulky a aktualizuje list čerstvými daty:

• Aktualizace jednoho importu:
  1. V podokně doplňku Azure Databricks v Excel klikněte na kartu Imports.
  2. Klikněte na Aktualizujte se vedle importu, který chcete aktualizovat.
• Aktualizace všech importů:
  1. V podokně doplňku Azure Databricks klikněte na Refresh All.

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.

Data importovaná z vlastních funkcí, například DATABRICKS.Table a DATABRICKS.SQL, se při opětovném otevření sešitu neaktualizuje. Pokud chcete aktualizovat data importovaná z vlastních funkcí, přihlaste se do doplňku Azure Databricks a potom buď přepočítejte sešit, nebo změňte hodnotu, na niž vlastní funkce odkazuje.

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 udělejte jednu z těchto věcí:

• Sdílejte místní soubor s jiným uživatelem. Příjemce může soubor přejmenovat a zobrazit uložené dotazy.
• Na SharePoint nasdí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.