Model-Objekt (TMSL)

  • Artikel

Gilt für: SQL Server 2016 und höher analysis Services Azure Analysis Services Fabric/Power BI Premium

Definiert ein tabellarisches Modell. Es gibt ein Modell pro Datenbank und nur eine Datenbank, die in einem beliebigen Befehl angegeben werden kann. Ein Database-Objekt ist das übergeordnete Objekt.

Modelldefinitionen sind zu groß, um die gesamte Syntax in einem Thema zu reproduzieren. Aus diesem Grund finden Sie unten eine partielle Syntax, die die Standard Teile hervor hebt, mit Links zu untergeordneten Objekten.

Vielleicht ist die beste Möglichkeit, eine Modelldefinition zu verstehen, wenn Sie mit einem tabellarischen Modell beginnen, das Sie gut kennen. Verwenden Sie die Option Code anzeigen in SQL Server Data Tools, um deren Definition anzuzeigen. Denken Sie daran, einen JSON-Editor zu installieren, damit Sie den Code anzeigen können. Sie können einen JSON-Editor in Visual Studio erhalten, indem Sie die Community Edition oder eine andere Edition von Visual Studio herunterladen.

Hinweis

In jedem Skript kann jeweils nur auf eine Datenbank verwiesen werden. Für jedes andere Objekt als die Datenbank selbst ist die Database-Eigenschaft optional, wenn Sie das Modell angeben. Es gibt eine 1:1-Zuordnung zwischen einem Modell und einer Datenbank, die verwendet werden kann, um den Datenbanknamen abzuleiten, wenn er nicht explizit bereitgestellt wird.
Ebenso können Sie Modell weglassen und dessen Eigenschaften für die Datenbank festlegen.

Objektdefinition

Alle Objekte verfügen über einen gemeinsamen Satz von Eigenschaften, einschließlich Name, Typ, Beschreibung, einer Eigenschaftenauflistung und Anmerkungen. Modellobjekte verfügen auch über die folgenden Eigenschaften.

storageLocation
Der Speicherort auf dem Datenträger, auf dem das Modell platziert werden soll.

defaultMode
Die Standardmethode zum Bereitstellen von Daten in der Partition.

defaultDataView
Für Modelle im DirectQuery-Modus bestimmt diese Eigenschaft, welche Partitionen zum Ausführen von Abfragen für das Modell verwendet werden. Gültige Werte sind Full und Sample.

culture
Die Kultur, die für die Formatierung verwendet werden soll.

collation
Die Sortierreihenfolge.

Tabellen
Die vollständige Auflistung von Tabellen im Modell, einschließlich Partitionen, Spalten, Measures, KPIs und Anmerkungen. Weitere Informationen finden Sie unter Tables-Objekt (TMSL).

relationships
Gibt die Beziehung zwischen den einzelnen Tabellenpaaren an, einschließlich Eigenschaften, die die Filterrichtung und Die Sicherheit festlegen. Weitere Informationen finden Sie unter Relationships-Objekt (TMSL).

dataSources
Eine oder mehrere Verbindungen mit externen Datenbanken, die Daten für das Modell bereitstellen oder für passthrough-Abfragen verwendet werden. Weitere Informationen finden Sie unter DataSources-Objekt (TMSL).

roles
Objekte, die eine Datenbankberechtigung, Mitgliedskonten und optional Sicherheitsfilter in DAX für die benutzerdefinierte Zugriffssteuerung zuordnen.

Verbrauch

Modellobjekte enthalten ein gesamtes Modell. Sie müssen in den meisten Befehlen entweder ein Model- und/oder sein übergeordnetes Database-Objekt angeben.

Geben Sie beim Erstellen, Ersetzen oder Ändern eines Modellobjekts alle Lese-/Schreibeigenschaften der Objektdefinition an. Das Weglassen einer Eigenschaft mit Lese-/Schreibzugriff wird als Löschvorgang betrachtet.

Partielle Syntax

Da diese Objektdefinition so groß ist, werden nur die Eigenschaften der ersten Ebene aufgeführt. Eine Liste der untergeordneten Objekte finden Sie unter Objektdefinitionen in der Skriptsprache für tabellarische Modelle (TMSL).

    "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": {  }  
    }