Compartilhar via


Elemento Cancel (XMLA)

Cancela um comando que está sendo executando atualmente em uma instância Microsoft SQL Server Analysis Services.

Sintaxe

<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 do elemento

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 as informações sobre as conexões e as sessões atuais de uma instância 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).

Consulte também

Referência

Elemento Batch (XMLA)

Conceitos

Commands (XMLA)