Rövid útmutató: Resource Graph-lekérdezés futtatása az Azure Portalon

Ez a rövid útmutató bemutatja, hogyan futtathat Azure Resource Graph-lekérdezést az Azure Portalon az Azure Resource Graph Explorer használatával. A Resource Graph Explorer lehetővé teszi az Azure Resource Manager-erőforrástípusokra és -tulajdonságokra vonatkozó információk lekérdezését. A Resource Graph Explorer emellett felületet biztosít több lekérdezések használatához, az eredmények kiértékeléséhez és egyes lekérdezések eredményeinek egy Azure-irányítópultra rögzíthető diagrammá alakításához is.

Előfeltételek

Ha még nem rendelkezik Azure-fiókkal, első lépésként hozzon létre egy ingyenes fiókot.

Lekérdezés futtatása

Lekérdezés futtatása az Azure Portalról az Azure Resource Graph Explorer használatával.

  1. Jelentkezzen be az Azure Portalra.

  2. Keressen erőforrás-gráfot, és válassza a Resource Graph Explorer lehetőséget.

    Képernyőkép az Azure Portalról az erőforrás-grafikon kereséséhez.

  3. Ha módosítania kell a hatókört, válassza a Címtár lehetőséget. Ezután válassza ki a lekérdezni kívánt erőforrások címtárát, felügyeleti csoportját vagy előfizetését.

    Képernyőkép az Azure Resource Graph Explorerről a címtár, a felügyeleti csoport vagy az előfizetés hatókörének módosításához.

  4. Másolja és illessze be a következő lekérdezést az ablak Lekérdezés 1 részében. Ezután válassza a Lekérdezés futtatása lehetőséget.

    resources
    | project name, type
    | limit 5
    

    Képernyőkép az Azure Resource Graph Explorerről, amely kiemeli a futtatott lekérdezéseket, eredményeket és üzeneteket.

    Ez a lekérdezési példa nem biztosít olyan rendezési módosítót, mint a order by. Ha többször futtatja a lekérdezést, az az egyes kérésekhez eltérő erőforráskészletet eredményezhet.

  5. Tekintse át a lekérdezésre adott választ az Eredmények lapon, és válassza az Üzenetek lapot a lekérdezés részleteinek megtekintéséhez, beleértve az eredmények számát és a lekérdezés időtartamát. Ha vannak ilyenek, hibaüzenetek jelennek meg az Üzenetekben.

  6. Frissítse a lekérdezést a name tulajdonságraorder by. Ezután válassza a Lekérdezés futtatása lehetőséget

    resources
    | project name, type
    | limit 5
    | order by name asc
    

    Az előző lekérdezéshez hasonlóan a lekérdezés többszöri futtatása eltérő erőforráskészletet eredményezhet az egyes kérésekhez. Fontos a lekérdezési parancsok sorrendje. Ebben a példában az order by a limit után következik. A lekérdezés öt erőforrásra korlátozza az eredményeket, majd név szerint rendeli el az eredményeket.

  7. Frissítse a lekérdezést a name tulajdonságraorder by, majd limit az első öt találatra. Ezután válassza a Lekérdezés futtatása lehetőséget.

    resources
    | project name, type
    | order by name asc
    | limit 5
    

    Ha ezt a lekérdezést többször futtatja a környezet módosítása nélkül, az eredmények konzisztensek és a tulajdonság szerint name vannak rendezve, de továbbra is öt találatra korlátozódnak. A lekérdezés név alapján rendeli meg az eredményeket, majd öt erőforrásra korlátozza a kimenetet.

Sémaböngésző

A sémaböngésző a Resource Graph Explorer bal oldali paneljén található. Ez az erőforráslista az Azure Resource Graph által támogatott és a bérlőben létező Azure-erőforrások összes erőforrástípusát tartalmazza. Válasszon ki egy erőforrástípust vagy tulajdonságot a Resource Graph-lekérdezés létrehozásához használható gyermektulajdonságok megjelenítéséhez.

Válasszon ki egy táblanevet a sémaböngészőből, és a rendszer hozzáadja a lekérdezéshez. Amikor kiválaszt egy erőforrástípust, az hozzáadódik a lekérdezéshez, például where type =="<resource type>". Ha kiválaszt egy tulajdonságot, az a lekérdezés következő sorához lesz hozzáadva, például where <propertyName> == "INSERT_VALUE_HERE". A sémaböngészővel megkeresheti a lekérdezésekben használható tulajdonságokat. Mindenképpen cserélje le INSERT_VALUE_HERE a saját értékére, és módosítsa a lekérdezést feltételekkel, operátorokkal és függvényekkel.

Ez a példa egy olyan lekérdezést mutat be, amely a sémaböngészőből lett létrehozva az erőforrástípust microsoft.authorization/roledefinitions és a tulajdonságot roleNametartalmazó tábla authorizationresources kiválasztásával.

authorizationresources
| where type == "microsoft.authorization/roledefinitions"
| where properties['roleName'] == "INSERT_VALUE_HERE"

Képernyőkép az Azure Resource Graph Explorer sémaböngészőről, amely kiemeli az erőforrás típusát és tulajdonságait.

Lekérdezési eredmények letöltése CSV-fájlként

Ha vesszővel tagolt értékeket (CSV) szeretne letölteni az Azure Portalról, keresse meg az Azure Resource Graph Explorert, és futtasson egy lekérdezést. Az eszköztáron válassza a Letöltés CSV-ként lehetőséget az alábbi képernyőképen látható módon:

