Contesti degli oggetti

Questo documento descrive come i contesti degli oggetti consentono di associare informazioni contestuali agli oggetti per aiutarti a gestire e scoprire i dati.

Per scoprire come collegare e gestire i contesti degli oggetti, consulta Utilizzare i contesti degli oggetti.

Panoramica

I contesti degli oggetti consentono di associare coppie chiave-valore agli oggetti Cloud Storage per classificare, monitorare e cercare i dati. Puoi collegare i contesti quando crei o aggiorni gli oggetti oppure lasciare che i servizi Google li colleghino automaticamente.

Nella risorsa objects, tutti i contesti degli oggetti vengono visualizzati nel campo contexts.custom. All'interno di contexts.custom, esistono due tipi di contesti:

  • Contesti personalizzati senza dati estesi: contesti costituiti da una chiave, un valore stringa e timestamp. Puoi utilizzare questi contesti per organizzare, filtrare e monitorare gli oggetti nei bucket di archiviazione.

  • Contesti personalizzati con dati estesi (anteprima): contesti costituiti da una chiave, un valore stringa, timestamp e un payload JSON strutturato facoltativo. I servizi Google collegano questi contesti durante l'analisi automatizzata, ad esempio l'etichettatura di machine learning.

Componenti del contesto

Ogni voce di contesto è costituita dai seguenti componenti:

  • Chiave: un identificatore univoco per il contesto dell'oggetto (fino a 256 byte). Le chiavi che iniziano con google: (ad esempio, google:annotation:face-detector-v1) sono riservate ai contesti generati da Google. Non puoi creare o aggiornare i contesti con il prefisso google:. Per rimuovere i contesti con il prefisso google:, devi eliminarli utilizzando il parametro dropContextGroups durante un'operazione di riscrittura.

  • Valore: un valore stringa associato alla chiave (fino a 256 byte) per controllare i workflow e filtrare gli elenchi di oggetti.

  • Timestamp: timestamp di sola uscita (createTime e updateTime) che indicano quando il contesto è stato creato e modificato l'ultima volta.

  • Dati estesi (anteprima): un payload JSON strutturato facoltativo (fino a 128 KiB) contenente informazioni dettagliate, come etichette di machine learning o annotazioni automatiche.

Le richieste get standard e list restituiscono chiavi, valori e timestamp di contesto. Se un contesto ha dati estesi, le richieste standard includono un extendedDataTypeUrl campo (type.googleapis.com/google.protobuf.Struct). Per recuperare il payload completo dei dati estesi, utilizza il viewFullContext metodo (anteprima).

Ad esempio, un oggetto con contesti personalizzati, con e senza dati estesi, ha la seguente rappresentazione JSON:

{
  "contexts": {
    "custom": {
      "customer_id": {
        "value": "cust-78901",
        "createTime": "2026-01-01T00:00:00.000Z",
        "updateTime": "2026-01-01T00:00:00.000Z"
      },
      "payment_status": {
        "value": "unpaid",
        "createTime": "2026-01-01T00:00:00.000Z",
        "updateTime": "2026-01-01T00:00:00.000Z"
      },
      "google:annotation:face-detector-v1": {
        "value": "SUCCESS",
        "createTime": "2026-09-29T17:20:00.000Z",
        "updateTime": "2026-09-29T17:20:00.000Z",
        "extendedDataTypeUrl": "type.googleapis.com/google.protobuf.Struct"
      }
    }
  }
}

In questo esempio:

  • customer_id e payment_status sono contesti personalizzati senza dati estesi.
  • google:annotation:face-detector-v1 è un contesto personalizzato generato da Google con dati estesi.

Tutti i contesti possono essere recuperati e utilizzati per filtrare gli elenchi di oggetti in base alle chiavi e ai valori.

Casi d'uso per i contesti degli oggetti

I contesti degli oggetti consentono di classificare, monitorare e arricchire i dati. Le seguenti sezioni descrivono gli scenari di utilizzo dei contesti degli oggetti per gestire diversi tipi di informazioni.

Raggruppare e classificare gli oggetti

Classifica e organizza gli oggetti in bucket e progetti. Utilizza i contesti per taggare i dati in base agli attributi, come l'origine del set di dati, la proprietà o il centro di costo.

  • Esempio 1: assegna il contesto data_classification: PII agli oggetti contenenti informazioni che consentono l'identificazione personale (PII) in modo che possano essere gestiti dalle norme di conformità.

  • Esempio 2: raggruppa le nuove immagini di addestramento durante l'importazione assegnando il contesto batch_id: 2025_Q4_Model_Run per consentire il recupero e il test efficienti del modello.

Monitorare i workflow

Per ottimizzare i workflow personalizzati ed evitare operazioni ridondanti, incorpora le informazioni sullo stato del workflow direttamente negli oggetti per monitorare il loro percorso in una pipeline di elaborazione.

  • Esempio 1: utilizza processing_status: awaiting_review per indicare gli oggetti in attesa dell'approvazione per la release esterna.

  • Esempio 2: utilizza processed_by: analytics_pipeline per impedire al servizio di trattamento dati personalizzati di eseguire nuovamente la scansione dei file che hanno già completato una fase.

Arricchire gli oggetti con un contesto specifico dell'applicazione

Collega informazioni specifiche su un'applicazione o un processo aziendale per fornire contesto e provenienza dei dati aggiuntivi per ogni oggetto.

  • Esempio 1: per un'immagine satellitare, registra i dettagli di acquisizione, ad esempio capture_angle: 45deg_NW, oppure monitora la cronologia del file con lineage: ingested_from_s3.

  • Esempio 2: incorpora i dettagli sui contenuti di un file, ad esempio document_type: service_manual e vehicle_model: f250.

Vantaggi dei contesti degli oggetti

I contesti degli oggetti estendono le funzionalità degli oggetti Cloud Storage. Associando coppie chiave-valore personalizzate direttamente agli oggetti archiviati, puoi ottenere i seguenti vantaggi:

  • Rilevamento dei dati: filtra gli elenchi di oggetti per limitare gli input per i carichi di lavoro solo agli oggetti di interesse.

  • Interoperabilità: supporta l'interoperabilità con i tag degli oggetti di altri fornitori di servizi cloud e semplifica le migrazioni, poiché i contesti degli oggetti accettano valori stringa senza predefinizione.

  • Persistenza dei dati: conserva i dati di contesto durante il ciclo di vita dell'oggetto. Quando copi, riscrivi, componi, sposti o ripristini gli oggetti, i contesti vengono trasferiti automaticamente. Puoi anche eliminare selettivamente i contesti durante le operazioni di copia, riscrittura e composizione utilizzando il dropContextGroups parametro di query (ad esempio, dropContextGroups=custom) se vuoi impedire che vengano trasferiti all'oggetto di destinazione.

  • Controllo della modifica del contesto: definisci chi può aggiungere, modificare o rimuovere i contesti utilizzando le autorizzazioni Identity and Access Management (IAM) per mantenere una traccia di audit.

  • Operazioni batch: gestisci i contesti degli oggetti in blocco su miliardi di oggetti utilizzando le operazioni batch di archiviazione.

  • Analisi collettiva con BigQuery: esegui query e analizza i contesti degli oggetti e i dati estesi (come etichette, riconoscimento facciale e riquadri di delimitazione) nei bucket di archiviazione utilizzando la visualizzazione del catalogo dei contesti degli oggetti (object_contexts_catalog_view) nei set di dati di Storage Insights.

Prezzi

Per i dettagli sui prezzi, consulta Prezzi di Cloud Storage.

Passaggi successivi