Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Single Message Transforms (SMTs) können als Eigenschaften von Themen oder Abos festgelegt werden.
Mit einem SMT für ein Thema werden Transformationen auf die Nachrichten angewendet, bevor sie für ein Thema gespeichert werden.
Mit einer SMT für ein Abo werden Transformationen auf die Nachrichten angewendet, bevor sie an ein Abo gesendet werden.
Im Folgenden sind einige Gründe aufgeführt, warum Sie eine SMT auf ein Thema anwenden sollten, anstatt auf ein Abo:
Sie möchten, dass mehrere Abos für dasselbe Thema die transformierte Nachricht erhalten.
Wenn alle Abos eines Themas die transformierte Nachricht erhalten sollen, ist es besser, die Transformation einmal auf der Publish-Seite anzuwenden.
Sie möchten die Kosten für Speicher, interregionale Bereitstellung und Bereitstellung für Abonnenten minimieren.
Wenn Sie mithilfe eines für ein Thema definierten SMT unnötige Felder aus einer Nachricht entfernen, profitieren alle nachfolgenden Datenverarbeitungs- und Übermittlungsvorgänge von der reduzierten Nachrichtengröße.
Sie möchten ungültige Nachrichten zum Zeitpunkt der Veröffentlichung verarbeiten. Wenn Sie ein SMT für ein Thema verwenden, um Nachrichten zu validieren, schlägt jede Veröffentlichung mit einer ungültigen Nachricht fehl. Sie können im Publisher festlegen, wie mit diesen Fehlern umgegangen werden soll.
Im Folgenden sind einige Gründe aufgeführt, warum Sie eine SMT auf ein Abo anwenden sollten, anstatt auf ein Thema:
Sie benötigen Transformationen nur für ein einzelnes Abo. Eine Abo-SMT ist nützlich, wenn Sie nur Transformationen für ein einzelnes Abo benötigen.
Sie möchten ungültige Nachrichten an ein Thema für unzustellbare Nachrichten senden. Sie können auch SMTs für Abos mit Themen für unzustellbare Nachrichten verwenden, um fehlgeschlagene Transformationen zu archivieren. Die Nachrichten werden aufgrund der Fehler an das angegebene Thema für unzustellbare Nachrichten weitergeleitet.
Sie können SMTs für Themen und Abos kombinieren, um unabhängige Transformationen für eine einzelne Nachricht auszuführen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-17 (UTC)."],[],[],null,["# Choose topic or subscription SMTs\n\nSingle message transforms (SMTs) can be set as properties of topics or\nsubscriptions.\n\n- A topic SMT applies transformations to the messages before the messages are\n persisted for a topic.\n\n- A subscription SMT applies transformations to the messages before the\n messages are delivered to a subscription.\n\nThe following are some reasons for applying an SMT to a topic instead of a\nsubscription:\n\n- **You want multiple subscriptions on the same topic to receive the transformed message**.\n If all subscriptions on a topic are supposed to\n receive the transformed message, then it is better to apply the\n transformation one time on the publish side.\n\n- **You want to minimize storage, inter-region delivery, and subscriber delivery costs**.\n If you remove unnecessary fields from a message using an\n SMT defined on a topic, then all subsequent data processing and delivery\n operations benefit from the reduced message footprint.\n\n- **You want to handle invalid messages at publish time.** If you use an SMT\n on a topic to validate messages, then any publish with an invalid message is\n going to fail. You can decide in the publisher how to handle these failures.\n\nThe following are some reasons for applying an SMT to a subscription instead of\na topic:\n\n- **You only need transformations for a single subscription.** A subscription\n SMT is useful when you only need transformations for a single subscription.\n\n- **You want to write invalid messages to a dead-letter topic.** You can also\n use subscription SMTs with dead-letter topics to archive failed\n transformations. The errors result in messages being routed to the\n designated dead-letter topic.\n\nYou can combine topic and subscription SMTs to perform independent\ntransformations on a single message.\n\nWhat's next\n-----------\n\n- [Create a topic with SMTs](/pubsub/docs/smts/create-topic-smt)\n\n- [Create a subscription with SMTs](/pubsub/docs/smts/create-subscription-smt)"]]
