Power BI Gateway a aktualizace dat

Power BI Service i Fabric běží v cloudu. Data, která má report zobrazit, ale často sedí za firemním firewallem — SQL Server na interní síti, sdílené soubory, on-premises SAP. Cloudová služba se do takové sítě sama nedostane. On-premises data gateway je agent instalovaný uvnitř firemní sítě, který zprostředkuje spojení mezi cloudem a zdrojem dat.

Klíčový mechanismus: gateway iniciuje odchozí spojení směrem ke cloudu přes Azure Relay — u nových instalací ve výchozím HTTPS módu na portu 443, v TCP módu navíc porty 5671–5672 a 9350–9354 (port 80 jen pro stažení instalátoru). Do sítě se zvenčí nic neotevírá — žádný příchozí port není potřeba. Gateway se pravidelně hlásí ke cloudové službě a čeká na práci (refresh, dotaz DirectQuery). Teprve na tento pokyn se sama připojí k lokálnímu zdroji dat a výsledek pošle zpět.

Gateway existuje ve dvou režimech, které se volí už při instalaci a později nelze v jednom exemplu přepínat bez přeinstalace.

Postup instalace

1. Stáhněte instalátor z powerbi.microsoft.com/gateway nebo z Power BI Service (Download → Data Gateway).
2. Při instalaci zvolte režim — On-premises data gateway (standard mode) nebo On-premises data gateway (personal mode).
3. Přihlaste se organizačním účtem, který má práva registrovat gateway v tenantu.
4. Zadejte název gateway — v clusteru musí být mezi sebou jednoznačně odlišitelné (např. podle role nebo lokality serveru).
5. Zadejte a bezpečně uložte recovery key (viz další sekce) — bez něj gateway nelze později migrovat ani obnovit.
6. Po dokončení instalace se gateway zobrazí v Manage connections and gateways se stavem online/offline.

Gateway by měla běžet na stroji, který je zapnutý nepřetržitě, má stabilní síťové připojení ke zdroji dat i k internetu a dostatek výkonu na komprimaci a přenos dat při refreshi. V praxi to bývá dedikovaný server nebo VM v blízkosti zdrojových systémů, ne pracovní stanice administrátora.

Recovery key zadáváte při instalaci a je nutný pro registraci gateway, pro pozdější migraci na jiný stroj, pro obnovu po havárii i pro takeover (převzetí správy gateway jiným administrátorem). Microsoft k němu nemá přístup a bez zálohy recovery key gateway nelze obnovit — jen znovu nainstalovat od nuly a znovu nastavit všechny datové zdroje.

Credentials k jednotlivým datovým zdrojům (uživatelské jméno, heslo, connection string) jsou šifrované a uložené v cloudu, ne přímo na disku gateway. Recovery key slouží k odvození šifrovacích klíčů, kterými se credentials znovu zašifrují při každé změně. Dešifrování proběhne až na gateway v okamžiku, kdy je potřeba operaci skutečně provést — refresh, nebo dotaz DirectQuery.

Samotná instalace gateway ještě neznamená, že ji může někdo použít. Je potřeba na ní definovat datový zdroj (connection) — pojmenované spojení na konkrétní server a databázi s konkrétními credentials.

1. Power BI Service → ozubené kolo Settings → Manage connections and gateways.
2. Záložka On-premises data gateways (vedle ní i Virtual network data gateways) ukazuje nainstalované gateway a jejich stav (online / offline), verzi a členy clusteru.
3. Záložka Connections → New → vyberete gateway, typ zdroje (SQL Server, soubor, ODBC…), zadáte server/cestu a metodu ověření.
4. U konkrétního datového zdroje přes Manage users přidáte uživatele nebo skupiny, kteří smí tento zdroj použít — role User (může zdroj používat), User with resharing (navíc smí zdroj sdílet dál) a Owner (spravuje connection, credentials i přístup). Nejde o to, kdo vidí report, ale kdo smí datový zdroj přiřadit svému modelu.

Jeden gateway může mít desítky datových zdrojů a jeden datový zdroj lze sdílet mezi více sémantickými modely — typicky když víc modelů čte ze stejné databáze. V nastavení modelu pak na záložce Gateway and cloud connections namapujete parametry z modelu (server, databáze) na existující connection.

Jeden gateway server je jediný bod selhání. Řešením je cluster — až 10 členů (nodes) nainstalovaných na různých strojích, které sdílejí stejnou konfiguraci datových zdrojů. Při instalaci druhého a dalšího gateway na stejný tenant zvolíte „Add to existing cluster" místo založení nového samostatného gateway.

Bez zapnutého přepínače směruje služba požadavky na primárního člena clusteru a na další člen přejde, jen když primární není dostupný (dokumentace na jiném místě téže stránky zmiňuje u vypnutého stavu i round-robin — přesné chování ověřte v aktuální verzi). Po zapnutí volby „Distribute requests across all active gateways in this cluster" se pro každý požadavek vybírá člen náhodně, s ohledem na CPU/memory throttling limity nastavené pro jednotlivé členy.

