Proprietà abbonamento

Le proprietà della sottoscrizione Pub/Sub sono le caratteristiche di una sottoscrizione. Puoi impostare le proprietà della sottoscrizione quando crei o aggiorni una sottoscrizione.

Questo documento descrive le diverse proprietà che puoi impostare per un abbonamento.

Prima di iniziare

Proprietà degli abbonamenti comuni

Quando crei un abbonamento, devi specificare una serie di opzioni per configurarla. Alcune di queste proprietà sono comuni a tutti i tipi di abbonamento e sono descritte nelle sezioni successive.

Tempo di conservazione dei messaggi

L'opzione Durata di conservazione dei messaggi specifica per quanto tempo Pub/Sub conserva i messaggi dopo la pubblicazione. Una volta trascorsa la durata di conservazione dei messaggi, Pub/Sub potrebbe ignorare il messaggio indipendentemente dallo stato di conferma. Per conservare i messaggi confermati per la durata di conservazione dei messaggi, vedi Ripetere ed eliminare i messaggi.

Di seguito sono riportati i valori per l'opzione Durata di conservazione dei messaggi:

  • Valore predefinito = 7 giorni
  • Valore minimo = 10 minuti
  • Valore massimo = 7 giorni

I messaggi non confermati possono derivare da abbonamenti inattivi, esigenze di backup o elaborazione lenta. Se riesci a elaborare i messaggi entro 24 ore, non vengono addebitati costi aggiuntivi. Puoi evitare nuovi addebiti gestendo questi scenari come segue:

  • Abbonamenti inattivi. Elimina le sottoscrizioni inattive per evitare costi di conservazione dei messaggi di abbonamento.

  • Spazio di archiviazione di backup. Se utilizzi la conservazione degli abbonamenti come spazio di archiviazione di backup, puoi passare a un'altra opzione di archiviazione, come la conservazione dei messaggi degli argomenti o la conservazione dei messaggi confermati. La conservazione dei messaggi degli argomenti archivia i messaggi una sola volta a livello di argomento e rimangono disponibili per tutte le sottoscrizioni da utilizzare quando necessario.

  • Ritardi nell'elaborazione. Aggiungere altri sottoscrittori (se possibile) per elaborare i messaggi in un giorno.

Conserva messaggi confermati

Se specifichi Durata di conservazione dei messaggi, puoi anche specificare se vuoi conservare i messaggi confermati.

L'opzione Conserva i messaggi confermati consente di conservare i messaggi confermati per la durata di conservazione dei messaggi specificata. Questa opzione aumenta le tariffe di archiviazione dei messaggi. Per ulteriori informazioni, consulta i costi di archiviazione.

Periodo di scadenza

L'opzione Periodo di scadenza consente di estendere il periodo di scadenza dell'abbonamento.

Gli abbonamenti senza alcuna attività dell'abbonato o modifiche apportate alle proprietà di abbonamento scadono. Se Pub/Sub rileva l'attività dei sottoscrittori o se aggiorni una proprietà della sottoscrizione, il quadrante orologio di eliminazione della sottoscrizione si riavvia. Esempi di attività degli abbonati includono connessioni aperte, pull attivi o push riusciti.

Se specifichi il periodo di scadenza, il valore deve essere superiore alla durata di conservazione dei messaggi specificata nell'opzione Durata di conservazione dei messaggi.

Di seguito sono riportati i valori per l'opzione Periodo di scadenza:

  • Valore predefinito = 31 giorni
  • Valore minimo = 1 giorno
  • Valore massimo = 365 giorni.

Per evitare che un abbonamento scada, imposta il periodo di scadenza su never expire.

Scadenza conferma

L'opzione Scadenza conferma specifica la scadenza iniziale dopo la quale viene inviato di nuovo un messaggio non confermato. Puoi estendere la scadenza per la conferma in base al singolo messaggio inviando richieste ModifyAckDeadline successive.

