Comando Delete (TMSL)

Artigo
12/23/2023

Aplica-se a: SQL Server 2016 e posteriores do Analysis Services Azure Analysis Services Fabric/Power BI Premium

Exclui um banco de dados ou um objeto no banco de dados atual. Ele exclui o objeto especificado e todos os objetos e coleções filho. Se o objeto não existir, o comando gerará um erro.

Solicitação

O objeto que está sendo excluído é especificado usando o caminho do objeto. Por exemplo, excluir uma partição requer que você especifique a tabela e os objetos de banco de dados que a precedem.

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

Você pode excluir os seguintes objetos:

Objeto Database (TMSL)

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

Objeto DataSources (TMSL)

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

Objeto Tables (TMSL)

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

Objeto Partitions (TMSL)

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

Objeto Roles (TMSL)

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

Resposta

Retorna um resultado vazio quando o comando é bem-sucedido. Caso contrário, uma exceção XMLA será retornada.

Exemplos

Exemplo 1 – Excluir um banco de dados.

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

Exemplo 2 – Excluir uma conexão.

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

Uso (pontos de extremidade)

Esse elemento de comando é usado em uma instrução da chamada do Método Execute (XMLA) em um ponto de extremidade XMLA, exposto das seguintes maneiras:

Como uma janela XMLA no SSMS (SQL Server Management Studio)
Como um arquivo de entrada para o cmdlet do PowerShell invoke-ascmd
Como uma entrada para uma tarefa do SSIS ou trabalho de SQL Server Agent

Você pode gerar um script pronto para esse comando do SSMS. Por exemplo, você pode clicar com o botão direito do mouse emum Banco de Dados script de banco de dados >> existentecomo>DELETE To.

Partilhar via