Oggetto Database (TMSL)

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

Definisce un database tabulare a livello di compatibilità 1200 o superiore, in base a un modello dello stesso livello. In questo argomento viene illustrata la definizione dell'oggetto di un database, fornendo il payload per le richieste che creano, modificano, eliminano ed eseguono attività di gestione del database.

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. È disponibile un mapping uno-a-uno tra un modello e un database che può essere usato per dedurre il nome del database se non è specificato in modo esplicito.
Analogamente, è possibile uscire da Modello, 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 di database hanno anche le proprietà seguenti.

compatibilitàlevel Attualmente, i valori validi sono 1200, 1400. I livelli di compatibilità inferiori usano un motore di metadati diverso.

Readwritemode Enumera la modalità del database. È comune creare un database di sola lettura in configurazioni di disponibilità elevata o scalabilità. I valori validi includono readWrite,
Readonly
o readOnlyExclusive.

Utilizzo

Gli oggetti di database vengono usati in quasi ogni comando. Per un elenco, vedere Comandi in Tabular Model Scripting Language (TMSL). Un oggetto Database è figlio di un oggetto Server.

Durante la creazione, la sostituzione o la modifica di un oggetto di database, 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à dirette. L'oggetto Model fornisce la maggior parte della definizione del database. Vedere Oggetto Model (TMSL) per altre informazioni su come viene definito l'oggetto.

    "database": {  
      "type": "object",  
      "properties": {  
        "name": {  
          "type": "string"  
        },  
        "id": {  
          "type": "string"  
        },  
        "description": {  
          "type": "string"  
        },  
        "compatibilityLevel": {  
          "type": "integer"  
        },  
        "readWriteMode": {  
          "enum": [  
            "readWrite",  
            "readOnly",  
            "readOnlyExclusive"  
          ]  
        },  
        "model": {  
          "type": "object",  
          ...  
        }  
    }