Sobre as pastas

O Cloud Storage oferece várias maneiras de organizar os dados, e as pastas desempenham um papel importante nesse processo. Entender os diferentes tipos de pastas disponíveis pode ajudar você a escolher a mais adequada para suas necessidades específicas.

Nesta página, você terá uma visão geral dos diferentes tipos de pasta no Cloud Storage, com foco em como as pastas funcionam em buckets quando o namespace hierárquico está ativado.

Tipos de pasta

No Cloud Storage, existem três tipos principais de pastas:

  • Pastas simuladas: um bucket típico do Cloud Storage organiza objetos em um namespace simples. Com o console do Google Cloud e a CLI do Google Cloud, é possível simular pastas que imitam a árvore de arquivos para ajudar você a organizar os dados no bucket. Para mais informações sobre pastas simuladas, consulte Pastas simuladas.

  • Pastas: em um bucket com o namespace hierárquico ativado, é possível criar pastas que contenham objetos ou outras pastas. Você também pode realizar operações como renomear e listar pastas. A estrutura hierárquica e as operações de gerenciamento de pastas melhoram o desempenho, a consistência e o gerenciamento de cargas de trabalho orientadas a arquivos e com o uso intensivo de dados.

  • Pastas gerenciadas: as pastas gerenciadas permitem aplicar acesso granular aos objetos, melhorando a segurança e o controle sobre os dados. Você pode usar pastas gerenciadas em buckets com ou sem namespace hierárquico ativado. Para mais informações sobre as pastas gerenciadas, consulte as Pastas gerenciadas.

Visão geral das pastas

As pastas existem como um recurso em buckets com namespace hierárquico ativado. Você pode organizar objetos dentro das pastas em uma estrutura semelhante a um sistema de arquivos. O Cloud Storage oferece APIs de gerenciamento de pastas que permitem operações como criar, excluir, renomear e listar pastas, além de recuperar os metadados da pasta.

Metadados da pasta

Os metadados de uma pasta contêm informações estruturadas sobre ela. Para informações detalhadas sobre metadados de pasta, consulte o recurso Folder na documentação de referência da API JSON do Cloud Storage.

Os principais componentes dos metadados de uma pasta são:

  • bucket: o nome do bucket em que a pasta está. Por exemplo, my-bucket.
  • id: um identificador exclusivo da pasta no bucket. Por exemplo, hns-bucket/dir1/.
  • kind: o tipo de recurso. Para uma pasta, esse valor é sempre storage#folder.
  • name: o nome da pasta. Por exemplo, dir1/.
  • selfLink: um URL que faz referência à pasta na API Cloud Storage.
  • timeCreated: o carimbo de data/hora em que a pasta foi criada. Por exemplo, 2023-05-05T16:32:08.878000+00:00.
  • updated: o carimbo de data/hora da última atualização do recurso. Por exemplo, 2024-05-06T16:32:08.878000+00:00.

Considerações

Ao criar pastas, considere o seguinte:

  • Nomes de objetos e pastas: buckets com namespace hierárquico ativado oferecem suporte a todos os nomes de objeto válidos, incluindo aqueles com barras iniciais e finais (/) ou barras consecutivas. Cada barra encaminhada (/) em um nome de objeto representa uma pasta. A tabela a seguir mostra exemplos da relação entre nomes de objetos e seu local correspondente na hierarquia de pastas:

    Nome do objeto Local na hierarquia de pastas
    foo.txt Todo bucket possui uma pasta raiz. O objeto foo.txt fica na pasta raiz do bucket.
    dir1/foo.txt O objeto foo.txt fica em uma pasta de nível superior chamada dir1/. A pasta de nível superior é diferente da pasta raiz.
    dir1/ A barra à direita em nomes de objetos, como dir1/ indica que o objeto está na pasta. Neste exemplo, o nome do objeto dir1/ é igual ao nome da pasta mãe dir1/.
    dir1//foo.txt O objeto foo.txt reside em uma pasta de segundo nível chamada dir1//, uma pasta filha de dir1/.

  • Profundidade máxima da pasta: buckets com namespace hierárquico ativado dão suporte a uma profundidade de pasta máxima de 50. Como resultado, os nomes de objetos não podem ter mais de 50 barras (/).

  • Tamanho máximo do nome da pasta: 512 bytes (codificado em UTF-8).

  • Criação automática de pastas: a criação de um novo objeto cria automaticamente pastas inexistentes especificadas no caminho do objeto. Por exemplo: criar um objeto chamado dir1/foo.txt cria automaticamente a pasta dir1/, se ela ainda não existir.

A seguir

Faça um teste

Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho do Cloud Storage em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Faça uma avaliação gratuita do Cloud Storage