ALTER QUEUE (Transact-SQL)

  • Artigo

Altera as propriedades de uma fila.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

ALTER QUEUE <object> WITH
   [ STATUS = { ON | OFF } [ , ] ]
   [ RETENTION = { ON | OFF } [ , ] ]
   [ ACTIVATION (
       { [ STATUS = { ON | OFF } [ , ] ] 
         [ PROCEDURE_NAME = <procedure> [ , ] ]
         [ MAX_QUEUE_READERS = max_readers [ , ] ]
         [ EXECUTE AS { SELF | 'user_name'  | OWNER } ]
       |  DROP }
          ) [ , ]]
         [ POISON_MESSAGE_HANDLING (
          STATUS = { ON | OFF } )
         ] 
  [ ; ]

<object> ::=
{
    [ database_name. [ schema_name ] . | schema_name. ]
        queue_name
} 

<procedure> ::=
{
    [ database_name. [ schema_name ] . | schema_name. ]
        stored_procedure_name
}

Argumentos

  • database_name (objeto)
    É o nome do banco de dados que contém a fila a ser alterada. Quando nenhum database_name é fornecido, o banco de dados atual é assumido como padrão.

  • schema_name (objeto)
    É o nome do esquema ao qual a nova fila pertence. Quando nenhum schema_name é fornecido, o esquema padrão para o usuário atual é assumido como padrão.

  • queue_name
    É o nome da fila a ser alterada.

  • STATUS (Fila)
    Especifica se a fila está disponível (ON) ou não está disponível (OFF). Quando a fila estiver indisponível, nenhuma mensagem poderá ser adicionada a ela ou removida dela.

  • RETENTION
    Especifica a configuração de retenção para a fila. Se RETENTION = ON, todas as mensagens enviadas ou recebidas em conversas usando essa fila serão mantidas na fila até que as conversas tenham terminado. Isso permite manter as mensagens para fins de auditoria ou executar transações de compensação se ocorrer um erro.

    ObservaçãoObservação

    Definir RETENÇÃO = ON pode reduzir o desempenho. Essa configuração deve ser usada somente se for necessária para atender ao contrato de nível de serviço para o aplicativo.

  • ACTIVATION
    Especifica as informações sobre o procedimento armazenado que é ativado ao processar as mensagens que chegam nessa fila.

  • STATUS (Ativação)
    Especifica se a fila ativa ou não o procedimento armazenado. Quando o STATUS = ON, a fila iniciará o procedimento armazenado especificado com PROCEDURE_NAME se o número de procedimentos atualmente executados for menor que MAS_QUEUE_READERS e se as mensagens chegarem à fila mais rápido do que as mensagens recebidas pelos procedimentos armazenados. Quando o STATUS = OFF, a fila não ativa o procedimento armazenado.

  • PROCEDURE_NAME = <procedimento>
    Especifica o nome do procedimento armazenado a ser ativado quando a fila contiver mensagens a serem processadas. Esse valor deve ser um identificador do SQL Server.

  • database_name (procedimento)
    É o nome do banco de dados que contém o procedimento armazenado.

  • schema_name (procedimento)
    É o nome do esquema que é proprietário do procedimento armazenado.

  • stored_procedure_name
    É o nome do procedimento armazenado.

  • MAX_QUEUE_READERS =max_reader
    Especifica o número máximo de instâncias do procedimento armazenado de ativação que a fila inicia simultaneamente. O valor de max_readers deve ser um número entre 0 e 32767.

  • EXECUTE AS
    Especifica a conta do usuário do banco de dados do SQL Server sob a qual é executado o procedimento armazenado de ativação. O SQL Server deve poder verificar as permissões deste usuário no momento em que a fila ativa o procedimento armazenado. Para um usuário de domínio do Windows, o SQL Server deve estar conectado ao domínio e ser capaz de validar as permissões do usuário especificado quando o procedimento for iniciado, caso contrário, a ativação falhará. Para um usuário do SQL Server, o servidor sempre pode verificar as permissões.

  • SELF
    Especifica que o procedimento armazenado é executado como o usuário atual. (O principal do banco de dados que executa essa instrução ALTER QUEUE.)

  • 'user_name'
    É o nome do usuário com o qual o procedimento armazenado é executado. user_name deve ser um usuário válido do SQL Server especificado como um identificador do SQL Server. O usuário atual que ter permissão IMPERSONATE para o user_name especificado.

  • OWNER
    Especifica que o procedimento armazenado é executado como o proprietário da fila.

  • DROP
    Exclui todas as informações de ativação associadas à fila.

  • POISON_MESSAGE_HANDLING
    Especifica se a manipulação de mensagens suspeitas está habilitada. O padrão é ON.

    A fila que tiver a manipulação de mensagens suspeitas definida como OFF, não será desabilitada após cinco reversões consecutivas de transações. Isso permite que um sistema personalizado de manipulação de mensagens suspeitas seja definido pelo aplicativo.

