폴더 정보

Cloud Storage는 데이터를 구성하는 다양한 방법을 제공하며 폴더는 이 프로세스에서 중요한 역할을 합니다. 사용 가능한 다양한 폴더 유형을 이해하면 특정 요구에 가장 적합한 폴더를 선택하는 데 도움이 됩니다.

이 페이지에서는 계층적 네임스페이스가 사용 설정된 경우 버킷 내에서 폴더가 작동하는 방식에 중점을 두고 Cloud Storage의 다양한 폴더 유형을 간략히 설명합니다.

폴더 유형

Cloud Storage에는 3가지 주요 폴더 유형이 있습니다.

  • 시뮬레이션된 폴더: 일반적인 Cloud Storage 버킷은 플랫 네임스페이스의 객체를 구성합니다. Google Cloud 콘솔과 Google Cloud CLI를 사용하면 파일 트리를 모방한 폴더를 시뮬레이션하여 버킷의 데이터를 구성할 수 있습니다. 시뮬레이션된 폴더에 대한 자세한 내용은 시뮬레이션된 폴더를 참조하세요.

  • 폴더: 계층적 네임스페이스가 사용 설정된 버킷에서 객체 또는 다른 폴더가 포함된 실제 폴더를 만들 수 있습니다. 폴더 이름 바꾸기 및 폴더 나열과 같은 작업도 수행할 수 있습니다. 계층 구조 및 폴더 관리 작업은 데이터 집약적인 파일 지향 워크로드의 성능, 일관성, 관리를 개선합니다.

  • 관리형 폴더: 관리형 폴더를 사용하면 객체에 세분화된 액세스 제어를 적용하여 데이터에 대한 보안 및 제어를 강화할 수 있습니다. 계층적 네임스페이스의 사용 설정 여부와 관계없이 버킷에서 관리형 폴더를 사용할 수 있습니다. 관리형 폴더에 대한 자세한 내용은 관리형 폴더를 참조하세요.

폴더 개요

폴더는 계층적 네임스페이스가 사용 설정된 버킷에 리소스로 존재합니다. 파일 시스템과 비슷한 구조로 폴더 내에서 객체를 구성할 수 있습니다. Cloud Storage는 폴더 만들기, 삭제, 이름 바꾸기, 나열은 및 폴더 메타데이터 검색과 같은 작업을 할 수 있도록 하는 API를 제공합니다.

폴더 메타데이터

폴더의 메타데이터에는 폴더에 대한 구조화된 정보가 포함됩니다. 폴더 메타데이터에 대한 자세한 내용은 Cloud Storage JSON API 참고 문서의 Folder 리소스를 참조하세요.

폴더 메타데이터의 주요 구성요소는 다음과 같습니다.

  • bucket: 폴더가 있는 버킷의 이름입니다. 예를 들면 my-bucket입니다.
  • id: 버킷 내 폴더의 고유 식별자입니다. 예를 들면 hns-bucket/dir1/입니다.
  • kind: 리소스 유형입니다. 폴더의 경우 이 값은 항상 storage#folder입니다.
  • name: 폴더의 이름입니다. 예를 들면 dir1/입니다.
  • selfLink: Cloud Storage API의 폴더를 참조하는 URL입니다.
  • timeCreated: 폴더가 생성된 타임스탬프입니다. 예를 들면 2023-05-05T16:32:08.878000+00:00입니다.
  • updated: 폴더가 최종 업데이트된 타임스탬프입니다. 예를 들면 2024-05-06T16:32:08.878000+00:00입니다.

고려사항

폴더를 만들 때 다음 사항을 고려하세요.

  • 객체 및 폴더 이름: 계층적 네임스페이스가 사용 설정된 버킷은 선행 및 후행 슬래시(/) 또는 연속 슬래시가 있는 항목을 포함하여 모든 유효한 객체 이름을 지원합니다. 객체 이름의 각 슬래시(/)는 폴더를 나타냅니다. 다음 표에서는 객체 이름과 폴더 계층 구조 내 해당 위치 간의 관계 예시를 보여줍니다.

    객체 이름 폴더 계층 구조 내 위치
    foo.txt 모든 버킷에는 루트 폴더가 포함됩니다. foo.txt 객체는 버킷의 루트 폴더에 있습니다.
    dir1/foo.txt foo.txt 객체는 dir1/라는 최상위 폴더 내에 있습니다. 최상위 폴더는 루트 폴더와 다릅니다.
    dir1/ dir1/와 같이 객체 이름의 후행 슬래시는 객체가 폴더 내에 있음을 나타냅니다. 이 예시에서 객체 이름 dir1/는 상위 폴더 이름 dir1/와 동일합니다.
    dir1//foo.txt foo.txt 객체는 dir1/의 하위 폴더인 dir1//라는 두 번째 계층 폴더에 있습니다.
  • 최대 폴더 깊이: 계층적 네임스페이스가 사용 설정된 버킷은 50단계의 최대 폴더 깊이를 지원합니다. 따라서 객체 이름에 슬래시(/)는 50개를 초과할 수 없습니다.

  • 자동 폴더 생성: 새 객체를 만들면 객체 경로에 지정된 존재하지 않는 폴더가 자동으로 생성됩니다. 예를 들어 이름이 dir1/foo.txt인 객체를 만들면 dir1/ 폴더가 아직 없는 경우 자동으로 생성됩니다.

다음 단계

직접 사용해 보기

Google Cloud를 처음 사용하는 경우 계정을 만들어 실제 시나리오에서 Cloud Storage의 성능을 평가할 수 있습니다. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

Cloud Storage 무료로 사용해 보기