Spracovanie prístupu k údajom

  • Článok

Funkcie zdroja údajov

Data Pripojenie alebo zalomí a prispôsobí správanie funkcie zdroja údajov v knižnici M. Rozšírenie rozhrania REST API by napríklad použilo funkciu Web.Contents na vytváranie požiadaviek HTTP. V súčasnosti je povolená obmedzená množina funkcií zdroja údajov na podporu rozšíriteľnosti.

Príklad:

[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;

Typ zdroja údajov

Funkcie označené ako shared vo vašom rozšírení môžu byť priradené ku konkrétnemu zdroju údajov zahrnutím literálového DataSource.Kind atribútu do funkcie s názvom záznamu definície zdroja údajov. Záznam Zdroj údajov definuje typy overovania podporované vaším zdrojom údajov a základné informácie o značkách (napríklad zobrazovaný názov/označenie). Názov záznamu sa stane jeho jedinečným identifikátorom.

Každá funkcia priradená k rovnakému zdroju údajov musí mať rovnaké požadované parametre funkcie vrátane názvu, typu a poradia. (Na účely druhu zdroja údajov sa parameter nepovažuje za povinný, ak je označený optional alebo ak jeho metaúdaje obsahujú DataSource.Path = false.)

Funkcie pre konkrétny druh zdroja údajov môžu používať iba poverenia priradené k tomuto druhu. Poverenia sa identifikujú v režime runtime vykonaním vyhľadávania na základe kombinácie požadovaných parametrov funkcie. Ďalšie informácie o identifikovaní poverení nájdete v téme Cesty k zdroju údajov.

Príklad:

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

Vlastnosti

Nasledujúca tabuľka obsahuje zoznam polí pre váš záznam definície zdroja údajov.

Pole Zadať Podrobnosti
Overovanie Záznam Určuje jeden alebo viac typov overovania, ktoré je podporované vaším zdrojom údajov. Vyžaduje sa aspoň jeden druh. Každý druh sa zobrazí ako možnosť v riadku poverení doplnku Power Query. Ďalšie informácie nájdete v téme Typy overovania.
Označenie text (voliteľné) Popisný zobrazovaný názov pre toto rozšírenie v dialógových oknách poverení.
SupportsEncryption Logické (voliteľné) Ak je hodnota True, používateľské rozhranie zobrazí možnosť pripojiť sa k zdroju údajov pomocou šifrovaného pripojenia. Táto možnosť sa zvyčajne používa pre zdroje údajov s nešifrovaným záložným mechanizmom (všeobecne odbc alebo zdroje založené na ADO.NET).

Publikovať do používateľského rozhrania

Podobne ako záznam definície zdroja údajov poskytuje záznam Publish používateľského rozhrania Power Query informácie, ktoré potrebuje na zobrazenie tohto rozšírenia v dialógovom okne Získať údaje.

Príklad:

HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];

HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

Vlastnosti

Nasledujúca tabuľka obsahuje zoznam polí pre váš záznam Publish (Publikovať).

Pole Zadať Podrobnosti
Text tlačidla Zoznam Zoznam textových položiek. Prvá položka definuje názov zobrazený vedľa ikony zdroja údajov v dialógovom okne Získať údaje v službe Power BI. Druhá položka (voliteľné) definuje tip nástroja, ktorý sa zobrazí po prejdení kurzorom myši na predchádzajúci názov.
Category text Kde by sa malo rozšírenie zobraziť v dialógovom okne Získať údaje . V súčasnosti sú Azure jedinými hodnotami kategórií so špeciálnym odovzdaním a Database. Všetky ostatné hodnoty skončia v kategórii Iné.
Beta Logické (voliteľné) Ak je nastavená hodnota true, používateľské rozhranie zobrazí vedľa názvu konektora identifikátor ukážky/beta a dialógové okno s upozornením, že implementácia konektora podlieha prelomovým zmenám.
LearnMoreUrl text (voliteľné) URL adresa webovej lokality obsahujúca ďalšie informácie o tomto zdroji údajov alebo konektore.
SupportsDirectQuery Logické (voliteľné) Zapne priamy dotaz pre vaše rozšírenie.
SourceImage Záznam (voliteľné) Záznam obsahujúci zoznam binárnych obrázkov (pochádza zo súboru rozšírenia pomocou metódy Extension.Contents ). Záznam obsahuje dve polia (Icon16, Icon32), každé s vlastným zoznamom. Každá ikona by mala mať odlišnú veľkosť.
SourceTypeImage Záznam (voliteľné) Podobne ako v prípade obrázka SourceImage, okrem konvencie pre mnohé predpripravené konektory je zobraziť ikonu hárka s ikonou špecifickou pre zdroj v pravom dolnom rohu. Použitie inej množiny ikon pre ZdrojTypImage je voliteľné . Mnoho rozšírení jednoducho znova použije rovnakú množinu ikon pre obe polia.