Contextos de objetos

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

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

Visão geral

É possível anexar informações descritivas como pares de chave-valor aos objetos do Cloud Storage usando contextos de objeto. Você pode incorporar contextos para melhorar a forma como categoriza, acompanha e pesquisa seus dados. É possível aplicar contextos ao criar novos objetos ou adicioná-los a objetos atuais.

Por exemplo, ao fazer upload de um objeto de fatura, você pode enriquecê-lo com contextos customer_id e payment_status:

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

Casos de uso de contextos de objeto

Os contextos de objeto permitem classificar, acompanhar 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

Classifique e organize objetos em buckets e projetos. Use contextos para marcar dados por atributos, como origem do conjunto de dados, propriedade ou centro de custos.

  • 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 conformidade 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 aos 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 de processamento de dados personalizado verifique novamente arquivos que já concluíram uma etapa.

Enriquecer objetos com contexto específico do aplicativo

Anexe informações específicas sobre um aplicativo ou processo de negócios para fornecer contexto e linhagem de dados adicionais para cada objeto.

  • Exemplo 1: para uma imagem de satélite, registre detalhes de captura, como capture_angle: 45deg_NW, ou acompanhe 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 objeto estendem os recursos dos objetos do Cloud Storage. Ao associar pares de chave-valor personalizados diretamente aos objetos armazenados, você pode alcançar os seguintes benefícios:

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

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

  • Persistência de dados: preserve os dados de contexto durante todo o ciclo de vida do objeto. Ao copiar, regravar, compor, mover ou restaurar objetos, os contextos são transferidos automaticamente. Isso mantém todos os dados contextuais associados vinculados aos objetos, independentemente de mudanças no local ou estado de armazenamento.

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

  • Operações em lote: gerencie contextos de objeto 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 objeto, consulte Preços do Cloud Storage.

A seguir