Functii noi pentru API-ul Power BI Dataset

19 iulie 2016

Setul de date API a fost primul API REST pe care l-am lansat vreodata pentru Power BI. A permis unui dezvoltator sa creeze programatic un set de date simplu si apoi sa impinga datele direct intr-un tabel din acel set de date. Acest lucru a permis dezvoltatorilor sa trimita date de la orice tip de sursa la Power BI. Astazi, suntem incantati sa anuntam previzualizarea a doua noi caracteristici care vor imbunatati modul in care datele pot fi transmise la Power BI:

1. Proprietati de modelare suplimentare la generarea seturilor de date.
2. Specificarea numerelor de ordine pentru a garanta care randuri au fost impinse cu succes si pentru a evita duplicarea

API-ul v1 curent al seturilor de date permite numai crearea unui set de date cu un nume si o colectie de tabele. Fiecare tabel poate avea un nume si o colectie de coloane. Fiecare coloana are un nume si un tip de date. Cu aceasta versiune de previzualizare, extindem foarte mult aceste proprietati, in special cu suport pentru masuri si relatii intre tabele. Lista completa a proprietatilor acceptate este urmatoarea:

Set de date

Nume Tip Descriere Citire numai Id obligatoriu Guid Identificator unic la nivel de sistem pentru setul de date Adevarat nume fals Sir Nume definit de utilizator al setului de date False Tabele adevarate Tabel [] Colectie de tabele False Relatii false Relatie [] Colectie de relatii intre tabele False False

Relatie

Nume Tip Descriere Numai citire Nume necesar Sir Nume definit de utilizator al relatiei. De asemenea, este folosit ca identificator al relatiei. Fals True crossFilteringBehavior String Directia filtrului relatiei

• OneDirection (implicit)
• Ambele directii
• Automat

False False fromTable String Numele tabelului cu chei straine False True fromColumn String Numele coloanei cheii straine False True toTable String Numele tabelei de chei primare False True toColumn String Numele coloanei cheii primare False True

Masa

Nume Tip Descriere Numai citire Nume necesar Sir Nume definit de utilizator al tabelului. De asemenea, este folosit ca identificator al tabelului. Coloana Coloane false false [] Colectie de coloane. False True masura masura [] Colectie de masuri False False isHidden Boolean Daca este adevarat, tabelul va fi ascuns de instrumentele clientului False false

Coloana

Nume Tip Descriere Numai citire Nume obligatoriu Sir Nume definit de utilizator al coloanei. False True DataType EDM Datatype Tipuri de date si restrictii EDM acceptate : Tip de date Restrictii Int64 Int64.MaxValue si Int64.MinValue nu sunt permise. Valorile Double Double.MaxValue si Double.MinValue nu sunt permise. NaN nu este acceptat. + Infinity si -Infinity nu sunt acceptate in unele functii (de ex. Min, Max). Data booleana In timpul incarcarii datelor, cuantificam valorile cu fractii de zi la multipli intregi de 1/300 secunde (3,33 ms). Sirul In prezent permite pana la 128K caractere. False True formatString String Un sir care descrie modul in care ar trebui formatata valoarea atunci cand este afisata.https://msdn.microsoft.com/en-us/library/ms146084.aspx False False sortByColumn String Numele sirului unei coloane din acelasi tabel pentru a fi utilizat pentru a comanda coloana actuala False False data Categorie Sirul valorii sirului pentru care trebuie utilizata categoria de date care descrie datele din aceasta coloana. Unele valori comune includ:

• Abordare
• Oras
• Continent
• Tara
• Imagine
• Imagine URL
• Latitudine
• Longitudine
• Organizare
• Loc
• Cod postal
• Stat sau provincie
• WebUrl

Fals Fals Proprietate booleana ascunsa care indica daca coloana este ascunsa vizualizarii. Implicit este fals. False False resumeBy string Metoda de agregare implicita pentru coloana. Valorile includ:

• Mod implicit
• nici unul
• suma
• min
• max
• numara
• in medie
• distinctCount

 Fals Fals

Masura

Nume Tip Descriere Numai citire Nume necesar Sir Nume definit de utilizator al masurii. False True expression String O expresie DAX valida False True formatString String Un sir care descrie modul in care trebuie formatata valoarea atunci cand este afisata. https://msdn.microsoft.com/en-us/library/ms146084.aspx False False isHidden String Daca este adevarat, tabelul va fi ascuns de instrumentele client False false

Un exemplu de set de date care utilizeaza doar cateva dintre aceste proprietati ar arata astfel:

Puteti incerca sa creati un nou set de date fara a scrie niciun cod la: https://docs.powerbi.apiary.io/#reference/datasets-preview/datasets-collection/create-a-dataset .

Noul set de date este actual disponibil doar in previzualizare . Poate fi accesat la https://api.powerbi.com/beta/myorg/datasets . Va rugam sa lasati orice feedback la https://community.powerBI.com .

Cand impingeti randurile catre un tabel in Power BI, veti primi un raspuns 200 OK atunci cand randurile sunt incarcate cu succes in Power BI si un anumit cod de stare de eroare atunci cand nu sunt. Totusi, ce se intampla cu acele cazuri rare cand nu primiti deloc un raspuns din cauza unei probleme de retea sau de expirare? Ar trebui sa impingeti din nou datele? Inainte de acum, nu exista nici o modalitate de a sti. Acum, cu numerele de ordine, stiti intotdeauna in ce stare se afla datele dvs. Numerele de secventa sunt atribuite unui set de randuri pe care le impingeti. Daca nu sunteti sigur daca apelul anterior a reusit, trimiteti cu acelasi numar de ordine si vom stabili daca apelul este sau nu duplicat.

Puteti profita de numerele de ordine adaugand antetul „X-PowerBI-PushData-SequenceNumber” la apelul „randuri POST”:

Acest antet are un numar intreg pe 64 de biti, pe care ar trebui sa-l mariti de fiecare data cand postati randuri noi. Power BI va salva cel mai recent numar de ordine impreuna cu datele dvs. Atata timp cat fiecare dintre solicitarile dvs. „randuri POST” are un numar de secventa mai mare decat ceea ce este stocat cu datele, solicitarea va reusi. Daca nu sunteti sigur daca solicitarea dvs. a reusit sau nu, ar trebui sa o retrimiteti cu acelasi numar de ordine ca si cererea initiala. Daca solicitarea initiala ar fi reusit, a doua cerere ar esua cu o eroare 412 „Preconditie esuata”:

Apoi, puteti trece la urmatorul set de date cu un nou numar de ordine. Daca trebuie sa descoperiti numarul de secventa curent care este stocat impreuna cu datele din tabel, puteti efectua urmatorul apel API pe masa:

Corpul de raspuns va arata cam asa:

Incercati API-ul acum la: https://docs.powerbi.apiary.io/#reference/datasets/table-sequence-number .

Abordarea de mai sus functioneaza excelent daca aveti un singur dispozitiv sau client care trece la o masa in Power BI. Cu toate acestea, daca aveti mai multe dispozitive sau clienti care imping la acelasi tabel in acelasi timp, puteti adauga antetul „X-PowerBI-PushData-ClientId” si un ID client pentru a mentine un numar de secventa separat pentru fiecare client. Utilizarea acestui antet este optionala.

Numerele de secventa sunt acceptate atat in ​​versiunile v1, cat si in versiunile beta ale API-ului.

Pentru a incerca toate API-urile mentionate in acest articol, vizitati: https://docs.powerbi.apiary.io . Pentru mai multe informatii despre dezvoltarea pentru Power BI, consultati: https://dev.powerbi.com .