Delete-Befehl (TMSL)

  • Artikel
  • 2 Minuten Lesedauer

Gilt für: SQL Server 2016 und höher Analysis Services Azure Analysis Services Power BI Premium

Löscht eine Datenbank oder ein Objekt in der aktuellen Datenbank. Es löscht das angegebene Objekt und alle untergeordneten Objekte und Auflistungen. Wenn das Objekt nicht vorhanden ist, löst der Befehl einen Fehler aus.

Anforderung

Das zu löschende Objekt wird mithilfe des Objektpfads angegeben. Zum Löschen einer Partition müssen Sie z. B. die Tabelle und die Datenbankobjekte angeben, die ihr vorangehenden.

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

Sie können die folgenden Objekte löschen:

Datenbankobjekt (TMSL)

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

DataSources-Objekt (TMSL)

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

Tables-Objekt (TMSL)

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

Partitions-Objekt (TMSL)

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

Roles-Objekt (TMSL)

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

Antwort

Gibt ein leeres Ergebnis zurück, wenn der Befehl erfolgreich ausgeführt wird. Andernfalls wird eine XMLA-Ausnahme zurückgegeben.

Beispiele

Beispiel 1: Löschen einer Datenbank.

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

Beispiel 2 : Löschen einer Verbindung.

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

Verwendung (Endpunkte)

Dieses Befehlselement wird in einer Anweisung des XMLA-Aufrufs (Execute Method) über einen XMLA-Endpunkt verwendet, der auf folgende Weise verfügbar gemacht wird:

  • Als XMLA-Fenster in SQL Server Management Studio (SSMS)

  • Als Eingabedatei für das PowerShell-Cmdlet invoke-ascmd

  • Als Eingabe für einen SSIS-Task oder einen SQL Server-Agent Auftrag

Sie können ein vorgefertigte Skript für diesen Befehl aus dem SSMS. Sie können z. B. mit der rechten Maustaste auf eine vorhandene >DatenbankscriptScript-Datenbank>>alsDELETE In klicken.