Comando Create (TMSL)

Articolo
12/23/2023

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

Crea l'oggetto specificato e tutti gli oggetti discendenti specificati. Se l'oggetto esiste già, il comando genera un errore.

Richiesta

La struttura della richiesta varia in base all'oggetto . Un oggetto padre deve includere tutti i relativi elementi figlio, anche se le definizioni complete di oggetti di pari livello e padre non sono necessarie.

Oggetto di database (TMSL) Aggiungere un database a un server.

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

Oggetto 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"  
        }  
      ]  
    }  
  }  
}

Oggetto Partitions (TMSL) Aggiungere una partizione a un oggetto tabella padre.

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

Oggetto Roles (TMSL) Aggiungere un ruolo a un database, ma senza appartenenza o filtri.

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

Ad eccezione dell'oggetto Database , l'oggetto creato è figlio di un elemento padreObject specificato. L'elemento padre dell'oggetto Database è sempre l'oggetto Server .

Si presuppone che il server proveni dal contesto. Ad esempio, se si esegue lo script da Management Studio o AMO PowerShell, la connessione server verrà specificata nella sessione o come parametro.

Risposta

Restituisce un risultato vuoto quando il comando ha esito positivo. In caso contrario, viene restituita un'eccezione XMLA.

Esempio

Esempio 1 : aggiungere un ruolo che specifica l'appartenenza e un 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')"  
            }  
         ]  
      }  
   }  
}

Utilizzo (endpoint)

Questo elemento di comando viene usato in un'istruzione della chiamata al metodo Execute (XMLA) su un endpoint XMLA, esposto nei modi seguenti:

Come finestra XMLA in SQL Server Management Studio (SSMS)
Come file di input per il cmdlet invoke-ascmd di PowerShell
Come input per un'attività SSIS o SQL Server Agent processo

È possibile generare uno script pronto per questo comando da SSMS. Ad esempio, è possibile fare clic con il pulsante destro del mouse su un databasedi script> di database > esistente come >CREA in .

Condividi tramite