Výrazy, hodnoty a výraz let

Dotaz jazyka vzorcov Power Query M pozostáva z krokov výrazu vzorca, ktoré vytvárajú dotaz mashup. Výraz vzorca možno vyhodnotiť (vypočítať) a získať výsledok v zadaní hodnoty. Výraz let obsahuje množinu vypočítavaných hodnôt, ktorým sa priradia názvy a ktoré sa potom použijú v následnom výraze, ktorý nasleduje po výraze in . Výraz let môže napríklad obsahovať premennú Source , ktorá sa rovná hodnote Text.Proper() a vráti textovú hodnotu s veľkými a veľkými písmenami.

Výraz Let

let
    Source = Text.Proper("hello world")
in
    Source

Vo vyššie uvedenom príklade sa výraz Text.Proper("hello world") vyhodnotí na výsledok Hello World.

Nasledujúce časti popisujú typy hodnôt v jazyku.

Primitívna hodnota

Primitívna hodnota je jednodielna hodnota, ako je napríklad číslo, logická hodnota, text alebo hodnota null. Hodnotu null možno použiť na označenie absencie akýchkoľvek údajov.

Typ	Ukážková hodnota
Binárne	00 00 00 02 // počet bodov (2)
Date	5/23/2015
Dátum a čas	23. 5. 2015 12:00:00
DateTimeZone (Dátum a časové pásmo)	23. 5. 2015 12:00:00 -08:00
Trvanie	15:35:00
Logické	true a false
Null	null
Číslo	0, 1, -1, 1.5 a 2.3e-5
Text	"abc"
Čas	12:34:12 PM (popoludní)

Hodnota funkcie

Funkcia je hodnota, ktorá pri vyvolaní s argumentmi vyprodukuje novú hodnotu. Funkcie sa píšu uvedením parametrov funkcie v zátvorkách, potom symbolu ide-to =>, za ktorým nasleduje výraz definujúci funkciu. Ak napríklad chcete vytvoriť funkciu s názvom MyFunction, ktorá má dva parametre a vykoná výpočet s parametrom1 a parametrom2:

let
    MyFunction = (parameter1, parameter2) => (parameter1 + parameter2) / 2
in
    MyFunction

Volanie funkcie MyFunction() vráti výsledok:

let
    Source = MyFunction(2, 4)
in
    Source

Tento kód vyprodukuje hodnotu 3.

Hodnoty štruktúrovaných údajov

Jazyk M podporuje nasledujúce hodnoty štruktúrovaných údajov:

• Zoznam

• Záznam

• Table

• Ďalšie príklady štruktúrovaných údajov

Poznámka

Štruktúrované údaje môžu obsahovať ľubovoľnú hodnotu jazyka M. Niekoľko príkladov si môžete pozrieť v časti Ďalšie príklady štruktúrovaných údajov.

List

Zoznam je zoradená postupnosť hodnôt založená na nule, ktorá je uzavretá v znakoch zložených zátvoriek { }. Znaky zložených zátvoriek { } sa tiež používajú na načítanie položky zo zoznamu podľa indexovej pozície. Pozrite si článok [Hodnota zoznamu](#_List_value).

Poznámka

Power Query M podporuje nekonečnú veľkosť zoznamu, ale ak je zoznam zapísaný ako literál, zoznam má pevnú dĺžku. Napríklad zoznam {1, 2, 3} má pevnú dĺžku 3.

Nižšie je uvedených niekoľko príkladov zoznamu .

Hodnota	Typ
{123, true, "A"}	Zoznam obsahujúci číslo, logickú hodnotu a text.
{1, 2, 3}	Zoznam čísel
{     {1, 2, 3},     {4, 5, 6} }	Zoznam zoznamov čísel
{     [CustomerID = 1, Name = "Bob", Telefón = "123-4567"],     [CustomerID = 2, Name = "Jim", Telefón = "987-6543"] }	Zoznam záznamov
{123, true, "A"}{0}	Načítanie hodnoty prvej položky v zozname. Tento výraz vráti hodnotu 123.
{     {1, 2, 3},     {4, 5, 6} }{0}{1}	Načítanie hodnoty druhej položky z prvého prvku Zoznam. Tento výraz vráti hodnotu 2.

Záznam

Záznam je množina polí. Pole je dvojica názov-hodnota, kde názov je textová hodnota, ktorá je v rámci záznamu danej poľa jedinečná. Syntax pre hodnoty záznamov umožňuje zápis názvov bez úvodzoviek. Ide o formu, ktorá sa označuje aj ako identifikátory. Identifikátor môže mať tieto dve formy:

• identifier_name napríklad ORDERID.

• #"názov identifikátora", napríklad #"Dnešné údaje: ".

V nasledujúcom texte je záznam obsahujúci polia s názvami OrderID, CustomerID, Item a Price s hodnotami 1, 1, "Fishing rod" a 100.00. Znaky hranatých zátvoriek [ ] označujú začiatok a koniec výrazu záznamu a používajú sa na načítanie hodnoty poľa zo záznamu. V nasledujúcich príkladoch je znázornený záznam a postup na načítanie hodnoty poľa Item.

Tu je príklad záznamu:

let Source =
        [
              OrderID = 1,
              CustomerID = 1,
              Item = "Fishing rod",
              Price = 100.00
        ]
in Source

Na načítanie hodnoty poľa Item sa použijú hranaté zátvorky ako Source[Item]:

let Source =
    [
          OrderID = 1,
          CustomerID = 1,
          Item = "Fishing rod",
          Price = 100.00
    ]
in Source[Item] //equals "Fishing rod"

Tabuľka

Tabuľka je množina hodnôt usporiadaných do pomenovaných stĺpcov a riadkov. Typ stĺpca môže byť implicitný alebo explicitný. Pomocou #table môžete vytvoriť zoznam názvov stĺpcov a zoznam riadkov. Tabuľka hodnôt je zoznam v zozname. Znaky zložených zátvoriek { } sa tiež používajú na načítanie riadka z tabuľky podľa indexovej pozície (prejdite na Príklad 3 – načítanie riadka z tabuľky podľa indexovej pozície).

Príklad 1 – vytvorenie tabuľky s implicitnými typmi stĺpcov

let
  Source = #table(
    {"OrderID", "CustomerID", "Item", "Price"},
      {
          {1, 1, "Fishing rod", 100.00},
          {2, 1, "1 lb. worms", 5.00}
      })