# instalace modulu (PowerShell 7, jednorazove)
Install-Module -Name DataGateway -Scope CurrentUser

# prihlaseni k Data Gateway service
Connect-DataGatewayServiceAccount

# vypis clusteru, kde je prihlaseny uzivatel adminem
Get-DataGatewayCluster

# detail konkretniho clusteru vcetne clenu
Get-DataGatewayCluster -GatewayClusterId 00000000-0000-0000-0000-000000000000 | Select-Object -ExpandProperty MemberGateways

# povoleni cloud datasource refresh na clusteru
Set-DataGatewayCluster -GatewayClusterId 00000000-0000-0000-0000-000000000000 -AllowCloudDatasourceRefresh $true

Ne každý zdroj potřebuje on-premises gateway. Cloudové zdroje se připojují přímo, bez instalace jakéhokoli agenta: Azure SQL Database, Azure Synapse, SharePoint Online, OneDrive, Dataverse, i položky uvnitř Fabricu samotného — Lakehouse, Warehouse. Pravidlo je jednoduché: pokud je zdroj „za firemním firewallem", gateway je potřeba; pokud běží nativně v cloudu, není.

Pro cloudové zdroje, které chcete zabezpečit přes privátní síť (Azure Private Link), existuje VNet data gateway — plně spravovaná alternativa ke standard gateway, kterou nemusíte instalovat ani patchovat. Podporuje Dataflow Gen2, Fabric pipelines, Copy Job, Mirroring, Power BI sémantické modely i paginated reporty. Vyžaduje Fabric kapacitu (libovolná F SKU) nebo Power BI Premium kapacitu (A4 SKU a vyšší, nebo libovolné P SKU). Autoscaling je u ní ve verzi preview — přesný stav ověřte v dokumentaci.

Scheduled refresh nastavíte na sémantickém modelu (Settings → Scheduled refresh) — časová zóna, konkrétní časy, notifikace při selhání. Gateway musí být v čase refreshe online, jinak refresh selže a přijde e-mail s upozorněním.

Incremental refresh

U velkých tabulek řeší opakovaný plný reload politika incremental refresh — dva parametry RangeStart/RangeEnd v Power Query definují okno, politika Archive/Refresh period určuje, kolik historie se drží a kolik se přepočítává. Volitelně lze zapnout „Detect data changes" (refreshuje jen skutečně změněné oddíly) a u Premium kapacity „Get latest data in real time with DirectQuery". Časový limit refreshe je 2 hodiny na Pro/shared kapacitě a 5 hodin na Premium; přes XMLA endpoint limit neplatí.

Kromě plánovaného refreshe lze aktualizaci spustit programově — Power BI REST API endpoint Refresh Dataset In Group. Enhanced (asynchronní) refresh navíc podporuje batched commits, refresh jen vybrané tabulky nebo partition, aplikaci politiky incremental refresh, timeout a zrušení běžící operace. Vyžaduje Premium/PPU/Embedded kapacitu a scope Dataset.ReadWrite.All.

POST https://api.powerbi.com/v1.0/myorg/groups/00000000-0000-0000-0000-000000000000/datasets/00000000-0000-0000-0000-000000000000/refreshes
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "type": "Full",
  "commitMode": "transactional",
  "maxParallelism": 2,
  "retryCount": 2,
  "objects": [
    { "table": "Prodej", "partition": "Prodej_2026" }
  ]
}

Stejnou operaci lze spustit i přes PowerShell modulem MicrosoftPowerBIMgmt:

Connect-PowerBIServiceAccount

Invoke-PowerBIRestMethod `
  -Url "groups/00000000-0000-0000-0000-000000000000/datasets/00000000-0000-0000-0000-000000000000/refreshes" `
  -Method Post `
  -Body '{"type":"Full","commitMode":"transactional"}'

Semantic model refresh activity ve Fabric pipelines

Fabric data pipelines nabízejí přímo aktivitu Semantic model refresh, která umožňuje orchestraci — spustit refresh po dokončení dataflow, navázat ho do sekvence dalších kroků, reagovat na event-driven trigger. Volitelně lze omezit refresh jen na vybrané tabulky nebo partitions a nastavit Wait on completion, Max parallelism, Retry count a režim Transactional/Partial Batch. Šablony pro tuto orchestraci jsou v dokumentaci označené jako preview — přesný stav ověřte.

U importu gateway potřebujete jen v okamžiku refreshe — mezi refreshi report běží nad daty uloženými v modelu, gateway se do dotazování vůbec nezapojuje. U DirectQuery a Live Connection na on-premises zdroj je to jinak: gateway je potřeba při každém otevření reportu a při každé interakci, protože dotaz jde na živý zdroj v reálném čase.

• On-premises data gateway — instalace (EN)
• Personal gateway mode (EN)
• Recovery key a šifrování credentials (EN)
• Gateway cluster a vysoká dostupnost (EN)
• VNet data gateway — přehled (EN)
• Data refresh — limity a plánování (EN)
• Enhanced refresh přes REST API (EN)
• Semantic model refresh activity ve Fabric pipelines (EN)
• Incremental refresh — přehled (EN)