파일은 Cloud Storage 버킷에 저장됩니다. 이 이 버킷에 있는 파일은 파일 시스템 또는 Firebase Realtime Database의 데이터에 저장할 수 있습니다. 파일을 가리키는 참조를 만들면 앱에 액세스 권한이 부여됩니다. 이러한 참조를 사용하여 데이터 업로드 또는 다운로드, 메타데이터 가져오기 또는 업데이트, 파일 삭제 등을 수행할 수 있습니다. 참조는 특정 파일을 가리키거나 계층 구조에서 보다 상위 노드를 가리킬 수도 있습니다.
Firebase Realtime Database를 사용한 경우 이 경로는 매우 익숙할 것입니다. 하지만 파일 데이터는 Realtime Database가 아니라 Cloud Storage입니다.
참조 만들기
파일 업로드, 다운로드, 삭제, 메타데이터 가져오기 또는 업데이트를 하려면 참조를 만듭니다. 참조는 클라우드의 파일을 가리키는 포인터로 생각하면 됩니다. 참조는 메모리에 부담을 주지 않으므로 원하는 만큼 만들 수 있으며 여러 작업에서 재사용할 수도 있습니다.
GetReferenceFromUrl()
메서드를 호출하고 gs://<your-cloud-storage-bucket>
형식의 URL을 전달하면 Firebase 앱의 storage
서비스에서 참조가 생성됩니다. 이 URL은
Firebase 콘솔의 스토리지 섹션.
// Get a reference to the storage service, using the default Firebase App Storage* storage = Storage::GetInstance(app); // Create a Cloud Storage reference from our storage service StorageReference storage_ref = storage->GetReferenceFromUrl("gs://<your-cloud-storage-bucket>");
기존 참조에 child
메서드를 사용하여 'images/space.jpg'
와 같이 트리에서 하위 위치를 가리키는 참조를 만들 수 있습니다.
// Create a child reference // images_ref now points to "images" StorageReference images_ref = storage_ref.Child("images"); // Child references can also take paths delimited by '/' // space_ref now points to "images/space.jpg" // images_ref still points to "images" StorageReference space_ref = storage_ref.Child("images/space.jpg"); // This is equivalent to creating the full reference StorageReference space_ref = storage.GetReferenceFromUrl("gs://<your-cloud-storage-bucket>/images/space.jpg");
참조로 탐색하기
Parent
및 Root
메서드를 사용하여 파일 계층에서 상위로 탐색할 수도 있습니다. Parent
는 한 단계 위로 탐색하며 Root
는 맨 위로 탐색합니다.
// Parent allows us to move to the parent of a reference // images_ref now points to 'images' StorageReference images_ref = space_ref.Parent(); // Root allows us to move all the way back to the top of our bucket // root_ref now points to the root StorageReference root_ref = space_ref.Root();
Child
, Parent
, Root
는 각각 참조를 반환하므로 여러 번 연결할 수 있습니다. 다만 Root
의 Parent
는 잘못된 StorageReference
이므로 예외입니다.
// References can be chained together multiple times // earth_ref points to "images/earth.jpg" StorageReference earth_ref = space_ref.Parent().Child("earth.jpg"); // null_ref is null, since the parent of root is an invalid StorageReference StorageReference null_ref = space_ref.Root().Parent();
참조 메서드
full_path
, name
, bucket
메서드로 참조를 조사하여 참조가 가리키는 파일을 자세히 파악할 수 있습니다. 이러한 메서드는 파일의 전체 경로, 이름, 버킷을 가져옵니다.
// Reference's path is: "images/space.jpg" // This is analogous to a file path on disk space_ref.full_path(); // Reference's name is the last segment of the full path: "space.jpg" // This is analogous to the file name space_ref.name(); // Reference's bucket is the name of the Cloud Storage bucket where files are stored space_ref.bucket();
참조 제한사항
참조 경로 및 이름에는 유효한 유니코드 문자를 어떤 순서로든 포함할 수 있지만 다음을 비롯하여 몇 가지 제한사항이 있습니다.
- reference.fullPath의 전체 길이는 UTF-8 인코딩 시 1~1,024바이트 사이여야 합니다.
- 캐리지 리턴 또는 라인 피드 문자는 사용할 수 없습니다.
#
,[
,]
,*
또는?
는 다음과 잘 작동하지 않으므로 사용하지 않습니다. 기타 도구(예: Firebase Realtime Database) 또는 gsutil
전체 예시
Storage* storage = Storage::GetInstance(app); // Points to the root reference StorageReference storage_ref = storage->GetReferenceFromUrl("gs://<your-bucket-name>"); // Points to "images" StorageReference images_ref = storage_ref.Child("images"); // Points to "images/space.jpg" // Note that you can use variables to create child values std::string filename = "space.jpg"; StorageReference space_ref = images_ref.Child(filename); // File path is "images/space.jpg" std::string path = space_ref.full_path() // File name is "space.jpg" std::string name = space_ref.name() // Points to "images" StorageReference images_ref = space_ref.Parent();
다음 단계
다음으로 Cloud Shell에서 파일 업로드 Cloud Storage입니다.