A leitura direta de arquivos no modo Archive permite acessar objetos da classe de armazenamento Archive diretamente, sem precisar restaurá-los previamente. Esse recurso é ideal para cenários como data lakes e álbuns de fotos na cloud, pois oferece acesso em tempo real a dados com frequência de acesso extremamente baixa, mantendo os custos de armazenamento reduzidos e equilibrando custo e eficiência de acesso.
Leitura após restauração versus leitura direta
A tabela a seguir compara a recuperação de dados com e sem a leitura direta de arquivos no modo Archive ativada.
|
Item |
Padrão |
Leitura direta ativada |
|
Método de recuperação |
Restaurar e depois ler |
Leitura direta |
|
Taxa de recuperação① |
Baixa |
Alta |
|
Tempo de recuperação |
Minutos |
Milissegundos |
①Para obter mais informações sobre as taxas de recuperação, consulte Preços do Object Storage Service.
Ativar a leitura direta de arquivos no modo Archive
OSS console
Faça login no OSS console.
No painel de navegação à esquerda, clique em Buckets. Na página exibida, clique no nome do bucket desejado.
No painel de navegação à esquerda, escolha Data Management > Archive Direct Read.
Na página Real-time Access of Archive Objects, ative a opção Real-time Access of Archive Objects.
Na mensagem exibida, clique em OK.
Ossutil
Antes de usar o ossutil, você deve instalá-lo.
-
Execute o comando a seguir para ativar a leitura direta de arquivos no modo Archive em um bucket chamado
examplebucket:ossutil api put-bucket-archive-direct-read --bucket examplebucket --archive-direct-read-configuration "{\"Enabled\":\"true\"}"Para obter mais informações sobre este comando, consulte put-bucket-archive-direct-read.
-
Execute o comando a seguir para verificar se a leitura direta de arquivos no modo Archive está ativada no bucket chamado
examplebucket:ossutil api get-bucket-archive-direct-read --bucket examplebucketPara obter mais informações sobre este comando, consulte get-bucket-archive-direct-read.
API
Caso sua aplicação exija alto nível de personalização, faça solicitações REST API diretamente. Essa abordagem requer a escrita manual de código para calcular assinaturas. Para mais detalhes, consulte PutBucketArchiveDirectRead e GetBucketArchiveDirectRead.
Operações de leitura suportadas
Após ativar a leitura direta de arquivos no modo Archive para um bucket, execute as seguintes operações de leitura em objetos da classe de armazenamento Archive sem precisar restaurá-los:
Consultar registros de acesso
Utilize o Simple Log Service para consultar objetos acessados por meio da leitura direta de arquivos no modo Archive. O campo de log archive_direct_read_size identifica as solicitações desse tipo — ele apresenta o valor - quando o recurso não foi utilizado na requisição.
Modo de varredura (quando o índice do campo archive_direct_read_size não está ativado no Simple Log Service):
* and __topic__: oss_access_log and bucket: bucketname | set session mode=scan; select object where archive_direct_read_size not like '-'
Modo de índice (quando o índice do campo archive_direct_read_size está ativado no Simple Log Service):
* and __topic__: oss_access_log and bucket: bucketname |select object where archive_direct_read_size not like '-'
Consultar tráfego
Para visualizar o volume total de dados recuperados via leitura direta de arquivos no modo Archive:
Modo de varredura:
* and __topic__: oss_access_log and bucket: bucketname | set session mode=scan; select sum(cast(archive_direct_read_size as bigint)) as total_size where archive_direct_read_size != '-'
Modo de índice:
* and __topic__: oss_access_log and bucket: bucketname | select sum(cast(archive_direct_read_size as bigint)) as total_size where archive_direct_read_size != '-'
Permissões
Usuários RAM precisam das permissões oss:PutBucketArchiveDirectRead e oss:GetBucketArchiveDirectRead. Para mais informações, consulte Conceder permissões personalizadas a um usuário RAM.
Limitações
A leitura direta de arquivos no modo Archive aplica-se exclusivamente a objetos da classe de armazenamento Archive. Objetos nas classes Cold Archive ou Deep Cold Archive não são compatíveis com esse recurso.
Se um bucket tiver a leitura direta ativada, o uso de um objeto não restaurado da classe Archive como página inicial ou de erro padrão para hospedagem de site estático resultará em erro 403. Para garantir a acessibilidade das páginas, utilize objetos da classe de armazenamento Standard como páginas iniciais e de erro.
Faturamento
Ao ativar a leitura direta de arquivos no modo Archive para um bucket, a leitura direta de um objeto não restaurado da classe Archive gera cobranças referentes à capacidade de recuperação de dados da leitura direta (RetrievalDataArchiveDirect). A quantidade de dados recuperados por uma solicitação corresponde ao valor do campo de log
archive_direct_read_size. Leituras diretas em objetos já restaurados não geram cobrança de capacidade de recuperação. Para mais detalhes, consulte Taxas de processamento de dados.O volume de dados faturável é definido pelo intervalo de leitura especificado no cabeçalho da solicitação durante o estabelecimento da conexão HTTP. Encerrar a conexão antecipadamente não altera o valor cobrado pela requisição iniciada. Por exemplo, se você solicitar um intervalo de 100 MB a 200 MB, mas interromper a conexão após ler apenas 1 byte, a cobrança ainda corresponderá a todo o intervalo de 100 MB a 200 MB.
Ao usar a leitura direta para redimensionar uma imagem arquivada, o OSS calcula o volume de dados recuperados com base no tamanho da imagem original, e não da imagem processada. Isso significa que a cobrança considera o tamanho da fonte mesmo que o processamento reduza significativamente o arquivo final. Por exemplo, se uma imagem de origem de 1 GB for redimensionada para 100 KB, o volume de dados faturado será de 1 GB.