Helyszíni adatátjáró – GYIK

General

Szükségem van átjáróra a felhőbeli adatforrásokhoz, például az Azure SQL Database-hez?

Nem, a szolgáltatások általában átjáró nélkül tudnak csatlakozni a felhőbeli adatforrásokhoz. Szükség lehet azonban egy adatátjáróra, ha az adatforrások tűzfal mögött találhatók, VPN-t igényelnek, vagy virtuális hálózatokon találhatók.

Miért jelenik meg az "InvalidConnectionCredentials" vagy az "AccessUnauthorized" hibaüzenet, amikor OAuth2 hitelesítő adatokkal fér hozzá az adatforrásokhoz az 1. adatfolyamból annak ellenére, hogy a hitelesítő adatok nemrég frissülnek (a stream közbeni jogkivonat frissítésével kapcsolatos probléma).

Amikor OAuth2 hitelesítő adatokat használ az Adatfolyam Gen1-ben, az átjáró nem támogatja automatikusan a jogkivonatok frissítését a hozzáférési jogkivonatok lejáratakor. A tokenek általában a frissítés kezdetétől számított 1 óra elteltével járnak le, de az adatforrástól és a bérlői szabályzatoktól függően akár 1 óránál hamarabb is lejárhatnak. A Gen2-adatfolyamok, a szemantikai modellek és az adatfolyamatok képesek a tokenek folyamat közbeni frissítésére, ezért ez nem érinti őket hátrányosan.

Milyen követelmények vonatkoznak az átjáróra?

Tekintse át a telepítési cikkben található követelmények szakaszt.

Az átjárót ugyanazon a gépen kell telepíteni, mint az adatforrást?

Nem, az átjáró a megadott kapcsolati információk használatával csatlakozik az adatforráshoz. Ebben az értelemben az átjárót tekintsük ügyfélalkalmazásnak. Az átjárónak csak a megadott kiszolgálóhoz kell csatlakoznia.

A Microsoft aktívan támogatja a helyszíni adatátjáró hány kiadását?

A Microsoft jelenleg csak a helyszíni adatátjáró utolsó hat kiadását támogatja aktívan. Minden hónapban kiadunk egy új frissítést az adatátjárókhoz.

Szükség van licencelési előfeltételekre az átjárók telepítéséhez?

Az átjárók telepítésére és regisztrálására nincsenek licenckorlátozások.

Vannak a hálózati sávszélességre vonatkozó követelmények?

Ellenőrizze, hogy a hálózati kapcsolat jó átviteli sebességgel rendelkezik-e. Minden környezet eltérő, és az átviteli sebesség az elküldött adatok mennyiségétől függ. A helyszíni adatforrás és Azure adatközpontok közötti minimális átviteli sebesség biztosításához használja a Azure ExpressRoute. Az átviteli sebesség méréséhez használhatja az Azure Speed Test alkalmazást.

Hol vannak tárolva a hitelesítő adataim?

Az adatforráshoz megadott hitelesítő adatok titkosítva vannak, és az átjárófelhő szolgáltatásban vannak tárolva. A hitelesítő adatok visszafejtése a helyszíni átjárón történik. A hitelesítő adatok Power BI-beli titkosításáról a Power BI biztonsági tanulmányában talál további információt.

Mi a tényleges Windows-szolgáltatás neve?

A helyi számítógépen a Szolgáltatások alkalmazásban a szolgáltatás neve "Helyszíni adatátjáró szolgáltatás". A Feladatkezelő Szolgáltatások lapján a szolgáltatás neve "PBIEgwService". A Windows-szolgáltatás alapértelmezés szerint az "NT SERVICE\PBIEgwService" szolgáltatást használja szolgáltatásazonosítóként (SSID).

Futhat-e az átjáró Windows-szolgáltatása Microsoft Entra ID-fiók alatt?

Nem, a Windows szolgáltatásnak érvényes Windows-fiókra van szüksége.

Vannak bejövő kapcsolatok az átjáróval a felhőből?

Nem, az átjáró kimenő kapcsolatokat használ az Azure Relayhez.

Mi történik, ha letiltom a kimenő kapcsolatokat? Mit kell megnyitnom?

Le kell tiltani az Azure Datacenter IP-listáját? Hol szerezhetem be a listát?