Képernyőkép az Azure Resource Graph Explorerről, kiemelt CSV-ként való letöltéssel.

Ha az Azure Resource Graph Explorer CSV-exportálási funkcióját használja, az eredményhalmaz 55 000 rekordra korlátozódik. Ez a korlátozás egy platformkorlát, amelyet nem lehet felülírni egy Azure-támogatás jegy beadásával.

Diagram létrehozása lekérdezési eredményekből

Olyan lekérdezésekből hozhat létre diagramokat, amelyek az erőforrások számának számát adják ki. A kimeneti listákat tartalmazó lekérdezések nem hozhatók diagramba. Ha diagramot próbál létrehozni egy listából, a Diagramok lapon megjelenik egy olyan üzenet, mint az eredményhalmaz, amely nem kompatibilis a fánkdiagram-vizualizációval.

Ha diagramot szeretne létrehozni a lekérdezés eredményeiből, hajtsa végre a következő lépéseket:

  1. Az ablak Lekérdezés 1 részében adja meg a következő lekérdezést, és válassza a Lekérdezés futtatása lehetőséget.

    resources
    | where type == "microsoft.compute/virtualmachines"
    | summarize count() by tostring(properties.storageProfile.osDisk.osType)
    
  2. Válassza az Eredmények lapot, és vegye figyelembe, hogy a lekérdezés válasza számokat ad.

  3. Válassza a Diagramok lapot. Módosítsa a típust a Diagramtípus kiválasztása lehetőségről sávdiagramra vagy fánkdiagramra.

    Képernyőkép az Azure Resource Graph Explorerről, kiemelt diagramok legördülő menüvel.

Lekérdezésvizualizáció rögzítése az irányítópulton

Ha vizualizálható lekérdezés eredményei vannak, az adatvizualizáció rögzíthető az Azure Portal irányítópultján. Az előző lekérdezés futtatása után kövesse az alábbi lépéseket:

  1. Válassza a Mentés lehetőséget, és használja a virtuális gép nevét operációsrendszer-típus szerint, és írja be magánjellegű lekérdezésként. Ezután válassza a Jobb oldali ablaktábla alján található Mentés lehetőséget.
  2. Válassza a Lekérdezés futtatása lehetőséget a mentett lekérdezés újrafuttatásához.
  3. A Diagramok lapon válasszon ki egy adatvizualizációt. Ezután válassza a Rögzítés az irányítópulton lehetőséget.
  4. A rögzítéstől az irányítópultig válassza ki azt a meglévő irányítópultot, ahol meg szeretné jeleníteni a diagramot.
  5. Válassza az Irányítópult lehetőséget a hamburger menüből (három vízszintes vonal) bármelyik portáloldal tetején, bal oldalán.

A lekérdezés mostantól elérhető az irányítópulton a virtuális gép operációsrendszer-típus szerinti címmel. Ha a lekérdezés nem lett mentve a rögzítés előtt, a név inkább az 1 . lekérdezés lesz.

A lekérdezés és az eredményül kapott adatvizualizáció minden alkalommal fut és frissül, amikor az irányítópult betöltődik, és valós idejű és dinamikus elemzéseket biztosít az Azure-környezethez közvetlenül a munkafolyamatban.

A listát eredményező lekérdezések rögzíthetők az irányítópulton is. A funkció nem korlátozódik a lekérdezések adatvizualizációira.

Amikor a portálról futtat egy lekérdezést, a Címtár lehetőséget választva módosíthatja a lekérdezés hatókörét a lekérdezni kívánt erőforrások címtárára, felügyeleti csoportjára vagy előfizetésére vonatkozóan. Az irányítópulton való rögzítéskor a rendszer hozzáadja az eredményeket az Azure-irányítópulthoz a lekérdezés futtatásakor használt hatókörrel.

Az irányítópultok használatával kapcsolatos további információkért lásd : Irányítópult létrehozása az Azure Portalon.

Az erőforrások eltávolítása

Ha el szeretné távolítani a Resource Graph-minta irányítópultokat az Azure Portal-környezetből, hajtsa végre a következő lépéseket:

  1. Válassza az Irányítópult lehetőséget a hamburger menüből (három vízszintes vonal) bármelyik portáloldal tetején, bal oldalán.
  2. Az irányítópulton keresse meg a virtuális gépet operációsrendszer-típusdiagram alapján, és válassza ki a három pontot (...) a menü megjelenítéséhez.
  3. Válassza az Eltávolítás az irányítópultról lehetőséget, majd a Megerősítéshez válassza a Mentés lehetőséget .

Ha törölni szeretné a mentett lekérdezéseket, például a virtuális gépet operációsrendszer-típus szerint, hajtsa végre a következő lépéseket:

  1. Nyissa meg az Azure Resource Graph Explorert.
  2. Válassza a Lekérdezés megnyitása lehetőséget.
  3. Válassza a Privát lekérdezések beírásalehetőséget.
  4. A Lekérdezés nevére kattintva válassza a szeméttároló ikont a lekérdezés törléséhez.
  5. A törlés megerősítéséhez válassza az Igen lehetőséget.

Következő lépések

Ebben a rövid útmutatóban az Azure Resource Graph Explorer használatával futtatott egy lekérdezést, és áttekintette a diagramok és irányítópultok használatát. További információkért tekintse meg a lekérdezés nyelvének részleteit ismertető cikket.