Compartilhar via


Scripts TMDL

Os scripts TMDL permitem que você aplique uma ação a um modelo semântico, que pode ser uma alteração ou operação. Um script TMDL tem duas partes:

  • Um comando , que é necessário e deve ser declarado na parte superior do script TMDL.
  • Um ou mais objetos de modelo semântico usando a definição ou referência de linguagem TMDL.

Sintaxe:


<TMDL Command name>
  <TMDL object>
  [<TMDL object>]

Comando CreateOrReplace

Cria ou substitui os objetos de modelo semântico especificados e todos os descendentes. Os objetos existentes são substituídos por uma nova definição.

A ordem dos objetos TMDL dentro do comando createOrReplace não é importante.

A semântica da linguagem TMDL é aplicada a objetos no comando createOrReplace. Por exemplo, é possível dividir a definição de objeto em vários segmentos, no entanto, a mesma propriedade não pode ser declarada mais de uma vez. Você pode saber mais sobre a linguagem TMDL.

Exemplo

Crie ou substitua a medida # Produtos (por Vendas) da tabela Sales e a definição completa da tabela Product:

createOrReplace

  ref table Sales
    measure '# Products (with Sales)' = DISTINCTCOUNT('Sales'[ProductKey])
        formatString: #,##0
    
  table Product

    measure '# Products' = COUNTROWS('Product')
        formatString: #,##0

    column Product
        dataType: string
        isDefaultLabel
        summarizeBy: none
        sourceColumn: Product

    column Category
        dataType: string
        summarizeBy: none
        sourceColumn: Category

    partition Product-partition = m
        mode: import
        source =
                let
                    Source = #"RAW-Product",
                    #"Renamed Columns" = Table.RenameColumns(Source,{{"Product Name", "Product"}})
                in
                    #"Renamed Columns"

Considerações e limitações

Há suporte para apenas um verbo de comando por execução de script.

Os artigos a seguir descrevem mais sobre o TMDL e seus usos.