Ha letiltja a kimenő IP-forgalmat, előfordulhat, hogy fel kell oldania az Azure Datacenter IP-listájának letiltását. Az átjáró egy IP-cím és egy teljes tartománynevet használatával kommunikál az Azure Relayjel. Az Azure Datacenter IP-listája hetente frissül. További információ: Kimenő Azure-kapcsolatok engedélyezése.

Mi a késés a lekérdezések átjáróból adatforrásba való futtatásához? Mi a legjobb architektúra?

A hálózati késés elkerülése érdekében telepítse az átjárót a lehető legközelebb az adatforráshoz. Ha az átjárót a tényleges adatforrásra tudja telepíteni, ez a közelebbi hely minimalizálja a késést.

Vegye figyelembe az Azure-adatközpontok közelségét is. Ha például a szolgáltatás az USA nyugati régiójában található adatközpontot használja, és azure-beli virtuális gépen üzemelteti az SQL Servert, akkor az Azure-beli virtuális gépet is az USA nyugati régiójában szeretné használni. Ez a konfiguráció minimálisra csökkenti a késést, és elkerüli a kimenő díjakat az Azure-beli virtuális gépen.

Hogyan küldik vissza az eredményeket a felhőbe?

Az eredményeket az Azure Relay küldi el. További információ: Helyszíni adatátjáró-architektúra.

Elhelyezhetem az átjárót egy szegélyhálózaton (más néven DMZ-ben, demilitarizált zónában és szűrt alhálózatban)?

Az átjárónak csatlakoznia kell az adatforráshoz. Ha tehát az adatforrás nem érhető el a szegélyhálózaton, előfordulhat, hogy az átjáró nem rendelkezik hozzáféréssel.

Tegyük fel például, hogy az SQL Server-számítógép nincs a szegélyhálózaton. Tegyük fel azt is, hogy a szegélyhálózatról nem tud csatlakozni a számítógéphez. Ha az átjárót a szegélyhálózaton helyezi el, az átjáró nem éri el az SQL Server-számítógépet.

Ha az átjárót futtató kiszolgáló csak IPv6-címet használ, és csak IPv6-címmel csatlakozik egy adatforráshoz (például Azure SQL/File Server/Database az Azure-beli virtuális gépen), lehetséges-e a Power BI szolgáltatás keresztül kommunikálni az adatforrásokkal az átjárón keresztül?

Yes.

Ha az átjárót futtató kiszolgáló kettős vermet használ az IPv4- és IPv6-címek hozzárendeléséhez, az IPv4 vagy az IPv6 lesz az átjárók közötti kommunikáció prioritása?

Ez a prioritás a Windowstól vagy a megfelelő adatforrás-illesztőprogramoktól függ. Ez a viselkedés windowsos és különböző illesztőprogramokban is konfigurálható, de nincs az átjáró felügyelete alatt.

Támogatja az átjáró a bérlők közötti Microsoft Entra-azonosító elérését?

Az ugyanazon a felhőn belüli bérlők közötti hozzáférés támogatott, kivéve a B2B-vendégfelhasználókat érintő forgatókönyveket, amelyek hivatalosan nem támogatottak.

Kényszeríthetem az átjárót, hogy TCP helyett HTTPS-forgalmat használjon az Azure Relayrel?

Igen, további információkért lásd: HTTPS-kommunikáció kikényszerítése az Azure Relayjel. A funkció bekapcsolása kevés hatással van a teljesítményre.

A helyszíni adatátjáró és az Adatkezelési átjáró, amelyet az Azure Machine Learning Studio és az Azure Data Factory használ, ugyanaz a kettő?

Nem, ezek különböző termékek. Ha további információra van szüksége a adatkezelés Gatewayről, amelynek mostantól Self-hosted Integration Runtime a neve, olvassa el a következőt: Saját üzemeltetésű Integration Runtime létrehozása és konfigurálása.

Lehet, hogy az átjárót az Azure Portalon létrehozó személy különbözik attól, aki telepíti az átjárót?

Igen, PowerShellt kell használnia ahhoz, hogy további tulajdonosokat adjon hozzá ugyanahhoz az átjáróhoz. Ezek a felhasználók létrehozhatják az átjárót az Azure Portalon. Azonban a portálhoz és az átjáróhoz ugyanazt a bérlőt használva kell kapcsolódniuk.

Az Azure ExpressRoute nem igényli az átjárót?

No. A helyszíni adatforrásokhoz való csatlakozáskor továbbra is szükség van átjáróra.

Hogyan tárolhatom az adataimat ugyanabban a régióban helyszíni adatátjáró használata közben?

