Comando Delete (TMSL)

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

Elimina un database o un oggetto nel database corrente. Elimina l'oggetto specificato e tutti gli oggetti figlio e le raccolte. Se l'oggetto non esiste, il comando genera un errore.

Richiesta

L'oggetto da eliminare viene specificato utilizzando il percorso dell'oggetto. Ad esempio, per eliminare una partizione è necessario specificare la tabella e gli oggetti di database che la precedono.

{   
  "delete": {   
    "object": {   
      "database": "AdventureworksDW2016",   
      "table": "Reseller Sales",   
      "partition": "may2011"   
    }   
  }   
}   

È possibile eliminare gli oggetti seguenti:

Oggetto di database (TMSL)

{   
  "delete": {   
    "object": {   
      "database": "AdventureworksDW2016"  
    }   
  }   
}   

Oggetto DataSources (TMSL)

{  
  "delete": {  
    "object": {  
      "database": "AdventureworksDW2016",  
      "dataSource": "SqlServer localhost AdventureworksDW2016"  
    }  
  }  
}  

Oggetto Tables (TMSL)

{   
  "delete": {   
    "object": {   
      "database": "AdventureworksDW2016",   
      "table": "Reseller Sales",  
    }   
  }   
}   

Oggetto Partitions (TMSL)

{   
  "delete": {   
    "object": {   
      "database": "AdventureworksDW2016",   
      "table": "Reseller Sales",   
      "partition": "may2011"   
    }   
  }   
}   

Oggetto Roles (TMSL)

{   
  "delete": {   
    "object": {   
      "database": "AdventureworksDW2016",   
      "role": "Data Reader"  
    }   
  }   
}   

Risposta

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

Esempio

Esempio 1: eliminare un database.

{  
  "delete": {  
    "object": {  
      "database": "AdventureWorksDW2016"  
    }  
  }  
}  

Esempio 2: eliminare una connessione.

{  
  "delete": {  
    "object": {  
      "database": "AdventureWorksDW2016",  
      "dataSource": "SqlServer localhost AdventureworksDW2016"  
    }  
  }  
}  

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 di PowerShell invoke-ascmd

  • Come input per un'attività SSIS o un SQL Server Agent

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