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

Com os contextos de objetos, é possível anexar informações descritivas como pares de chave-valor aos objetos do Cloud Storage. É possível incorporar contextos aos objetos para melhorar a forma de categorizar, rastrear e pesquisar seus dados. É possível aplicar contextos ao criar novos objetos ou adicionar contextos a objetos atuais.

Por exemplo, ao fazer upload de um objeto de fatura, é possível enriquecê-lo com contextos 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 objetos, é 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.

Enriquecer 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 objetos

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: os contextos de objetos ajudam a filtrar as listagens de objetos, limitando as entradas para cargas de trabalho apenas aos objetos de interesse.

  • Interoperabilidade: os contextos de objetos aceitam valores de string sem pré-definição para oferecer suporte à interoperabilidade com tags de objetos de outros provedores de nuvem e simplificar as migrações.

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

  • Controle do gerenciamento de identidade e acesso sobre a modificação de contexto: use as permissões do gerenciamento de identidade e acesso (IAM) para definir quem pode adicionar, mudar ou remover contextos e manter um registro de auditoria confiável.

Preços

Durante o pré-lançamento, os contextos de objetos são oferecidos sem custos financeiros. Após o término da prévia, uma taxa de armazenamento adicional será aplicada aos contextos de objetos. Os detalhes de preços vão estar disponíveis quando o período de prévia terminar.

A seguir