Frissítések és bejelentkezés

Miért jelentkeznek bejelentkezési problémák az átjáró telepítése, konfigurálása, helyreállítása, frissítése vagy kezelése során?

Microsoft biztonsági vonatkozású bejelentkezési módosításokat vezet be a Microsoft Identitásplatform. A 2026 májusa előtt kiadott átjáró-buildjein (valamint a 2026. január–áprilisi, javítatlan buildjein) előfordulhat, hogy az olyan interaktív bejelentkezés, amely böngészőt nyit meg, nem fejeződik be ezeknek a műveleteknek a során. Frissítsen egy aktuális átjáró buildre a bejelentkezés visszaállításához. További információ: A helyszíni adatátjáró frissítése a bejelentkezési problémák elkerülése érdekében.

Magas rendelkezésre állás és vészhelyreállítás

Vannak olyan tervek, amelyek lehetővé teszik a magas rendelkezésre állású forgatókönyveket az átjáróval?

Az egyetlen hibapont elkerülése érdekében fürtökként állíthat be helyszíni adatátjárókat a magas rendelkezésre állás érdekében. Alapértelmezés szerint az olyan felhőszolgáltatások, mint a Power Apps és a Power BI, az elsődleges átjárót használják, és visszaesnek a másodlagos átjáróra, ha az elsődleges nem érhető el.

Milyen lehetőségek állnak rendelkezésre a vészhelyreállításhoz?

Az átjáró telepítésekor meg kell adnia egy helyreállítási kulcsot. A kulccsal visszaállíthatja vagy migrálhatja az átjárót.

Mi a helyreállítási kulcs előnye?

A kulcs segítségével új átjárót adhat hozzá egy fürthöz, illetve migrálhatja, helyreállíthatja vagy átveheti az átjárót.

Troubleshooting

További információ: A helyszíni adatátjáró hibaelhárítása.

Hol találhatók az átjárónaplók?

További információ: Hibaelhárítási eszközök.

Hogyan állapíthatom meg, hogy a rendszer milyen lekérdezéseket küld a helyszíni adatforrásnak?

A lekérdezések nyomkövetését további naplózás bekapcsolásával engedélyezheti. A naplók tartalmazzák az elküldött lekérdezéseket. Ha végzett a hibaelhárítással, ne felejtse el kikapcsolni a lekérdezések nyomkövetését. Ha engedélyezve van a lekérdezéskövetés, a naplók nagyobbak lesznek.

Megtekintheti az adatforrás lekérdezések nyomon követésére szolgáló eszközeit is. Ha például az SQL Server és az SQL Server Analysis Services adatforrások, a lekérdezések nyomon követéséhez használhatja az SQL Server bővített eseményeit vagy az SQL Server Profilert.

Mekkora az átjárófürtben engedélyezett átjárótagok maximális száma?

Minden átjárófürt legfeljebb 10 átjárótagot (más néven csomópontot) támogat. A jelenleg 10-nél több tagot üzemeltető átjárófürtök továbbra is működnek, de nem teszik lehetővé új tagok hozzáadását, amíg előbb nem törölnek egy meglévő tagot.

Mit kell tennem, ha egy átjárófürtön elérim az 1000 adatforrás maximális korlátját, és hogyan kerülhetem el ezt a korlátot?

Minden személyes vagy vállalati átjárófürtön legfeljebb 1 000 adatforrás található. Ez a korlát a felhőszolgáltatás felhasználónkénti 1 000 adatforrás-korlátjától függetlenül kerül kiértékelésre.

Ha eléri az adatforrások maximális számát egy átjárófürtön, manuálisan eltávolíthatja a redundáns adatforrásokat a felügyeleti központból, vagy a következőket:

  • Az alábbi PowerShell-szkripttel megkeresheti a korlátot meghaladó személyes átjárót, és tömegesen törölheti az összes adatforrást.
## https://learn.microsoft.com/powershell/module/datagateway/?view=datagateway-ps
## PowerShell version of '7.0.0' to run
## required module "DataGateway" Install-Module -Name DataGateway and sign in the same user who exceeded the 1000 limit
Connect-DataGatewayServiceAccount

