Comando Create (TMSL)

Artigo
12/23/2023

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

Cria o objeto especificado e todos os objetos descendentes especificados. Se o objeto já existir, o comando gerará um erro.

Solicitação

A estrutura da solicitação varia de acordo com o objeto . Um objeto que é um pai deve incluir todos os seus filhos, embora as definições completas de objeto de irmãos e pais não sejam necessárias.

Objeto database (TMSL) Adicione um banco de dados a um servidor.

{   
  "create": {   
    "database": {   
      "name": "AdventureworksDW2016",   
      "description": "<description>"   
    }   
  }   
}

Objeto DataSources (TMSL)

{  
  "create": {  
    "parentObject": {  
      "database": "AdventureworksDW2016"  
    },  
    "dataSource": {  
      "name": "SqlServer localhost AdventureworksDW2016",  
      "connectionString": "Provider=SQLNCLI11;Data Source=localhost;Initial Catalog=AdventureworksDW2016;Integrated Security=SSPI;Persist Security Info=false",  
      "impersonationMode": "impersonateAccount",  
      "account": "<account name>",  
      "annotations": [  
        {  
          "name": "ConnectionEditUISource",  
          "value": "SqlServer"  
        }  
      ]  
    }  
  }  
}

Objeto Partitions (TMSL) Adicione uma partição a um objeto de tabela pai.

{  
  "create": {  
    "parentObject": {  
      "database": "AdventureWorksTabular1200",  
      "table": "Date"  
    },  
    "partition": {  
      "name": "Date 2",  
      "source": {  
        "query": "SELECT [dbo].[DimDate].* FROM [dbo].[DimDate]",  
        "dataSource": "SqlServer localhost AdventureworksDW2016"  
      }  
    }  
  }  
}

Objeto Roles (TMSL) Adicione minimamente uma função a um banco de dados, mas sem associação ou filtros.

{  
  "create": {  
    "parentObject": {  
      "database": "AdventureWorksDW2016"  
    },  
    "role": {  
      "name": "DataReader",  
      "modelPermission": "read"  
    }  
  }  
}

Exceto para o objeto Database , o objeto que está sendo criado é filho de um parentObject especificado. O pai do objeto Database é sempre o objeto Server .

O servidor é assumido do contexto. Por exemplo, se você executar o script do Management Studio ou do AMO PowerShell, a conexão do servidor será especificada na sessão ou como um parâmetro.

Resposta

Retorna um resultado vazio quando o comando é bem-sucedido. Caso contrário, uma exceção XMLA será retornada.

Exemplos

Exemplo 1 – Adicionar uma função que especifica a associação e um filtro.

{   
   "create":{   
      "parentObject":{   
         "database":"AdventureWorksTabular1200"  
      },  
      "role":{  
         "name":"DataReader",  
         "modelPermission":"read",  
         "members":[   
            {  
               "memberName": "account-01",  
               "memberId":"S-1-5-21-1111111111-2222222222-33333333-444444"  
            },  
            {   
               "memberName": "account-02",  
               "memberId":"S-2-5-21-1111111111-2222222222-33333333-444444"  
            }  
         ],  
         "tablePermissions":[   
            {   
               "name":"Date",  
               "filterExpression":"CalendarYear('2011')"  
            }  
         ]  
      }  
   }  
}

Uso (pontos de extremidade)

Esse elemento de comando é usado em uma instrução da chamada do Método Execute (XMLA) em um ponto de extremidade XMLA, exposto das seguintes maneiras:

Como uma janela XMLA no SSMS (SQL Server Management Studio)
Como um arquivo de entrada para o cmdlet do PowerShell invoke-ascmd
Como uma entrada para uma tarefa do SSIS ou trabalho de SQL Server Agent

Você pode gerar um script pronto para esse comando do SSMS. Por exemplo, você pode clicar com o botão direito do mouse em um Banco de Dados script de banco dedados >> existentecomo>CREATE To.

Share via