Freigeben über

Delete-Befehl (TMSL)

  • Artikel

Gilt für: SQL Server 2016 und höher Analysis Services Azure Analysis Services Fabric/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 Tabellen- und Datenbankobjekte angeben, die ihr vorangestellt sind.

{   
  "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 ist. 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 Aufrufs der Execute-Methode (XMLA) über einen XMLA-Endpunkt verwendet und auf folgende Weise verfügbar gemacht:

  • 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 SQL Server-Agent Auftrag

Sie können ein fertiges Skript für diesen Befehl von SSMS generieren. Sie können z. B. mit der rechten Maustaste auf eine vorhandeneSkriptdatenbank-Datenbank>> als >DELETE To klicken.