Compartir a través de

Comando Delete (TMSL)

  • Artículo

Se aplica a: SQL Server 2016 y versiones posteriores Analysis Services Azure Analysis Services Fabric/Power BI Premium

Elimina una base de datos o un objeto de la base de datos actual. Elimina el objeto especificado y todos los objetos y colecciones secundarios. Si el objeto no existe, el comando genera un error.

Solicitud

El objeto que se va a eliminar se especifica mediante la ruta de acceso del objeto. Por ejemplo, para eliminar una partición es necesario especificar la tabla y los objetos de base de datos que lo preceden.

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

Puede eliminar los objetos siguientes:

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"  
    }   
  }   
}

Response

Devuelve un resultado vacío cuando el comando se realiza correctamente. De lo contrario, se devuelve una excepción XMLA.

Ejemplos

Ejemplo 1 : Eliminación de una base de datos.

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

Ejemplo 2 : Eliminación de una conexión.

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

Uso (puntos de conexión)

Este elemento de comando se usa en una instrucción de la llamada al método Execute (XMLA) a través de un punto de conexión XMLA, expuesto de las siguientes maneras:

  • Como ventana XMLA en SQL Server Management Studio (SSMS)

  • Como archivo de entrada para el cmdlet de PowerShell invoke-ascmd

  • Como entrada para una tarea de SSIS o un trabajo de Agente SQL Server

Puede generar un script listo para este comando desde SSMS. Por ejemplo, puede hacer clic con el botón derecho en una base de datos > existente Script Script>Database como>DELETE To.