Di seguito sono riportati i valori per l'opzione Scadenza conferma:

  • Valore predefinito = 10 secondi
  • Valore minimo = 10 secondi
  • Valore massimo = 600 secondi

In alcuni casi, le librerie client Pub/Sub possono controllare la frequenza di consegna e modificare in modo dinamico la scadenza di conferma. In questo modo, il messaggio potrebbe essere recapitato nuovamente prima della scadenza di conferma impostata. Per eseguire l'override di questo comportamento, utilizza minDurationPerAckExtension e maxDurationPerAckExtension. Per saperne di più sull'utilizzo di questi valori, consulta Supporto della pubblicazione "exactly-once" nelle librerie client.

Filtro sottoscrizioni

Utilizza l'opzione Filtro abbonamenti per specificare una stringa con un'espressione di filtro. Se una sottoscrizione ha un filtro, la sottoscrizione recapita solo i messaggi che corrispondono al filtro. Il servizio Pub/Sub riconosce automaticamente i messaggi che non corrispondono al filtro.

  • Puoi filtrare i messaggi in base agli attributi, ma non in base ai dati del messaggio.

  • Se non specificato, la sottoscrizione non filtra i messaggi e i sottoscrittori ricevono tutti i messaggi.

  • I filtri non possono essere modificati o rimossi una volta applicati.

Quando ricevi messaggi da una sottoscrizione con un filtro, non ti vengono addebitate tariffe di traffico in uscita per i messaggi riconosciuti automaticamente da Pub/Sub. Per questi messaggi ti vengono addebitate tariffe per la consegna dei messaggi e per l'archiviazione di ricerca.

Per ulteriori informazioni, vedi Filtrare i messaggi da un abbonamento.

Ordinamento messaggi

Quando in una sottoscrizione è abilitato l'ordinamento dei messaggi, i client abbonati ricevono i messaggi pubblicati nella stessa regione con la stessa chiave di ordinamento nell'ordine in cui i messaggi sono stati ricevuti dal servizio.

Quando utilizzi la consegna ordinata, le conferme per i messaggi successivi non vengono elaborate finché non vengono elaborate le conferme dei messaggi precedenti.

Gli editori devono inviare messaggi con una chiave di ordinamento in modo che Pub/Sub possa recapitare i messaggi in ordine.

Se non viene configurato, Pub/Sub potrebbe non recapitare i messaggi in ordine, anche se hanno una chiave di ordinamento.

Argomento messaggi non recapitabili

Se un messaggio non può essere recapitato dopo un determinato numero di tentativi di consegna o un sottoscrittore non può confermarlo, puoi configurare un argomento messaggi non recapitabili in cui questi messaggi possano essere ripubblicati.

Se imposti un argomento messaggi non recapitabili, puoi anche specificare il numero massimo di tentativi di consegna. Di seguito sono riportati i valori relativi al numero massimo di tentativi di consegna per l'argomento messaggi non recapitabili:

  • Valore predefinito = 5 tentativi di consegna
  • Valore minimo = 5 tentativi di consegna
  • Valore massimo = 100 tentativi di consegna

Se l'argomento messaggi non recapitabili si trova in un progetto diverso da quello della sottoscrizione, devi specificare anche l'ID progetto con l'argomento messaggi non recapitabili.

Per ulteriori informazioni, consulta Inoltro ad argomenti messaggi non recapitabili.

Criterio di ripetizione

Se la scadenza per la conferma scade o un abbonato risponde con una conferma negativa, Pub/Sub può inviare nuovamente il messaggio. Questo tentativo di nuovo caricamento è noto come criterio relativo ai nuovi tentativi di abbonamento.

Per impostazione predefinita, il criterio di nuovo tentativo di un abbonamento è impostato in modo da utilizzare l'opzione Riprova immediatamente. Con questa opzione, Pub/Sub invia nuovamente il messaggio quando scade la scadenza della conferma o un sottoscrittore risponde con una conferma negativa.