in
    Source

Príklad 2 – vytvorenie tabuľky s explicitnými typmi stĺpcov

let
    Source = #table(
    type table [OrderID = number, CustomerID = number, Item = text, Price = number],
        {
                {1, 1, "Fishing rod", 100.00},
             {2, 1, "1 lb. worms", 5.00}
        }
    )
in
    Source

Oba vyššie uvedené príklady vytvoria tabuľku s nasledujúcim tvarom:

OrderID	CustomerID	Položka	Cena
1	1	Fishing rod	100,00
2	1	1 lb. worms	5.00

Príklad 3 – načítanie riadka z tabuľky podľa indexovej pozície

let
    Source = #table(
    type table [OrderID = number, CustomerID = number, Item = text, Price = number],
        {
              {1, 1, "Fishing rod", 100.00},
              {2, 1, "1 lb. worms", 5.00}
         }
    )
in
    Source{1}

Tento výraz vráti nasledujúci záznam:

Pole	Hodnota
OrderID	2
ID zákazníka	1
Položku	1 lb. worms
Cena	5

Ďalšie príklady štruktúrovaných údajov

Štruktúrované údaje môžu obsahovať ľubovoľnú hodnotu jazyka M. Tu je niekoľko príkladov:

Príklad 1 – zoznam s hodnotami [Primitive](#_Primitive_value_1), [Function](#_Function_value) a [Record](#_Record_value)

let
    Source =
{
   1,
   "Bob",
   DateTime.ToText(DateTime.LocalNow(), "yyyy-MM-dd"),
   [OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0]
}
in
    Source

Vyhodnotenie tohto výrazu možno vizualizovať ako:

Príklad 2 – záznam obsahujúci primitívne hodnoty a vnorené záznamy

let
    Source = [CustomerID = 1, Name = "Bob", Phone = "123-4567", Orders =
        {
              [OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0],
            [OrderID = 2, CustomerID = 1, Item = "1 lb. worms", Price = 5.0]
        }]
in
    Source

Vyhodnotenie tohto výrazu možno vizualizovať ako:

Poznámka

Hoci mnohé hodnoty možno zapísať presne ako výraz, hodnota nie je výrazom. Napríklad výraz 1 sa vyhodnotí na hodnotu 1. Výraz 1 +1 sa vyhodnotí na hodnotu 2. Tento rozdiel je malý, ale dôležitý. Výrazy sú recepty na vyhodnotenie; hodnoty sú výsledky vyhodnotenia.

Výraz If

Výraz if vyberie medzi dvomi výrazmi na základe logickej podmienky. Napríklad:

if 2 > 1 then
    2 + 2
else
    1 + 1

Prvý výraz (2 + 2) sa vyberie, ak je logický výraz (2 > 1) pravdivý, a druhý výraz (1 + 1) sa vyberie, ak je nepravdivý. Vybratý výraz (v tomto prípade 2 + 2) sa vyhodnotí a bude výsledkom výrazu if (4).