Habilitar sessões de mensagem para uma fila ou uma assinatura do Barramento de Serviço do Azure

As sessões do Barramento de Serviço do Azure permitem o tratamento conjunto e ordenado de sequências não associadas de mensagens relacionadas. As sessões podem ser usadas em padrões FIFO (first in, first out) e solicitação-resposta. Para obter mais informações, confira Sessões de mensagem. Este artigo mostra diferentes maneiras de habilitar sessões para uma fila ou assinatura do Barramento de Serviço.

Importante

  • A camada básica do Barramento de Serviço não dá suporte a sessões. As camadas standard e premium dão suporte a sessões. Para conferir as diferenças entre essas camadas, consulte Preços do Barramento de Serviço.
  • Você não pode habilitar ou desabilitar sessões de mensagem após a criação da fila ou assinatura. Você só pode fazer isso no momento da criação da fila ou assinatura.

Usando o portal do Azure

Ao criar uma fila no portal do Azure, selecione Habilitar sessões , conforme mostrado na imagem a seguir.

Habilitar a sessão no momento da criação da fila

Ao criar uma assinatura para um tópico no portal do Azure, selecione Habilitar sessões , conforme mostrado na imagem a seguir.

Habilitar sessão no momento da criação da assinatura

Usando a CLI do Azure

Para criar uma fila com sessões de mensagem habilitadas, use o az servicebus queue create comando com --enable-session definido como true.

az servicebus queue create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --name myqueue \
    --enable-session true

Para criar uma assinatura para um tópico com sessões de mensagem habilitadas, use o comando az servicebus topic subscription create com --enable-session definido como true.

az servicebus topic subscription create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --topic-name mytopic \
    --name mysubscription \
    --enable-session true

Usando o PowerShell do Azure

Para criar uma fila com sessões de mensagem habilitadas, use o New-AzServiceBusQueue comando com -RequiresSession definido como $True.

New-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -QueueName myqueue `
    -RequiresSession $True

Para criar uma assinatura para um tópico com sessões de mensagem habilitadas, use o comando New-AzServiceBusSubscription com -RequiresSession definido como true.

New-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -TopicName mytopic `
    -SubscriptionName mysubscription `
    -RequiresSession $True

Usar um modelo

Para criar uma fila com sessões de mensagens habilitadas, defina requiresSession como true na seção de propriedades da fila. Para obter mais informações, confira Referência de modelo de namespaces/filas do Microsoft.ServiceBus.

@description('Name of the Service Bus namespace')
param serviceBusNamespaceName string

@description('Name of the Queue')
param serviceBusQueueName string

@description('Location for all resources.')
param location string = resourceGroup().location

resource serviceBusNamespace 'Microsoft.ServiceBus/namespaces@2024-01-01' = {
  name: serviceBusNamespaceName
  location: location
  sku: {
    name: 'Standard'
  }

  resource queue 'queues' = {
    name: serviceBusQueueName
    properties: {
      requiresSession: true
    }
  }
}

Para criar uma assinatura para um tópico com sessões de mensagem habilitadas, defina requiresSessiontrue na seção propriedades da assinatura. Para obter mais informações, consulte modelo de referência de namespaces/tópicos/assinaturas do Microsoft.ServiceBus.

@description('Name of the Service Bus namespace')
param serviceBusNamespaceName string

@description('Name of the Topic')
param serviceBusTopicName string

@description('Name of the Subscription')
param serviceBusSubscriptionName string

@description('Location for all resources.')
param location string = resourceGroup().location

resource serviceBusNamespace 'Microsoft.ServiceBus/namespaces@2024-01-01' = {
  name: serviceBusNamespaceName
  location: location
  sku: {
    name: 'Standard'
  }

  resource topic 'topics' = {
    name: serviceBusTopicName
    properties: {
      maxSizeInMegabytes: 1024
    }

    resource subscription 'subscriptions' = {
      name: serviceBusSubscriptionName
      properties: {
        requiresSession: true
      }
    }
  }
}

Próximas etapas

Experimente os exemplos no idioma de sua escolha para explorar os recursos do Barramento de Serviço do Azure.

  • Última atualização em