Puoi anche impostare il valore su Riprova dopo un ritardo di backoff esponenziale. In questo caso, devi specificare i valori massimo e minimo di backoff.

Di seguito sono riportate alcune linee guida per impostare i valori relativi ai valori di backoff massimo e minimo:

  • Se imposti il valore massimo per la durata di backoff, il valore predefinito per la durata minima di backoff è 10 secondi.

  • Se imposti il valore minimo per la durata di backoff, il valore predefinito per la durata massima di backoff è 600 secondi.

  • La durata del backoff più lunga che puoi specificare è 600 secondi.

Criterio di nuovo tentativo e messaggi in batch

Se i messaggi sono in batch, Pub/Sub avvia il backoff esponenziale quando si verifica una delle seguenti condizioni:

  • Il sottoscrittore invia una conferma negativa per ogni messaggio nel batch.

  • Il termine ultimo per la conferma è scaduto.

Criterio di nuovo tentativo e push dell'abbonamento

Se ricevi messaggi da una sottoscrizione push, Pub/Sub potrebbe recapitare i messaggi dopo il pushback anziché dopo una durata esponenziale del backoff. Quando il backoff push supera la durata esponenziale del backoff, Pub/Sub restituisce nuovamente i messaggi non confermati dopo il backoff push.

Esegui il pull delle proprietà della sottoscrizione

Quando configuri una sottoscrizione pull, puoi specificare le seguenti proprietà.

Consegna "exactly-once"

Distribuzione "exactly-once". Se impostato, Pub/Sub soddisfa le garanzie di consegna exactly-once. Se non specificato, la sottoscrizione supporta la consegna at-least-once per ogni messaggio.

Proprietà delle sottoscrizioni push

Quando configuri una sottoscrizione push, puoi specificare le seguenti proprietà.

Endpoint

URL endpoint (obbligatorio). Un indirizzo HTTPS accessibile pubblicamente. Il server per l'endpoint push deve avere un certificato SSL valido firmato da un'autorità di certificazione. Il servizio Pub/Sub consegna i messaggi per il push degli endpoint dalla stessa regione Google Cloud in cui il servizio Pub/Sub archivia i messaggi. Il servizio Pub/Sub recapita i messaggi dalla stessa regione Google Cloud secondo il criterio del "best effort".

Pub/Sub non richiede più la prova di proprietà per i domini dell'URL dell'abbonamento push. Se il tuo dominio riceve richieste POST impreviste da Pub/Sub, puoi segnalare un abuso sospetto.

Autenticazione

Attiva l'autenticazione. Quando l'opzione è abilitata, i messaggi recapitati da Pub/Sub all'endpoint push includono un'intestazione di autorizzazione per consentire all'endpoint di autenticare la richiesta. I meccanismi di autenticazione e autorizzazione automatica sono disponibili per gli endpoint App Engine Standard e Cloud Functions ospitati nello stesso progetto dell'abbonamento.

La configurazione dell'autenticazione per una sottoscrizione push autenticata è composta da un account di servizio gestito dall'utente e dai parametri di pubblico specificati in una chiamata create, patch o ModifyPushConfig. Devi inoltre concedere a un account di servizio speciale gestito da Google un ruolo specifico, come illustrato nella sezione successiva.

  • Account di servizio gestito dall'utente (obbligatorio). L'account di servizio associato alla sottoscrizione push. Questo account viene utilizzato come attestazione email del token JWT (JSON Web Token) generato. Di seguito è riportato un elenco di requisiti per l'account di servizio:

  • Pubblico. Una singola stringa, senza distinzione tra maiuscole e minuscole, utilizzata dal webhook per convalidare il pubblico previsto per questo particolare token.

  • Account di servizio gestito da Google (obbligatorio).

    • Pub/Sub crea automaticamente un account di servizio per te con il formato service-{PROJECT_NUMBER}@gcp-sa-pubsub.iam.gserviceaccount.com.

    • A questo account di servizio deve essere concessa l'autorizzazione iam.serviceAccounts.getOpenIdToken (inclusa nel ruolo roles/iam.serviceAccountTokenCreator) per consentire a Pub/Sub di creare token JWT per le richieste push autenticate.

