Oggetto Model (TMSL)

  • Articolo

Si applica a: SQL Server 2016 e versioni successive di Analysis Services Azure Analysis Services Fabric/Power BI Premium

Definisce un modello tabulare. Esiste un modello per database e un solo database che può essere specificato in qualsiasi comando specificato. Un oggetto Database è l'oggetto padre.

Le definizioni dei modelli sono troppo grandi per riprodurre l'intera sintassi in un argomento. Per questo motivo, di seguito è riportata una sintassi parziale che evidenzia le parti principali, con collegamenti a oggetti figlio.

Forse il modo migliore per comprendere una definizione di modello consiste nell'iniziare con un modello tabulare ben noto. Usare l'opzione Visualizza codice in SQL Server Data Tools per visualizzarne la definizione. Ricordarsi di installare un editor JSON in modo che sia possibile visualizzare il codice. È possibile ottenere un editor JSON in Visual Studio scaricando l'edizione Community o un'altra edizione di Visual Studio.

Nota

In qualsiasi script è possibile fare riferimento a un solo database al momento. Per qualsiasi oggetto diverso dal database stesso, la proprietà Database è facoltativa se si specifica il modello. Esiste un mapping uno-a-uno tra un modello e un database che può essere usato per dedurre il nome del database se non viene specificato in modo esplicito.
Analogamente, è possibile escludere Model, impostandone le proprietà nel database.

Definizione dell'oggetto

Tutti gli oggetti hanno un set comune di proprietà, tra cui nome, tipo, descrizione, raccolta di proprietà e annotazioni. Gli oggetti modello hanno anche le proprietà seguenti.

Storagelocation
Percorso su disco in cui inserire il modello.

defaultMode
Il metodo predefinito per rendere disponibili i dati nella partizione.

defaultDataView
Per i modelli in modalità DirectQuery, questa proprietà determina le partizioni usate per eseguire query sul modello. I valori validi includono Full e Sample.

culture
Impostazioni cultura da utilizzare per la formattazione.

collation
La sequenza di regole di confronto.

tabelle
Raccolta completa di tabelle nel modello, incluse partizioni, colonne, misure, indicatori KPI e annotazioni. Per informazioni dettagliate, vedere l'oggetto Tables (TMSL).

relationships
Specifica la relazione tra ogni coppia di tabelle, incluse le proprietà che impostano la direzione e la sicurezza del filtro. Per informazioni dettagliate, vedere l'oggetto Relationships (TMSL).

Datasources
Una o più connessioni a database esterni che forniscono dati al modello o usati per le query pass-through. Per informazioni dettagliate, vedere Oggetto DataSources (TMSL).

Ruoli
Oggetti che associano un'autorizzazione di database, account membro e, facoltativamente, filtri di sicurezza in DAX per il controllo di accesso personalizzato.

Utilizzo

Gli oggetti modello contengono un intero modello. È necessario specificare un oggetto Model e/o il relativo oggetto Database padre nella maggior parte dei comandi.

Quando si crea, si sostituisce o si modifica un oggetto modello, specificare tutte le proprietà di lettura/scrittura della definizione dell'oggetto. L'omissione di una proprietà di lettura/scrittura viene considerata un'eliminazione.

Sintassi parziale

Poiché questa definizione di oggetto è così grande, vengono elencate solo le proprietà di primo livello. Per un elenco di oggetti figlio, vedere Definizioni di oggetti in TMSL (Tabular Model Scripting Language).

    "model": {  
      "description": "Model object of a tabular database",  
      "type": "object",  
      "properties": {  
          "name": {  },  
          "description": {  },  
         "storageLocation": {  },  
         "defaultMode":  {  },  
         "defaultDataView": {  },  
         "culture": {  },  
         "collation": {  },  
         "annotations": {  },  
         "tables": {  },  
         "relationships": {  },  
         "dataSources": {  },  
         "perspectives": {  },  
            "cultures": {  },  
         "roles": {  }  
    }