Identidade de objeto GCS
01Um nome de objeto pode representar vários estados.
Uma rota Google Cloud Storage segue a semântica de objetos e gerações. Buckets e prefixos definem o âmbito; metadados, gerações, checksums e precondições distinguem trabalho novo, substituições, duplicados e alterações concorrentes.
Bucket, prefixo, geração
Defina projeto, bucket, prefixo, convenções de pastas, regras de inclusão, metadados esperados e se a carga inclui todas as gerações ou apenas o objeto atual. Mantenha as listagens limitadas para tornar trabalho e custo previsíveis.
Repita apenas o estado pretendido
Separe respostas transitórias de erros permanentes de configuração e repita apenas operações cuja idempotência seja compreendida. Precondições de geração, backoff limitado e reconciliação evitam substituir dados recentes ou repetir trabalho concluído.
O checksum fecha a entrega
Acorde nomes de objetos, gerações, verificação de checksums, tipo de conteúdo, classe de armazenamento, retenção, versões, quarentena e limpeza da origem. Estas escolhas definem quando a entrega termina e como comprová-la depois.
Rota Flower consciente de gerações
02Separe descoberta, movimento do conteúdo e mutação.
Flower percorre um âmbito do bucket, inspeciona propriedades, lê em streaming ou por intervalos, copia e gere a classe. O fluxo declarativo acrescenta seleção, validação, linhagem e recuperação.
Inventário com evidência imutável
Registe nome, geração, tamanho, estado dos metadados e checksum que qualificaram o objeto. Uma substituição com o mesmo nome torna-se trabalho novo, não replay ambíguo.
Transmita sem perder identidade
Para conteúdo grande ou transformado, mantenha a identidade no pipeline e valide o destino. Leituras por intervalos devem ficar ligadas a uma geração para evitar misturas.
Classifique resultados de tentativas
Limites e erros temporários admitem backoff limitado. Permissões, precondições falhadas, retenções e gerações inesperadas exigem decisão ou alerta.
Contrato de produção GCS
03Proteja a concorrência sem desperdiçar operações.
A consistência forte reduz incerteza, mas não substitui o contrato. Cache pública, gerações, custos, localizações, classes, retenção e holds alteram a rota.
Política de precondições
Defina quando exigir apenas criação, correspondência de geração ou metageração. Uma falha significa mudança de estado: reconcilie em vez de tratar como erro de rede.
Localização e classe
Escolha localização por latência, resiliência, governação e custo. Preserve ou remapeie a classe de forma deliberada; uma migração não deve colocar dados frios numa classe cara.
Resultados de retenção e hold
Retenção ou hold podem impedir limpeza intencionalmente. Mostre esse estado como evidência de governação, mantenha o objeto reconciliado e evite falsos alarmes permanentes.