Annullamento del wrapping del payload

L'opzione Abilita l'annullamento del wrapping del payload rimuove i messaggi Pub/Sub di tutti i metadati dei messaggi, ad eccezione di quelli dei messaggi. Con l'annullamento del wrapping del payload, i dati dei messaggi vengono recapitati direttamente come corpo HTTP.

  • Scrivi metadati. Aggiunge nuovamente i metadati dei messaggi rimossi in precedenza nell'intestazione della richiesta.

Proprietà BigQuery

Quando selezioni un tipo di invio della sottoscrizione come Scrivi in BigQuery, puoi specificare le seguenti proprietà aggiuntive.

Utilizza schema argomento

Questa opzione consente a Pub/Sub di utilizzare lo schema dell'argomento Pub/Sub a cui è collegato la sottoscrizione. Inoltre, Pub/Sub scrive i campi dei messaggi nelle colonne corrispondenti della tabella BigQuery.

Quando utilizzi questa opzione, ricordati di controllare i seguenti requisiti aggiuntivi:

  • I campi nello schema dell'argomento e in quello di BigQuery devono avere gli stessi nomi e i loro tipi devono essere compatibili tra loro.

  • Qualsiasi campo facoltativo dello schema dell'argomento deve essere obbligatorio anche nello schema di BigQuery.

  • Non è necessario che i campi obbligatori nello schema dell'argomento siano obbligatori nello schema di BigQuery.

  • Se ci sono campi BigQuery che non sono presenti nello schema dell'argomento, questi campi BigQuery devono essere in modalità NULLABLE.

  • Se lo schema dell'argomento include campi aggiuntivi che non sono presenti nello schema BigQuery e questi campi possono essere eliminati, seleziona l'opzione Elimina campi sconosciuti.

  • Puoi selezionare solo una delle proprietà della sottoscrizione, Utilizza schema argomento o Utilizza schema tabella.

Se non selezioni l'opzione Utilizza schema argomento o Utilizza schema tabella, assicurati che la tabella BigQuery abbia una colonna denominata data di tipo BYTES, STRING o JSON. Pub/Sub scrive il messaggio in questa colonna BigQuery.

Potresti non notare che le modifiche allo schema degli argomenti Pub/Sub o allo schema della tabella BigQuery diventeranno effettive immediatamente con i messaggi scritti nella tabella BigQuery. Ad esempio, se l'opzione Elimina campi sconosciuti è abilitata e nello schema Pub/Sub è presente un campo, ma non lo schema BigQuery, i messaggi scritti nella tabella BigQuery potrebbero comunque non contenere il campo dopo averlo aggiunto allo schema BigQuery. Alla fine, gli schemi verranno sincronizzati e i messaggi successivi includeranno il campo.

Quando utilizzi l'opzione Utilizza schema argomento per la sottoscrizione BigQuery, puoi anche usufruire della Change Data Capture (CDC) di BigQuery. CDC aggiorna le tabelle BigQuery elaborando e applicando modifiche alle righe esistenti.

Per scoprire di più su questa funzionalità, consulta Streaming di aggiornamenti delle tabelle con Change Data Capture (CDC).

Per scoprire come utilizzare questa funzionalità con le sottoscrizioni BigQuery, consulta Change Data Capture (CDC) di BigQuery.

Usa schema tabella

