Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Tipi di contenuto supportati: JSON, Avro, Protobuf e byte raw
PutRawEventsaccetta qualsiasi byte. Ogni voce SystemMetadata.ContentType indica EventBridge quali sono i byte. Questo valore decide se EventBridge deserializzare il payload prima che filtri e fornisca l'evento. Per Avro e Protobuf, EventBridge deserializza il payload rispetto a un registro dello schema indicato nella richiesta. Gli abbonati quindi filtrano, trasformano e ricevono l'evento come JSON. Per i byte opachi, EventBridge fornisce il payload intatto.
ContentType |
Cosa fa con il payload EventBridge | Registro degli schemi |
|---|---|---|
application/json |
Filtra e trasforma il contenuto JSON | Non utilizzato |
application/avro |
Deserializza il binario Avro in JSON, quindi filtra e trasforma in base a quel JSON | Richiesto |
application/protobuf |
Deserializza il binario Protobuf in JSON, quindi filtra e trasforma in base a quel JSON | Richiesto |
application/octet-stream |
Non deserializza né ispeziona il payload. Fornisce i byte così come sono stati inviati | Non utilizzato |
Come EventBridge deserializza un payload
Quando quella di una voce ContentType è application/avro oapplication/protobuf, EventBridge esegue i seguenti passaggi per quella voce.
-
EventBridge legge l'identificatore dello schema che il serializzatore del registro ha scritto nei byte del payload.
-
EventBridge recupera lo schema corrispondente dal registro in cui si nomina e deserializza il payload in JSON
SchemaRegistryConfiguration.RegistryUri. Se EventBridge non riesce a trovare o leggere lo schema o a deserializzare il payload in base ad esso, la voce ha esito negativo e viene generato un errore per ogni immissione. Le altre voci della richiesta rimangono invariate. -
Se un sottoscrittore definisce i filtri, li EventBridge valuta rispetto al codice JSON deserializzato.
-
EventBridge applica la trasformazione del sottoscrittore al JSON deserializzato e consegna JSON alla destinazione.
Assegna un nome al registro a ogni richiesta, in. PutRawEvents SchemaRegistryConfiguration.RegistryUri L'impostazione appartiene alla richiesta, non al bus, e la EventBridge ignora per le voci JSON nella stessa richiesta. EventBridge legge il registro con le credenziali del chiamante, quindi l'identità che pubblica richiede l'accesso in lettura al registro.
Dopo la deserializzazione, l'evento si comporta come qualsiasi evento JSON pubblicato con. PutRawEvents Un filtro con un ambito DATA corrisponde ai campi del record deserializzato in base ai nomi degli schemi. Un trasformatore JSonata li indirizza sotto $events.Data e un target riceve JSON. EventBridge imposta anche tre chiavi nella confezione fornita. SystemMetadata
-
aws:SchemaId: l'identificatore dello schema EventBridge deserializzato con; un UUID per Glue, un numero intero per AWS Confluent. -
aws:RegistryType: il registro che ha decodificato l'evento, oppure.GlueConfluentEventi pubblicati conPutEventsnever carry it. -
ContentType: il tipo di contenuto della voce pubblicata, ad esempioapplication/avro.
Scelta della modalità EventBridge di distribuzione del payload
ContentTypeseleziona uno dei due percorsi di consegna.
-
Deserializza in JSON. Impostato su
ContentTypeo.application/avroapplication/protobufEventBridge deserializza il payload rispetto al registro degli schemi e gli abbonati filtrano, si trasformano conDATAJSONata e ricevono JSON. Utilizzate questo percorso quando desiderate il routing e il rimodellamento basati sui contenuti degli eventi codificati dallo schema. -
Fornisci byte intatti. Impostato su.
ContentTypeapplication/octet-streamEventBridge non deserializza né ispeziona il payload, non è coinvolto alcun registro degli schemi e il sottoscrittore riceve i byte esatti che hai inviato. Utilizzate questo percorso quando deserializzate voi stessi il payload sulla destinazione o quando il contenuto è un formato non deserializzato. EventBridge
Deserializzazione con AWS Glue Schema Registry
RegistryUriImpostato sull'ARN del registro, del modulo. arn:aws:glue: Prima della pubblicazione, codifica il payload con il serializzatore AWS Glue Schema Registry per la tua lingua. Il serializzatore incorpora il riferimento allo schema EventBridge utilizzato per risolvere e deserializzare l'evento.region:account-id:registry/name
EventBridge legge lo schema come chiamante di pubblicazione, quindi concedi all'identità di pubblicazione l'accesso in lettura al registro e ai relativi schemi. La seguente politica concede l'autorizzazione minima, limitata a un registro.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "glue:GetSchemaVersion", "Resource": [ "arn:aws:glue:us-east-1:111122223333:registry/orders", "arn:aws:glue:us-east-1:111122223333:schema/orders/*" ] } ] }
Pubblica i byte codificati dallo schema con l'ARN del registro Glue in. RegistryUri
aws eventsv2 put-raw-events \ --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --schema-registry-configuration RegistryUri=arn:aws:glue:us-east-1:111122223333:registry/orders \ --entries '[ { "Data": "base64-encoded-avro-bytes", "SystemMetadata": { "ContentType": "application/avro", "EventGroupId": "order-1001" } } ]'
Un abbonato filtra quindi in base al record deserializzato. Se lo schema Avro ha un campo denominatoorderId, il seguente filtro corrisponde a un ordine.
{ "Scope": "DATA", "Pattern": "{\"orderId\":[\"1001\"]}" }
Deserializzazione con un registro di schemi confluenti
Imposta sull'RegistryUriURL HTTPS del registro. Un registro HTTPS richiede SchemaRegistryConfiguration.ConfluentPublicRegistryConfiguration.ConnectionArn anche l'ARN di una EventBridge connessione che contiene la chiave API del registro o le credenziali OAuth. La connessione deve appartenere all'account chiamante; una connessione tra account viene rifiutata. Crea la connessione prima della prima pubblicazione. Prima della pubblicazione, codifica il payload con il serializzatore Confluent per la tua lingua. Il serializzatore incorpora il riferimento allo schema utilizzato per risolvere e deserializzare l'evento. EventBridge
EventBridge legge le credenziali del registro tramite la connessione nominata dall'utente. Concedi all'identità di pubblicazione l'autorizzazione a leggere le credenziali della connessione.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "events:RetrieveConnectionCredentials", "Resource": "arn:aws:events:us-east-1:111122223333:connection/confluent-registry/*" }, { "Effect": "Allow", "Action": ["secretsmanager:GetSecretValue", "secretsmanager:DescribeSecret"], "Resource": "arn:aws:secretsmanager:us-east-1:111122223333:secret:events!connection/confluent-registry/*", "Condition": { "Bool": { "aws:ViaAWSService": "true" } } } ] }
Se il segreto di connessione è crittografato con una AWS KMS chiave gestita dal cliente, kms:Decrypt concedi anche quella chiave.
Pubblica i byte codificati dallo schema con l'URL Confluent e l'ARN della connessione.
aws eventsv2 put-raw-events \ --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --schema-registry-configuration '{ "RegistryUri": "https://psrc-example.us-east-1.aws.confluent.cloud", "ConfluentPublicRegistryConfiguration": { "ConnectionArn": "arn:aws:events:us-east-1:111122223333:connection/confluent-registry/EXAMPLE-1234-5678-abcd" } }' \ --entries '[ { "Data": "base64-encoded-protobuf-bytes", "SystemMetadata": { "ContentType": "application/protobuf" } } ]'
Opzioni di autenticazione della connessione
Configura la connessione con il tipo di autenticazione previsto dal registro Confluent. EventBridge legge solo le intestazioni di autenticazione prodotte dalla connessione; non vede mai il segreto non elaborato e aggiorna automaticamente i token OAuth.
Chiave API. Confluent Schema Registry utilizza in genere l'autenticazione HTTP Basic con la chiave API del registro dello schema come nome utente e il segreto dell'API come password.
aws events create-connection \ --name confluent-registry \ --authorization-type API_KEY \ --auth-parameters '{ "ApiKeyAuthParameters": { "ApiKeyName": "Authorization", "ApiKeyValue": "Basicbase64(srApiKey:srApiSecret)" } }'
Credenziali del client OAuth. EventBridge recupera e aggiorna il token. È necessario grant_type=client_credentials includerlo come parametro del corpo; EventBridge non lo aggiunge automaticamente.
aws events create-connection \ --name confluent-registry-oauth \ --authorization-type OAUTH_CLIENT_CREDENTIALS \ --auth-parameters '{ "OAuthParameters": { "AuthorizationEndpoint": "https://idp-domain/oauth/token", "HttpMethod": "POST", "ClientParameters": { "ClientID": "oauth-client-id", "ClientSecret": "oauth-client-secret" }, "OAuthHttpParameters": { "BodyParameters": [ { "Key": "grant_type", "Value": "client_credentials", "IsValueSecret": false } ] } } }'
EventBridge memorizza entrambe le credenziali in un Secrets Manager gestito secret (events!connection/...), che la connessione legge per conto dell'utente.
Distribuzione di byte senza deserializzazione
Per far sì che un payload venga EventBridge consegnato esattamente come inviato, imposta la voce su. SystemMetadata.ContentType application/octet-stream Questo è un campo in ogni voce, non un'intestazione HTTP. EventBridge non deserializza o ispeziona i byte e non è coinvolto alcun registro dello schema. Qualsiasi formato funziona, compresi Avro o Protobuf, che vengono deserializzati autonomamente alla destinazione.
Poiché il contenuto è opaco, un filtro non può eguagliarlo. DATA Indirizza tali eventi con i filtri attiviMETADATA, utilizzando le chiavi impostate nella Metadata mappa della voce o attivando i filtri. SYSTEM_METADATA Content-based la deduplicazione funziona ancora e esegue l'hash dei byte esattamente come li hai inviati. In un trasformatore, il payload appare come una stringa Base64; vedere. Trasformare gli eventi con JSonata
Filtraggio e trasformazione di eventi deserializzati
Una volta EventBridge deserializzato un evento in JSON, il payload scorre attraverso la normale pipeline. Un filtro con un ambito di DATA corrisponde ai campi deserializzati in base ai nomi degli schemi e un trasformatore JSONata li indirizza in base ai relativi nomi di schema. $events.Data Un evento pubblicato come Avro o Protobuf ottiene lo stesso routing basato sul contenuto e lo stesso rimodellamento per abbonato di un evento pubblicato come semplice JSON. Scrivi modelli di filtro in base al codice JSON deserializzato, tenendo a mente due regole di conversione.
-
Avro deserializza in formato JSON standard. La conversione è unidirezionale: il JSON non può essere riconvertito in un oggetto Avro.
-
Protobuf deserializza in JSON con i nomi dei campi definiti nello schema, anziché convertirli in camel case come fanno normalmente gli strumenti Protobuf. Corrispondono ai nomi dei campi dello schema.
Deduplicazione degli eventi tra formati
EventBridge supporta due modalità di deduplicazione: ID-based, in cui si fornisce un in ingresso e basata DeduplicationId sul contenuto, in cui EventBridge calcola un SHA-256 hash del contenuto dell'evento. Per gli eventi deserializzati, la deduplicazione basata sul contenuto esegue l'hash dei byte wire Avro o Protobuf originali, non del JSON deserializzato. Due eventi vengono duplicati solo quando i relativi payload originali sono identici in byte. EventBridge pertanto non deduplica lo stesso evento logico pubblicato in formati diversi. I byte Avro, i byte Protobuf e il formato JSON non elaborato differiscono in linea anche quando vengono deserializzati sugli stessi dati. Consulta Ordinamento e deduplicazione degli eventi su un bus di eventi personalizzato.
Errori
-
Una voce Avro o Protobuf pubblicata senza
SchemaRegistryConfigurationerrori come errore di immissione con un of e un messaggio che indica.ErrorCodeVALIDATION_ERRORSchemaRegistryConfiguration is requiredLe altre voci della richiesta non sono interessate. -
A
ConnectionArnche non nomina una connessione utilizzabile o che appartiene a un altro account, non inserisceVALIDATION_ERRORe visualizza un messaggio che nomina il registro. -
Uno schema che non può essere trovato o letto, o un payload che non può essere deserializzato in base ad esso, non risponde a questa voce.
VALIDATION_ERRORQuesto errore non è riutilizzabile; correggi la richiesta o l'accesso al registro del chiamante prima di ripubblicarlo. -
Un registro che non può essere raggiunto non riesce a completare la richiesta.
SchemaRegistryUnavailableExceptionNel percorso OAuth di Confluent, ciò può verificarsi durante l'aggiornamento del token di accesso al registro. Questo errore è temporaneo; riprova la richiesta con backoff.
Per i risultati relativi alle singole immissioni e per le indicazioni generali relative ai nuovi tentativi, consulta. Pubblicazione di eventi su un Event Bus personalizzato