Lucrati cu seturi de date mari – Azure Resource Graph

• 17/05/2021
• 5 minute de citit

• • D

  • A

  • w

In acest articol

Azure Resource Graph este conceput pentru a lucra cu si pentru a obtine informatii despre resurse in mediul dvs. Azure. Resource Graph face ca obtinerea acestor date sa fie rapida, chiar si atunci cand interogati mii de inregistrari. Resource Graph are mai multe optiuni pentru lucrul cu aceste seturi mari de date.

Pentru indrumari despre lucrul cu interogari la o frecventa ridicata, consultati Indrumari pentru solicitari restranse.

Dimensiunea rezultatului setului de date

In mod implicit, Resource Graph limiteaza orice interogare la returnarea a numai 100 de inregistrari. Acest control protejeaza atat utilizatorul, cat si serviciul de interogari neintentionate care ar duce la seturi mari de date. Acest eveniment se intampla cel mai adesea in timp ce un client experimenteaza interogari pentru a gasi si filtra resursele in modul care se potriveste nevoilor lor specifice. Acest control este diferit de utilizarea operatorilor de limba Azure Data Explorer superioara sau limitata pentru a limita rezultatele.

Limita implicita poate fi anulata prin toate metodele de interactiune cu Resource Graph. Urmatoarele exemple arata cum sa schimbati limita dimensiunii setului de date la 200 :

interogare grafic az -q “Resurse | nume proiect | comanda dupa nume asc” –prim 200 – tabel de iesire Cautare-AzGraph -Intrebare “Resurse | nume proiect | comanda dupa nume asc” -Prima 200

In API-ul REST, controlul este $ top si face parte din QueryRequestOptions .

Controlul care este cel mai restrictiv va castiga. De exemplu, daca interogarea dvs. utilizeaza operatorii de top sau limita si ar rezulta in mai multe inregistrari decat First , inregistrarile maxime returnate ar fi egale cu First . La fel, daca top sau limit este mai mic decat First , setul de inregistrari returnate ar fi valoarea mai mica configurata de top sau limit .

In primul rand, are in prezent o valoare maxima permisa de 5000 , pe care o atinge prin paginarea rezultatelor 1000 de inregistrari la un moment dat.

Ignorarea inregistrarilor

Urmatoarea optiune pentru lucrul cu seturi de date mari este controlul Skip . Acest control permite interogarii dvs. sa sara peste sau sa sari peste numarul definit de inregistrari inainte de a returna rezultatele. Ignorarea este utila pentru interogarile care sorteaza rezultatele intr-un mod semnificativ in care intentia este de a ajunge la inregistrari undeva la mijlocul setului de rezultate. Daca rezultatele necesare sunt la sfarsitul setului de date returnate, este mai eficient sa utilizati o alta configuratie de sortare si sa extrageti rezultatele din partea de sus a setului de date.

Urmatoarele exemple arata cum sa omiteti primele 10 inregistrari in care ar rezulta o interogare, incepand in schimb setul de rezultate returnate cu a 11-a inregistrare:

interogare grafic az -q “Resurse | nume proiect | comanda dupa nume asc” –skip 10 –output table Search-AzGraph -Interogare “Resurse | nume proiect | comanda dupa nume asc” -Skip 10

In API-ul REST, controlul este $ skip si face parte din QueryRequestOptions .

Rezultatele paginarii

Cand este necesar sa impartiti un set de rezultate in seturi mai mici de inregistrari pentru procesare sau deoarece un set de rezultate ar depasi valoarea maxima permisa de 1000 de inregistrari returnate, utilizati paginarea. API-ul REST QueryResponse ofera valori pentru a indica faptul ca un set de rezultate a fost divizat: resultTruncated si $ skipToken . resultTruncated este o valoare booleana care informeaza consumatorul daca exista mai multe inregistrari care nu sunt returnate in raspuns. Aceasta conditie poate fi identificata si atunci cand proprietatea count este mai mica decat proprietatea totalRecords . totalRecords defineste cate inregistrari se potrivesc interogarii.