Questa opzione consente a Pub/Sub di utilizzare lo schema della tabella BigQuery per scrivere i campi di un messaggio JSON nelle colonne corrispondenti. Quando utilizzi questa opzione, ricordati di controllare i seguenti requisiti aggiuntivi:

  • I messaggi pubblicati devono essere in formato JSON.

  • Se all'argomento della sottoscrizione è associato uno schema, la proprietà di codifica del messaggio deve essere impostata su JSON.

  • Se ci sono campi BigQuery che non sono presenti nei messaggi, questi campi BigQuery devono essere in modalità NULLABLE.

  • Se i messaggi contengono campi aggiuntivi che non sono presenti nello schema di BigQuery e questi campi possono essere eliminati, seleziona l'opzione Elimina campi sconosciuti.

  • Nel messaggio JSON, i valori DATE, DATETIME, TIME e TIMESTAMP devono essere numeri interi che rispettano le rappresentazioni supportate.

  • Nel messaggio JSON, i valori NUMERIC e BIGNUMERIC devono essere byte codificati utilizzando BigDecimalByteStringEncoder.

  • Puoi selezionare solo una delle proprietà della sottoscrizione, Utilizza schema argomento o Utilizza schema tabella.

Se non selezioni l'opzione Utilizza schema argomento o Utilizza schema tabella, assicurati che la tabella BigQuery abbia una colonna denominata data di tipo BYTES, STRING o JSON. Pub/Sub scrive il messaggio in questa colonna BigQuery.

Potresti non notare che le modifiche allo schema della tabella BigQuery vengono applicate immediatamente con i messaggi scritti nella tabella BigQuery. Ad esempio, se l'opzione Elimina campi sconosciuti è abilitata e un campo è presente nei messaggi, ma non nello schema BigQuery, i messaggi scritti nella tabella BigQuery potrebbero comunque non contenere il campo dopo averlo aggiunto allo schema BigQuery. Alla fine, lo schema viene sincronizzato e i messaggi successivi includono il campo.

Quando utilizzi l'opzione Utilizza schema tabella per la sottoscrizione BigQuery, puoi anche usufruire della Change Data Capture (CDC) di BigQuery. CDC aggiorna le tabelle BigQuery elaborando e applicando modifiche alle righe esistenti.

Per scoprire di più su questa funzionalità, consulta Streaming di aggiornamenti delle tabelle con Change Data Capture (CDC).

Per scoprire come utilizzare questa funzionalità con le sottoscrizioni BigQuery, consulta Change Data Capture (CDC) di BigQuery.

Rilascia campi sconosciuti

Questa opzione viene utilizzata con l'opzione Utilizza schema argomento o Utilizza schema tabella. Questa opzione consente a Pub/Sub di ignorare qualsiasi campo presente nello schema o nel messaggio dell'argomento, ma non nello schema di BigQuery. Se Elimina campi sconosciuti non viene impostato, i messaggi con campi aggiuntivi non vengono scritti in BigQuery e rimangono nel backlog della sottoscrizione. L'abbonamento risulta stato di errore.

Scrivi metadati

Questa opzione consente a Pub/Sub di scrivere i metadati di ciascun messaggio in colonne aggiuntive della tabella BigQuery. In caso contrario, i metadati non vengono scritti nella tabella BigQuery.

Se selezioni l'opzione Scrivi metadati, assicurati che la tabella BigQuery contenga i campi descritti nella seguente tabella.

Se non selezioni l'opzione Scrivi metadati, la tabella BigQuery di destinazione richiede solo il campo data, a meno che use_topic_schema non sia true. Se selezioni entrambe le opzioni Scrivi metadati e Utilizza schema argomento, lo schema dell'argomento non deve contenere campi con nomi corrispondenti a quelli dei parametri dei metadati. Questa limitazione include le versioni cammello di questi parametri relativi alle custodie serpenti.

Parametri
subscription_name

STRING

Il nome di un abbonamento.
message_id

STRING

ID di un messaggio
publish_time

TIMESTAMP

L'ora di pubblicazione di un messaggio.
data

BYTES, STRING o JSON

