Contextos de objetos

Este documento descreve como os contextos de objetos permitem anexar informações contextuais aos seus objetos para ajudar você a gerenciar e descobrir dados.

Para saber como anexar e gerenciar contextos de objetos, consulte Usar contextos de objetos.

Visão geral

É possível anexar informações descritivas como pares de chave-valor aos objetos do Cloud Storage usando contextos de objeto. É possível incorporar contextos para melhorar a forma como você categoriza, rastreia e pesquisa seus dados. É possível aplicar contextos ao criar ou adicionar objetos.

Por exemplo, ao fazer upload de um objeto de fatura, é possível enriquecê-lo com contextos de customer_id e payment_status:

{
  "contexts": {
    "custom": {
      "customer_id": {
        "value": "cust-78901"
      },
      "payment_status": {
        "value": "unpaid"
      }
    }
  }
}

Casos de uso para contextos de objetos

Com os contextos de objeto, é possível classificar, rastrear e enriquecer seus dados. As seções a seguir descrevem os cenários de uso de contextos de objeto para gerenciar diferentes tipos de informações.

Agrupar e classificar objetos

Classificar e organizar objetos em buckets e projetos. Use contextos para marcar dados por atributos como origem, propriedade ou centro de custo do conjunto de dados.

  • Exemplo 1: atribua o contexto data_classification: PII a objetos que contêm informações de identificação pessoal (PII) para que as políticas de compliance possam processá-los.

  • Exemplo 2: agrupe novas imagens de treinamento durante a ingestão atribuindo o contexto batch_id: 2025_Q4_Model_Run para permitir testes e recuperação eficientes do modelo.

Acompanhar fluxos de trabalho

Para otimizar fluxos de trabalho personalizados e evitar operações redundantes, incorpore informações de estado do fluxo de trabalho diretamente nos objetos para acompanhar a jornada deles em um pipeline de processamento.

  • Exemplo 1: use processing_status: awaiting_review para indicar objetos pendentes de aprovação de lançamento externo.

  • Exemplo 2: use processed_by: analytics_pipeline para impedir que seu serviço personalizado de processamento de dados verifique novamente arquivos que já concluíram uma etapa.

Enriqueça objetos com contexto específico do aplicativo

Anexe informações específicas sobre um aplicativo ou processo comercial para fornecer mais contexto e linhagem de dados para cada objeto.

  • Exemplo 1: para uma imagem de satélite, registre detalhes de captura, como capture_angle: 45deg_NW, ou rastreie o histórico do arquivo com lineage: ingested_from_s3.

  • Exemplo 2: incorpore detalhes sobre o conteúdo de um arquivo, como document_type: service_manual e vehicle_model: f250.

Benefícios dos contextos de objeto

Os contextos de objetos ampliam os recursos dos objetos do Cloud Storage. Ao associar pares de chave-valor personalizados diretamente a objetos armazenados, você pode aproveitar os seguintes benefícios:

  • Descoberta de dados: filtre as listagens de objetos para limitar as entradas das suas cargas de trabalho apenas aos objetos de interesse.

  • Interoperabilidade: oferece suporte à interoperabilidade com tags de objetos de outros provedores de nuvem e ajuda a simplificar as migrações, já que os contextos de objetos aceitam valores de string sem pré-definição.

  • Persistência de dados: preserva os dados de contexto durante todo o ciclo de vida do objeto. Quando você copia, reescreve, compõe, move ou restaura objetos, os contextos são transferidos automaticamente. Isso mantém todos os dados contextuais associados vinculados aos seus objetos, independente de mudanças no local ou estado de armazenamento.

  • Controle de modificação de contexto: defina quem pode adicionar, mudar ou remover contextos usando as permissões do Identity and Access Management (IAM) para manter um registro de auditoria.

  • Operações em lote: gerencie contextos de objetos em massa em bilhões de objetos usando operações em lote de armazenamento.

Preços

Para mais informações sobre as taxas de uso e armazenamento de contextos de objetos, consulte Preços do Cloud Storage.

A seguir