resultTruncated este adevarat atunci cand paginarea este dezactivata sau nu este posibila, deoarece nu exista coloana id sau cand exista mai putine resurse disponibile decat solicita o interogare. Cand resultTruncated este adevarat , proprietatea $ skipToken nu este setata.

Urmatoarele exemple arata cum sa omiteti primele 3.000 de inregistrari si sa intoarceti primele 1.000 de inregistrari dupa inregistrarile omise cu Azure CLI si Azure PowerShell:

interogare grafic az -q “Resurse | ID proiect, nume | comanda dupa ID asc” –prima 1000 –skip 3000 Cautare-AzGraph -Intrebare “Resurse | ID proiect, nume | comanda dupa ID asc” -Prima 1000 -Skip 3000

Pentru un exemplu, consultati interogarea urmatoarei pagini in documentele REST API.

Formatarea rezultatelor

Rezultatele unei interogari cu Resource Graph sunt furnizate in doua formate, Table si ObjectArray . Formatul este configurat cu parametrul resultFormat ca parte a optiunilor de solicitare. Tabelul Formatul este valoarea implicita pentru resultFormat .

Rezultatele din Azure CLI sunt furnizate in mod implicit in JSON. Rezultatele din Azure PowerShell sunt un obiect PSResourceGraphResponse , dar pot fi convertite rapid in JSON folosind cmdlet-ul ConvertTo-Json de pe proprietatea Data . Pentru alte SDK-uri, rezultatele interogarii pot fi configurate pentru a genera formatul ObjectArray .

Format – Tabel

Formatul implicit, Table , returneaza rezultatele intr-un format JSON conceput pentru a evidentia proiectarea coloanei si valorile randurilor proprietatilor returnate de interogare. Acest format seamana foarte mult cu datele asa cum sunt definite intr-un tabel structurat sau o foaie de calcul, cu coloanele identificate mai intai si apoi fiecare rand reprezentand date aliniate la acele coloane.

Iata un exemplu de rezultat al interogarii cu formatarea tabelului :

{“totalRecords”: 47, “count”: 1, “data”: {“columns”: [{“name”: “name”, “type”: “string”}, {“name”: “type”, “tip”: “sir”}, {“nume”: “locatie”, “tip”: “sir”}, {“nume”: “subscriptieId”, “tip”: “sir”}], “randuri”: [[“veryscaryvm2-nsg”, “microsoft.network/networksecuritygroups”, “eastus”, “11111111-1111-1111-1111-111111111111”]]}, “facets”: [], “resultTruncated”: “true”}

Format – ObjectArray

ObjectArray Formatul returneaza , de asemenea , rezultatele intr – un format JSON. Cu toate acestea, acest design se aliniaza la relatia de pereche cheie / valoare comuna in JSON, unde coloana si datele de rand sunt potrivite in grupuri de matrice.

Iata un exemplu de rezultat al interogarii cu formatarea ObjectArray :

{“totalRecords”: 47, “count”: 1, “data”: [{“name”: “veryscaryvm2-nsg”, “type”: “microsoft.network/networksecuritygroups”, “location”: “eastus”, ” subscriptieId “:” 11111111-1111-1111-1111-111111111111 “}],” fatete “: [],” resultTruncated “:” adevarat “}

Iata cateva exemple de setare resultFormat pentru a utiliza formatul ObjectArray :

var requestOptions = new QueryRequestOptions (resultFormat: ResultFormat.ObjectArray); var request = new QueryRequest (abonamente, “Resurse | limita 1”, optiuni: requestOptions); request_options = QueryRequestOptions (result_format = ResultFormat.object_array) request = QueryRequest (interogare = “Resurse | limita 1”, abonamente = subs_list, options = request_options)

Pasii urmatori

• Vedeti limba utilizata in interogarile Starter.
• Vedeti utilizari avansate in interogari avansate.
• Aflati mai multe despre modul de explorare a resurselor.