## get the gateway information per the sign in person
$gatewayClusters = Get-DataGatewayCluster | where-Object {$_.Type -EQ 'Personal'}; 
foreach ($gw in $gatewayClusters)
{
  $datasources = Get-DataGatewayClusterDatasource -GatewayClusterId $gw.Id;
  foreach ($datasource in $datasources)
  {
    $datasource
    "gateway cluster id={0}, Personal Gateway={1}, datasource id={2}, datasourceType={3}, datasource connection details={4}" -f $gw.Id, $datasource.OnPremGatewayRequired, $datasource.Id, $datasource.DatasourceType, $datasource.ConnectionDetails 
   
    ## conditional logic to determine if name matches set
    ## Remove-DataGatewayClusterDatasource -GatewayClusterId $gw.Id -GatewayClusterDatasourceId $datasource.Id
  }
}
  • Az alábbi PowerShell-szkripttel tömegesen törölhet minden adatforrást egy adott vállalati átjáró használatával:
## https://learn.microsoft.com/powershell/module/datagateway/?view=datagateway-ps
## PowerShell version of '7.0.0' to run
## required module "DataGateway" Install-Module -Name DataGateway and sign in the same user who exceeded the 1000 limit
Connect-DataGatewayServiceAccount
 
## get the gateway information per the sign in person
$datasources = Get-DataGatewayClusterDatasource -GatewayClusterId <GatewayClusterId>;
foreach ($datasource in $datasources)
{
  $datasource
  "datasource id={2}, datasourceType={3}, datasource connection details={4}" -f $datasource.Id, $datasource.DatasourceType, $datasource.ConnectionDetails
 
  ## conditional logic to determine if name matches set
  ## Remove-DataGatewayClusterDatasource -GatewayClusterId $gw.Id -GatewayClusterDatasourceId $datasource.Id
}

Hogyan ne érje el ezt a korlátot? Ha Ön ISV vagy sok ügyféllel rendelkező más Power BI Embedded-alkalmazás tulajdonosa, a Power BI Embedded több-bérlős alkalmazásaihoz használjon egyszerű szolgáltatásprofilokat, hogy elkerülje az átjárókra vonatkozó korlátozást (csak személyes módban). Ha nem független szoftverszállító, akkor elérheti ezt a korlátot, mert minden CSV- vagy Excel-fájlhoz létrehoz egy új adatforrást. Ennek megoldásához érdemes lehet a Power BI Desktop "fájlfeltöltési mezőjét" használni több Excel-fájl kiválasztásához, amely több adatforrás-kapcsolatot hoz létre. Ebben a forgatókönyvben annak érdekében, hogy csak egyetlen adatforrás legyen kijelölve, javasoljuk, hogy inkább válassza ki az Excel-fájlokat tartalmazó mappát.

Administration

Rendelkezhetek egynél több rendszergazdai jogosultsággal egy átjáróhoz?

Igen, az átjárók kezelésekor a rendszergazda lapjára léphet további rendszergazdák hozzáadásához. Rendszergazdaként biztonsági csoportokat is használhat.

Az átjáró rendszergazdájának rendszergazdai jogosultsággal kell rendelkeznie azon a számítógépen, amelyre az átjáró telepítve van?

Nem, az átjáró rendszergazdája kezeli az átjárót a szolgáltatáson belülről.

Migration

Ha az átjáró migrálása sikertelen, folytathatja az átjárótevékenységet a régi átjárókiszolgálóról? Ez manuális műveletet igényel?

Ha az áttelepítési folyamat meghiúsul az új kiszolgálón, a helyszíni adatátjáró továbbra is létezik a régi kiszolgálón. Az átjárót továbbra is futtathatja, kivéve, ha a kiszolgáló offline állapotban van, vagy az átjárószoftvert eltávolították. Ha azonban a régi kiszolgálón szeretné visszaállítani az átjárót, előfordulhat, hogy az átjáró helyreállítási kulcsának használatára van szükség.

Mennyi ideig tart a helyszíni adatátjáró teljes migrálása?

Mivel a migrálás csak két feladatot tartalmaz, az átjáró telepítését, valamint a visszaállítást és a konfigurációt az új kiszolgálón, az áttelepítés általában 10–15 perc alatt elvégezhető.

Ha feltételezzük, hogy a teljes migrálási folyamat 5 percet vesz igénybe, az ebben az 5 percben végrehajtott összes frissítés esetén hová kerül a forgalom? Átmegy a régi átjárókiszolgálón a migrálás befejezése előtt?

Yes. Ez idő alatt azonban nagy a meghibásodás kockázata, és az ilyen migrációkat tervezett leállási időszakban kell elvégezni. További információt a migrálás leállási idejének minimalizálása című témakörben talál.