Usługa Azure Event Hubs jako miejsce docelowe programu obsługi w subskrypcjach w tematach przestrzeni nazw usługi Azure Event Grid (wersja zapoznawcza)

Artykuł
02/22/2024

Procedura obsługi zdarzeń to miejsce, w którym jest wysyłane zdarzenie. Procedura obsługi wykonuje akcję w celu przetworzenia zdarzenia. Obecnie usługa Azure Event Hubs jest jedyną procedurą obsługi obsługiwaną jako miejsce docelowe dla subskrypcji w tematach przestrzeni nazw.

Użyj usługi Event Hubs , gdy rozwiązanie pobiera zdarzenia z usługi Event Grid szybciej niż może przetwarzać zdarzenia. Gdy zdarzenia znajdują się w centrum zdarzeń, aplikacja może przetwarzać zdarzenia z centrum zdarzeń zgodnie z własnym harmonogramem. Przetwarzanie zdarzeń można skalować w celu obsługi zdarzeń przychodzących.

Ważne

Ta funkcja jest obecnie dostępna w wersji zapoznawczej.

Nagłówki komunikatów

Poniżej przedstawiono właściwości odbierane w nagłówku zdarzenia lub komunikatu wysyłanego do usługi Event Hubs:

Nazwa właściwości	Opis
`aeg-subscription-name`	Nazwa subskrypcji zdarzeń.
`aeg-delivery-count`	Liczba prób wykonanych dla zdarzenia.
`aeg-output-event-id`	Identyfikator zdarzenia wygenerowanego przez system.
`aeg-compatibility-mode-enabled`	Ta właściwość jest dostępna i ustawiana tylko podczas dostarczania za pośrednictwem przestrzeni nazw usługi Event Grid. Obecnie jedyną możliwą wartością jest fałsz. Ma to na celu ułatwienie procedur obsługi zdarzeń rozróżniania zdarzeń dostarczanych za pośrednictwem przestrzeni nazw usługi Event Grid, a niestandardowych tematów usługi Event Grid/tematów systemowych/przestrzeni nazw partnerów itp.
`aeg-metadata-version`	Wersja metadanych zdarzenia. Reprezentuje wersję specyfikacji schematu zdarzeń w chmurze.

Przykłady rest

Subskrypcja zdarzeń z usługą Event Hubs jako program obsługi zdarzeń przy użyciu tożsamości przypisanej przez system

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "SystemAssigned"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

Subskrypcja zdarzeń z usługą Event Hubs jako procedura obsługi zdarzeń przy użyciu tożsamości przypisanej przez użytkownika

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

Subskrypcja zdarzeń z miejscem docelowym deadletter skonfigurowanym w programie obsługi zdarzeń usługi Event Hubs

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        },
        "deadLetterDestinationWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "deadLetterDestination": {
            "endpointType": "StorageBlob",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.Storage/storageAccounts/{storage-account-name}",
              "blobContainerName": "{blob-container-name}"
            }
          }
        }
      }
    }
  }
}

Subskrypcja zdarzeń z właściwościami dostarczania skonfigurowanymi w programie obsługi zdarzeń usługi Event Hubs

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "SystemAssigned"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}",
              "deliveryAttributeMappings": [
                {
                  "name": "somestaticname",
                  "type": "Static",
                  "properties": {
                    "value": "somestaticvalue"
                  }
                },
                {
                  "name": "somedynamicname",
                  "type": "Dynamic",
                  "properties": {
                    "sourceField": "subject"
                  }
                }
              ]
            }
          }
        }
      }
    }
  }
}

Właściwości dostarczania specyficzne dla usługi Event Hubs

Subskrypcje zdarzeń umożliwiają konfigurowanie nagłówków HTTP uwzględnionych w dostarczanych zdarzeniach. Ta funkcja umożliwia ustawienie niestandardowych nagłówków, których wymaga miejsce docelowe. Możesz ustawić nagłówki niestandardowe dla zdarzeń dostarczanych do usługi Azure Event Hubs.

Jeśli chcesz opublikować zdarzenia w określonej partycji w centrum zdarzeń, ustaw PartitionKey właściwość w subskrypcji zdarzeń, aby określić klucz partycji identyfikujący docelową partycję centrum zdarzeń.

Nazwa nagłówka	Typ nagłówka
`PartitionKey`	Tryb statyczny lub dynamiczny

Aby uzyskać więcej informacji, zobacz Niestandardowe właściwości dostarczania w przestrzeniach nazw.

Azure Portal

Podczas tworzenia subskrypcji zdarzeń z trybem dostarczania zdarzeń ustawionym na wartość Wypychanie możesz wybrać usługę Event Hubs jako typ procedury obsługi zdarzeń i skonfigurować centrum zdarzeń jako procedurę obsługi.

Aby uzyskać instrukcje krok po kroku, zobacz Use Event Hubs a destination for namespace topics (Używanie usługi Event Hubs jako miejsca docelowego dla tematów przestrzeni nazw).

Interfejs wiersza polecenia platformy Azure

Aby uzyskać instrukcje krok po kroku, zobacz Konfigurowanie usługi Event Hubs jako miejsca docelowego.

Następne kroki

Dostarczanie wypychane przestrzeni nazw usługi Event Grid.

Share via