Il corpo del messaggio.

Il campo data è obbligatorio per tutte le tabelle BigQuery di destinazione che non selezionano Utilizza schema argomento. Se il campo è di tipo JSON, il corpo del messaggio deve essere in formato JSON valido.
attributes

STRING o JSON

Oggetto JSON contenente tutti gli attributi del messaggio. Contiene inoltre campi aggiuntivi che fanno parte del messaggio Pub/Sub, inclusa la chiave di ordinamento, se presente.

Proprietà Cloud Storage

Quando selezioni un tipo di consegna della sottoscrizione come Scrivi in Cloud Storage, puoi specificare le seguenti proprietà aggiuntive.

Nome bucket

Per poter creare una sottoscrizione Cloud Storage deve già esistere un bucket Cloud Storage.

I messaggi vengono inviati in batch e archiviati nel bucket Cloud Storage. Un singolo batch o file viene archiviato come oggetto nel bucket.

Nel bucket Cloud Storage deve essere disabilitata la funzionalità Pagamenti a carico del richiedente.

Per creare un bucket Cloud Storage, consulta Creare bucket.

Prefisso, suffisso e data/ora del nome file

I file Cloud Storage di output generati dalla sottoscrizione a Cloud Storage vengono archiviati come oggetti nel bucket Cloud Storage. Il nome dell'oggetto archiviato nel bucket Cloud Storage è nel seguente formato: <file-prefix><UTC-date-time>_<uuid><file-suffix>.

Il seguente elenco include i dettagli del formato file e i campi che puoi personalizzare:

  • <file-prefix> è il prefisso del nome file personalizzato. Questo è un campo facoltativo.

  • <UTC-date-time> è una stringa personalizzabile generata automaticamente in base al momento in cui l'oggetto viene creato.

  • <uuid> è una stringa casuale generata automaticamente per l'oggetto.

  • <file-suffix> è il suffisso personalizzato del nome file. Questo è un campo facoltativo. Il suffisso del nome file non può terminare con "/".

  • Puoi modificare il prefisso e il suffisso del nome file:

    • Ad esempio, se il valore del prefisso del nome file è prod_ e il valore del suffisso del nome file è _archive, un nome di oggetto di esempio è prod_2023-09-25T04:10:00+00:00_uN1QuE_archive.

    • Se non specifichi il prefisso e il suffisso del nome file, il nome dell'oggetto archiviato nel bucket Cloud Storage è nel formato: <UTC-date-time>_<uuid>.

    • I requisiti di denominazione degli oggetti Cloud Storage si applicano anche al prefisso e al suffisso dei nomi file. Per maggiori informazioni, consulta Informazioni sugli oggetti Cloud Storage.

  • Puoi modificare il modo in cui la data e l'ora vengono visualizzate nel nome file:

    • Matcher di data/ora obbligatori, che puoi utilizzare una sola volta: anno (YYYY o YY), mese (MM), giorno (DD), ora (hh), minuto (mm), secondo (ss). Ad esempio, YY-YYYY o MMM non sono validi.

    • Matcher facoltativi che puoi utilizzare una sola volta: separatore data/ora (T) e offset fuso orario (Z o +00:00).

    • Elementi facoltativi che puoi utilizzare più volte: trattino (-), trattino basso (_), due punti (:) e barra (/).

    • Ad esempio, se il valore del formato data/ora del nome file è YYYY-MM-DD/hh_mm_ssZ, il nome di un oggetto di esempio è prod_2023-09-25/04_10_00Z_uNiQuE_archive.

    • Se il formato data/ora del nome file termina con un carattere che non è un matcher, questo carattere sostituirà il separatore tra <UTC-date-time> e <uuid>. Ad esempio, se il valore del formato data/ora del nome file è YYYY-MM-DDThh_mm_ss-, il nome di un oggetto di esempio è prod_2023-09-25T04_10_00-uNiQuE_archive.

