Delete, commande (TMSL)

  • Article

S’applique à : SQL Server 2016 et versions ultérieures Analysis Services Azure Analysis Services Fabric/Power BI Premium

Supprime une base de données ou un objet dans la base de données active. Il supprime l’objet spécifié et tous les objets et collections enfants. Si l’objet n’existe pas, la commande génère une erreur.

Requête

L’objet en cours de suppression est spécifié à l’aide du chemin d’accès de l’objet. Par exemple, la suppression d’une partition nécessite que vous spécifiiez les objets de table et de base de données qui la précèdent.

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

Vous pouvez supprimer les objets suivants :

Database, objet (TMSL)

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

DataSources, objet (TMSL)

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

Tables, objet (TMSL)

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

Partitions, objet (TMSL)

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

Roles, objet (TMSL)

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

response

Retourne un résultat vide lorsque la commande réussit. Sinon, une exception XMLA est retournée.

Exemples

Exemple 1 - Supprimer une base de données.

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

Exemple 2 - Supprimer une connexion.

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

Utilisation (points de terminaison)

Cet élément de commande est utilisé dans une instruction de l’appel de méthode d’exécution (XMLA) sur un point de terminaison XMLA, exposé de la manière suivante :

  • En tant que fenêtre XMLA dans SQL Server Management Studio (SSMS)

  • En tant que fichier d’entrée de l’applet de commande PowerShell invoke-ascmd

  • En tant qu’entrée pour une tâche SSIS ou SQL Server Agent travail

Vous pouvez générer un script prêt à l’être pour cette commande à partir de SSMS. Par exemple, vous pouvez cliquer avec le bouton droit sur une base de données existante scripter> unebase de données> en tant que >DELETE To.