É possível usar filtragem de eventos para controlar quais registros de um stream ou fila que o Lambda enviará para a função. Para obter informações gerais sobre como a filtragem de eventos funciona, consulte Controlar quais eventos o Lambda envia para a função.
Esta seção tem como foco a filtragem de eventos para as origens de eventos do Amazon MQ.
Noções básicas da filtragem de eventos do Amazon MQ
Suponha que sua fila de mensagens do Amazon MQ contenha mensagens em formato JSON válido ou como strings simples. Um exemplo de registro seria semelhante ao a seguir, com os dados convertidos em uma string codificada em Base64 no campo data.
{
"messageID": "ID:b-9bcfa592-423a-4942-879d-eb284b418fc8-1---mq---us-east-2.amazonaws.com.rproxy.goskope.com-37557-1234520418293-4:1:1:1:1",
"messageType": "jms/text-message",
"deliveryMode": 1,
"replyTo": null,
"type": null,
"expiration": "60000",
"priority": 1,
"correlationId": "myJMSCoID",
"redelivered": false,
"destination": {
"physicalName": "testQueue"
},
"data":"QUJDOkFBQUE=",
"timestamp": 1598827811958,
"brokerInTime": 1598827811958,
"brokerOutTime": 1598827811959,
"properties": {
"index": "1",
"doAlarm": "false",
"myCustomProperty": "value"
}
}Para os agentes Active MQ e Rabbit MQ, é possível usar a filtragem de eventos para filtrar registros usando a chave data. Suponha que a fila do Amazon MQ contenha mensagens no formato JSON a seguir.
{
"timeout": 0,
"IPAddress": "203.0.113.254"
}Para filtrar somente os registros onde o campo timeout é maior que 0, o objeto FilterCriteria seria como a seguir.
{
"Filters": [
{
"Pattern": "{ \"data\" : { \"timeout\" : [ { \"numeric\": [ \">\", 0] } } ] } }"
}
]
}Para maior clareza, aqui está o valor de Pattern do filtro expandido em JSON simples.
{
"data": {
"timeout": [ { "numeric": [ ">", 0 ] } ]
}
}É possível adicionar seu filtro usando o console, a AWS CLI ou um modelo do AWS SAM.
Para adicionar esse filtro usando o console, siga as instruções em Anexar critérios de filtro a um mapeamento de fonte de eventos (console) e insira a string a seguir em Critérios do filtro.
{ "data" : { "timeout" : [ { "numeric": [ ">", 0 ] } ] } }Com o Amazon MQ, você também pode filtrar registros onde a mensagem é uma string simples. Suponha que você queira processar somente registros onde a mensagem comece com “Resultado: ”. O objeto FilterCriteria seria como a seguir.
{
"Filters": [
{
"Pattern": "{ \"data\" : [ { \"prefix\": \"Result: \" } ] }"
}
]
}Para maior clareza, aqui está o valor de Pattern do filtro expandido em JSON simples.
{
"data": [
{
"prefix": "Result: "
}
]
}É possível adicionar seu filtro usando o console, a AWS CLI ou um modelo do AWS SAM.
Para adicionar esse filtro usando o console, siga as instruções em Anexar critérios de filtro a um mapeamento de fonte de eventos (console) e insira a string a seguir em Critérios do filtro.
{ "data" : [ { "prefix": "Result: " } ] }As mensagens do Amazon MQ devem ser strings codificadas em UTF-8, sejam em strings simples ou no formato JSON. Isso porque o Lambda decodifica as matrizes de bytes do Amazon MQ em UTF-8 antes de aplicar os critérios de filtragem. Se as mensagens usarem outra codificação, como UTF-16 ou ASCII, ou se o formato da mensagem não corresponder ao formato dos FilterCriteria, o Lambda processará somente os filtros de metadados. A tabela a seguir resume o comportamento específico:
| Formato do da mensagem recebida | Formato padrão de filtro para propriedades de mensagem | Ação resultante |
|---|---|---|
|
String simples |
String simples |
Filtros do Lambda com base em seus critérios de filtro. |
|
String simples |
Nenhum padrão de filtro para propriedades de dados |
Filtros do Lambda (somente nas outras propriedades de metadados) com base nos seus critérios de filtro. |
|
String simples |
JSON válido |
Filtros do Lambda (somente nas outras propriedades de metadados) com base nos seus critérios de filtro. |
|
JSON válido |
String simples |
Filtros do Lambda (somente nas outras propriedades de metadados) com base nos seus critérios de filtro. |
|
JSON válido |
Nenhum padrão de filtro para propriedades de dados |
Filtros do Lambda (somente nas outras propriedades de metadados) com base nos seus critérios de filtro. |
|
JSON válido |
JSON válido |
Filtros do Lambda com base em seus critérios de filtro. |
|
String não codificada em UTF-8 |
JSON, string de texto simples ou nenhum padrão |
Filtros do Lambda (somente nas outras propriedades de metadados) com base nos seus critérios de filtro. |