Batch di file

Le sottoscrizioni Cloud Storage ti consentono di decidere quando creare un nuovo file di output archiviato come oggetto nel bucket Cloud Storage. Pub/Sub scrive un file di output quando viene soddisfatta una delle condizioni di batch specificate. Di seguito sono riportate le condizioni di batch di Cloud Storage:

  • Durata massima batch di archiviazione. Si tratta di un'impostazione obbligatoria. L'abbonamento a Cloud Storage scrive un nuovo file di output se viene superato il valore di durata massima specificato. Se non specifichi il valore, viene applicato un valore predefinito di 5 minuti. Di seguito sono riportati i valori applicabili per la durata massima:

    • Valore minimo = 1 minuto
    • Valore predefinito = 5 minuti
    • Valore massimo = 10 minuti

  • Byte massimi batch di archiviazione. Si tratta di un'impostazione facoltativa. L'abbonamento a Cloud Storage scrive un nuovo file di output se viene superato il valore specificato di byte massimi. Di seguito sono riportati i valori applicabili per i byte massimi:

    • Valore minimo = 1 kB
    • Valore massimo = 10 GiB

Ad esempio, puoi configurare una durata massima di 6 minuti e un massimo di 2 GB. Se al quarto minuto il file di output raggiunge la dimensione di 2 GB, Pub/Sub finalizza il file precedente e inizia a scrivere in un nuovo file.

Un abbonamento a Cloud Storage potrebbe scrivere su più file contemporaneamente in un bucket Cloud Storage. Se hai configurato l'abbonamento in modo da creare un nuovo file ogni sei minuti, potresti notare che più file Cloud Storage vengono creati ogni sei minuti.

In alcune situazioni, Pub/Sub potrebbe iniziare a scrivere su un nuovo file prima dell'ora configurata dalle condizioni di raggruppamento dei file. Un file potrebbe superare il valore Max byte anche se la sottoscrizione riceve messaggi di dimensioni superiori a questo valore.

Formato file

Quando crei un abbonamento a Cloud Storage, puoi specificare il formato dei file di output da archiviare in un bucket Cloud Storage come Text o Avro.

  • Testo: i messaggi vengono memorizzati come testo normale. Un carattere di nuova riga separa un messaggio dal messaggio precedente nel file. Vengono archiviati solo i payload dei messaggi, non attributi o altri metadati.

  • Avro: i messaggi vengono archiviati in formato binario Apache Avro.

    Quando selezioni Avro, puoi attivare anche l'opzione di scrittura metadati. Questa opzione consente di archiviare i metadati del messaggio insieme al messaggio.

    Metadati come subscription_name, message_id, publish_time e campi degli attributi vengono scritti nei campi di primo livello nell'oggetto Avro di output, mentre tutte le altre proprietà del messaggio diverse dai dati (ad esempio, un ordinare_key, se presente) come voci nella mappa degli attributi.

    Se l'opzione scrittura metadati è disabilitata, solo il payload del messaggio viene scritto nell'oggetto Avro di output.

    Ecco lo schema Avro per i messaggi di output senza metadati di scrittura abilitati:

    {
  "type": "record",
  "namespace": "com.google.pubsub",
  "name": "PubsubMessage",
  "fields": [
    { "name": "data", "type": "bytes" }
  ]
}

    Ecco lo schema Avro per i messaggi di output con i metadati di scrittura abilitati:

    {
  "type": "record",
  "namespace": "com.google.pubsub",
  "name": "PubsubMessageWithMetadata",
  "fields": [
    { "name": "subscription_name", "type": "string" },
    { "name": "message_id", "type": "string"  },
    { "name": "publish_time", "type": {
        "type": "long",
        "logicalType": "timestamp-micros"
      }
    },
    { "name": "attributes", "type": { "type": "map", "values": "string" } },
    { "name": "data", "type": "bytes" }
  ]
}

Passaggi successivi