Команда Delete (TMSL)

Статья
12/23/2023

Применимо к: SQL Server 2016 и более поздних версий Analysis Services Azure Analysis Services Fabric/Power BI Premium

Удаляет базу данных или объект в текущей базе данных. Он удаляет указанный объект и все дочерние объекты и коллекции. Если объект не существует, команда вызывает ошибку.

Запрос

Удаляемый объект указывается с помощью пути к объекту. Например, для удаления секции необходимо указать таблицу и объекты базы данных, которые предшествуют ей.

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

Можно удалить следующие объекты:

Объект Database (TMSL)

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

Объект DataSources (TMSL)

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

Объект Tables (TMSL)

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

Объект Partitions (TMSL)

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

Объект Roles (TMSL)

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

Ответ

Возвращает пустой результат при успешном выполнении команды. В противном случае возвращается исключение XMLA.

Примеры

Пример 1 . Удаление базы данных.

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

Пример 2 . Удаление подключения.

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

Использование (конечные точки)

Этот командный элемент используется в инструкции вызова метода Execute Method (XMLA) через конечную точку XMLA, которая предоставляется следующими способами:

Как окно XMLA в SQL Server Management Studio (SSMS)
В качестве входного файла командлета PowerShell invoke-ascmd
В качестве входных данных для задачи или задания агент SQL Server служб SSIS

Вы можете создать готовый скрипт для этой команды из SSMS. Например, можно щелкнуть правой кнопкой мыши существующую базу данных скрипта>базы данных> скрипта как >DELETE To.

Поделиться через