Objeto Database (TMSL)

  • Artigo

Aplica-se a: SQL Server 2016 e posteriores do Analysis Services Azure Analysis Services Fabric/Power BI Premium

Define um banco de dados tabular no nível de compatibilidade 1200 ou superior, com base em um modelo do mesmo nível. Este tópico documenta a definição de objeto de um banco de dados, fornecendo a carga para solicitações que criam, alteram, excluem e executam tarefas de gerenciamento de banco de dados.

Observação

Em qualquer script, apenas um banco de dados no momento pode ser referenciado. Para qualquer objeto diferente do próprio banco de dados, a propriedade Database será opcional se você especificar o modelo. Há um mapeamento um-para-um entre um Modelo e um Banco de Dados que pode ser usado para deduzir o nome do banco de dados se ele não for fornecido explicitamente.
Da mesma forma, você pode deixar de fora o Modelo, definindo suas propriedades no Banco de Dados.

Definição do objeto

Todos os objetos têm um conjunto comum de propriedades, incluindo nome, tipo, descrição, uma coleção de propriedades e anotações. Os objetos de banco de dados também têm as propriedades a seguir.

Compatibilitylevel Atualmente, os valores válidos são 1200, 1400. Níveis de compatibilidade mais baixos usam um mecanismo de metadados diferente.

Readwritemode Enumera o modo do banco de dados. É comum tornar um banco de dados somente leitura em configurações de alta disponibilidade ou escalabilidade. Os valores válidos incluem readWrite,
Readonly
ou readOnlyExclusive.

Uso

Objetos de banco de dados são usados em quase todos os comandos. Consulte Comandos na TMSL (Linguagem de Script de Modelo Tabular) para obter uma lista. Um objeto Database é um filho de um objeto Server.

Ao criar, substituir ou alterar um objeto de banco de dados, especifique todas as propriedades de leitura/gravação da definição do objeto. A omissão de uma propriedade de leitura/gravação é considerada uma exclusão.

Sintaxe parcial

Como essa definição de objeto é tão grande, apenas as propriedades diretas são listadas. O objeto Model fornece a maior parte da definição do banco de dados. Consulte Objeto Model (TMSL) para saber mais sobre como o objeto é definido.

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