Comentários

Quando uma fila com um procedimento armazenado de ativação especificado tiver mensagens, a alteração do status de ativação de OFF para ON ativa imediatamente o procedimento armazenado de ativação. A alteração do status de ativação de ON para OFF faz o Broker parar de ativar instâncias do procedimento armazenado, mas não interrompe as instâncias do procedimento armazenado em execução atualmente.

A alteração de uma fila para adicionar um procedimento armazenado de ativação não altera o status de ativação da fila. A alteração do procedimento armazenado de ativação para a fila não afeta as instâncias do procedimento armazenado de ativação em execução atualmente.

O Service Broker verifica o número máximo de leitores de fila para uma fila como parte do processo de ativação. Portanto, alterar uma fila para aumentar o número de máximo de leitores de fila permite que o Service Broker inicie imediatamente mais instâncias do procedimento armazenado de ativação. A alteração de uma fila para diminuir o número de máximo de leitores de fila não afeta as instâncias do procedimento armazenado de ativação em execução atualmente. Entretanto, o Service Broker não inicia uma nova instância do procedimento armazenado até que o número de instâncias para o procedimento armazenado de ativação seja menor que o número máximo configurado.

Quando uma fila não está disponível, o Service Broker mantém as mensagens para os serviços que usam a fila na transmissão para o banco de dados. A exibição do catálogo sys.transmission_queue fornece uma exibição da fila de transmissão.

Se uma instrução RECEIVE ou GET CONVERSATION GROUP especificar uma fila não disponível, ela falhará com um erro Transact-SQL.

Permissões

A permissão para alterar uma fila assume como padrão o proprietário da fila, os membros das funções de banco de dados fixas db_ddladmin ou db_owner e os membros da função de servidor fixa sysadmin.

Exemplos

A.Tornando uma fila não disponível

O exemplo a seguir torna a fila ExpenseQueue não disponível para receber mensagens.

ALTER QUEUE ExpenseQueue WITH STATUS = OFF ;

B.Alterando o procedimento armazenado de ativação

O exemplo a seguir altera o procedimento armazenado que a fila inicia. O procedimento armazenado é executado como o usuário que executou a instrução ALTER QUEUE.

ALTER QUEUE ExpenseQueue
    WITH ACTIVATION (
        PROCEDURE_NAME = new_stored_proc,
        EXECUTE AS SELF) ;

C.Alterando o número de leitores da fila

O exemplo a seguir define como 7 o número máximo de instâncias de procedimento armazenado que o Service Broker inicia para essa fila.

ALTER QUEUE ExpenseQueue WITH ACTIVATION (MAX_QUEUE_READERS = 7) ;

D.Alterando o procedimento armazenado de ativação e a conta EXECUTE AS

O exemplo a seguir altera o procedimento armazenado que o Service Broker inicia. O procedimento armazenado é executado como o usuário SecurityAccount.

ALTER QUEUE ExpenseQueue
    WITH ACTIVATION (
        PROCEDURE_NAME = AdventureWorks2012.dbo.new_stored_proc ,
        EXECUTE AS 'SecurityAccount') ;

E.Definindo a fila para reter mensagens

O exemplo a seguir define a fila para reter mensagens. A fila retém todas as mensagens enviadas para ou dos serviços que a utilizam, até terminar a conversa que contém a mensagem.

ALTER QUEUE ExpenseQueue WITH RETENTION = ON ;

F.Removendo a ativação de uma fila

O exemplo a seguir remove todas as informações de ativação da fila.

ALTER QUEUE ExpenseQueue WITH ACTIVATION (DROP) ;

Consulte também

Referência

CREATE QUEUE (Transact-SQL)

DROP QUEUE (Transact-SQL)

EVENTDATA (Transact-SQL)