Delen via


Door de gebruiker gedefinieerde DAX-functies (preview)

Opmerking

Door de gebruiker gedefinieerde DAX-functies zijn momenteel beschikbaar als preview-versie.

Met door de gebruiker gedefinieerde DAX-functies (Data Analysis Expressions) kunt u herbruikbare, geparameteriseerde DAX-logica verpakken in uw modellen, zodat uw DAX-code eenvoudiger kan worden geschreven, onderhouden en delen. In plaats van formules te herhalen tussen metingen, berekende kolommen en visuals, bieden UDF's flexibiliteit in programmeerstijl aan uw semantische modellen, zodat u functies eenmaal kunt definiëren en overal kunt gebruiken waar DAX wordt ondersteund. Zie door de gebruiker gedefinieerde DAX-functies voor meer informatie.

Waarom door de gebruiker gedefinieerde functies gebruiken?

  • Herbruikbaarheid en consistentie: Definieer één keer een berekening en gebruik deze overal opnieuw.
  • Onderhoudbaarheid: Werk logica op één plaats bij om de regels te herstellen of verder te ontwikkelen.
  • Veiliger ontwerpen: optionele typehints en typecontrolehelpers ondersteunen voorspelbare, foutbestendige code.
  • Eersteklas modelobjecten: UDF's leven in het model en kunnen worden weergegeven in Model explorer.

Get started

Probeer UDF's op de Desktop:

  1. Ga naar Opties > en instellingen > voor bestanden.
  2. Selecteer Preview-functies en controleer door de gebruiker gedefinieerde DAX-functies.
  3. Selecteer OK en start Power BI Desktop opnieuw.

Een functie definiëren

U kunt een door de gebruiker gedefinieerde functie definiëren in Power BI Desktop met behulp van de DAX-queryweergave (DQV) of de TMDL-weergave.

Algemene syntaxis

De algemene syntaxis voor een UDF is:

/// Optional description above the function
FUNCTION <FunctionName> = ( <ParameterName>: <ParameterType>, ... ) => <FunctionBody>

Voorbeeld: Eenvoudige belastingfunctie

Hier volgt een eenvoudig voorbeeld in DQV waarmee belasting wordt toegevoegd aan het opgegeven bedrag. U kunt ook User Defined Functions (UDF's) evalueren in Data Quality Visualizer (DQV).

DEFINE
    /// AddTax takes in amount and returns amount including tax
    FUNCTION AddTax = (
            amount : NUMERIC
        ) =>
        amount * 1.1

EVALUATE
{ AddTax ( 10 ) }
// Returns 11

Nadat een UDF is gedefinieerd, kunt u het model bijwerken of de codelens gebruiken om de functie toe te voegen aan uw model.

Schermopname van de DAX-queryweergave in Power BI Desktop, waarin twee locaties worden gemarkeerd waar u een door de gebruiker gedefinieerde functie kunt opslaan. De eerste is het updatemodel met de knop Wijzigingen boven aan de weergave. De tweede is een statusregel in de code-editor met het label Updatemodel: Nieuwe functie toevoegen.