Elemento Cancel (XMLA)

Cancela um comando em execução no momento uma instância de Analysis Services.

Syntax

  
<Command>  
   <Cancel>  
      <ConnectionID>...</ConnectionID>  
      <SessionID>...</SessionID>  
      <SPID>...</SPID>  
      <CancelAssociated>...</CancelAssociated>  
   </Cancel>  
</Command>  

Características do elemento

Característica	Descrição
Comprimento e tipo de dados	Nenhum
Valor padrão	Nenhum
Cardinalidade	0-n: Elemento opcional que pode ocorrer mais de uma vez.

Relações de elementos

Relação	Elemento
Elementos pai	Comando
Elementos filho	CancelAssociated, ConnectionID, SessionID, SPID

Comentários

O comando Cancel cancela os comandos que estiverem sendo executados neste momento dentro do contexto de uma sessão. Se o aplicativo cliente não solicitou uma sessão, um comando não poderá ser cancelado.

Se o comando Cancel for executado durante a execução de um comando Batch , todo o comando Batch será cancelado. Se o comando Batch era transacional, todos os comandos contidos no comando Batch serão revertidos. Se o comando Batch era transacional, todos os comandos contidos no comando Batch que estiverem sendo executados no momento em que o comando Cancel foi executado serão revertidos. Os comandos não transacionais em um comando Batch que foram executados antes, não serão revertidos.

Normalmente, o comando Cancel é usado para cancelar os comandos que estiverem sendo executados no momento em que a sessão estiver ativa. Neste caso, nenhum dos elementos filho do comando Cancel deverão ser especificados. O comando Cancel também só pode ser usado pelos administradores para cancelar os comandos que estiverem sendo executados em conexões ou sessões que não estejam na sessão ativa naquele momento. Os membros de uma função com permissões de Administrador de um determinado banco de dados podem cancelar os comandos de conexões e sessões aplicáveis a esse banco de dados, enquanto que os administradores de servidor podem cancelar os comandos de conexões e sessões de uma determinada instância do Analysis Services.

Para recuperar informações sobre conexões e sessões atuais para uma instância de Analysis Services, o método Discover pode ser executado para solicitar, respectivamente, os conjuntos de linhas de esquema DISCOVER_CONNECTIONS e DISCOVER_SESSIONS. Os membros de uma função com permissões de Administrador de um determinado banco de dados só poderão retornar sessões do banco de dados se especificarem o banco de dados na coluna de restrição SESSION_CURRENT_DATABASE do conjunto de linhas de esquema DISCOVER_SESSIONS. Para obter mais informações sobre o método Discover , consulte método Discover (XMLA).