Cloud Storage 참조로 파일을 업로드한 후 콘텐츠 유형을 업데이트하는 등 파일 메타데이터를 가져오거나 업데이트할 수 있습니다. 또한 추가 파일 메타데이터로 커스텀 키-값 쌍을 저장할 수 있습니다.
파일 메타데이터 가져오기
파일 메타데이터는 name, size, content_type(통칭 MIME 형식) 등의 일반적인 속성뿐 아니라 content_disposition, time_created 등의 비일반적 속성도 포함합니다. GetMetadata 메서드를 사용하여 Cloud Storage 참조에서 이러한 메타데이터를 가져올 수 있습니다.
// Create reference to the file whose metadata we want to retrieveStorageReferenceforest_ref=storage_ref.Child("images/forest.jpg");// Get metadata propertiesFuturefuture=forest_ref.GetMetadata();// Wait for Future to complete...if(future.Error()!=firebase::storage::kErrorNone){// Uh-oh, an error occurred!}else{// We can now retrieve the metadata for 'images/forest.jpg'Metadata*metadata=future.Result();}
파일 메타데이터 업데이트
파일 업로드가 완료된 후 언제든지 UpdateMetadata 메서드를 사용하여 파일 메타데이터를 업데이트할 수 있습니다. 업데이트할 수 있는 속성의 종류는 전체 목록을 참조하세요. 메타데이터에 지정된 속성만 업데이트되며 나머지 속성은
그대로 유지됩니다.
// Create reference to the file whose metadata we want to changefirebase::storage::StorageReferenceforest_ref=storage_ref.child("images/forest.jpg");// Create file metadata to updateMetadatanew_metadata;newMetadata.set_cache_control("public,max-age=300");newMetadata.set_content_type("image/jpeg");// Update metadata propertiesFuturefuture=forest_ref.UpdateMetadata(new_metadata);// Wait for Future to complete...if(future.Error()!=firebase::storage::kErrorNone){// Uh-oh, an error occurred!}else{// We can now retrieve the updated metadata for 'images/forest.jpg'Metadata*metadata=future.Result();}
쓰기 가능한 메타데이터 속성에 빈 문자열을 전달하여 삭제할 수 있습니다.
// Create file metadata with property to deleteStorageMetadatanew_metadata;new_metadata.set_content_type("");// Delete the metadata propertyFuturefuture=forest_ref.UpdateMetadata(new_metadata);// Wait for Future to complete...if(future.Error()!=0){// Uh-oh, an error occurred!}else{// metadata.content_type() should be an empty stringMetadata*metadata=future.Result();}
오류 처리
메타데이터를 가져오거나 업데이트할 때 오류가 발생하는 데에는 파일이 없거나 파일에 대한 액세스 권한이 없는 경우 등 다양한 이유가 있습니다. 오류에 대한 자세한 내용은 문서의 오류 처리 섹션을 참조하세요.
커스텀 메타데이터
커스텀 메타데이터를 std::string 속성이 포함된 std::map로 지정할 수 있습니다.
std::map<std::string,std::string>*custom_metadata=metadata.custom_metadata();custom_metadata->insert(std::make_pair("location","Yosemite, CA, USA");custom_metadata->insert(std::make_pair("activity","Hiking");
커스텀 메타데이터에 각 파일의 앱별 데이터를 저장할 수 있지만 이러한 유형의 데이터를 저장하고 동기화할 때는 Firebase Realtime Database와 같은 데이터베이스를 사용하는 것이 좋습니다.
파일 메타데이터 속성
파일 메타데이터 속성의 전체 목록은 다음과 같습니다.
속성
유형
쓰기 가능
bucket
const char*
아니요
generation
const char*
아니요
metageneration
const char*
아니요
full_path
const char*
아니요
name
const char*
아니요
size
int64_t
아니요
time_created
int64_t
아니요
updated
int64_t
아니요
cache_control
const char*
예
content_disposition
const char*
예
content_encoding
const char*
예
content_language
const char*
예
content_type
const char*
예
download_urls
std::vector<std::string>
아니요
custom_metadata
std::map<std::string, std::string>
예
다음 단계
파일 업로드, 다운로드 및 업데이트도 중요하지만 파일을 삭제할 수도 있어야 합니다. Cloud Storage에서 파일을 삭제하는 방법을 알아보세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["\u003cbr /\u003e\n\nAfter uploading a file to Cloud Storage reference, you can also get\nand update the file metadata, for example to update the content type. Files\ncan also store custom key/value pairs with additional file metadata.\n| **Note:** By default, a Cloud Storage for Firebase bucket requires Firebase Authentication to perform any action on the bucket's data or files. You can change your Firebase Security Rules for Cloud Storage to [allow unauthenticated access for specific situations](/docs/storage/security/rules-conditions#public). However, for most situations, we strongly recommend [restricting access and setting up robust security rules](/docs/storage/security/get-started) (especially for production apps). Note that if you use Google App Engine and have a default Cloud Storage bucket with a name format of `*.appspot.com`, you may need to consider [how your security rules impact access to App Engine files](/docs/storage/gcp-integration#security-rules-and-app-engine-files).\n\nGet File Metadata\n\nFile metadata contains common properties such as `name`, `size`, and\n`content_type` (often referred to as MIME type) in addition to some less common\nones like `content_disposition` and `time_created`. This metadata can be\nretrieved from a Cloud Storage reference using the `GetMetadata`\nmethod. \n\n```c++\n// Create reference to the file whose metadata we want to retrieve\nStorageReference forest_ref = storage_ref.Child(\"images/forest.jpg\");\n\n// Get metadata properties\nFuture future = forest_ref.GetMetadata();\n\n// Wait for Future to complete...\n\nif (future.Error() != firebase::storage::kErrorNone) {\n // Uh-oh, an error occurred!\n} else {\n // We can now retrieve the metadata for 'images/forest.jpg'\n Metadata* metadata = future.Result();\n}\n```\n\nUpdate File Metadata\n\nYou can update file metadata at any time after the file upload completes by\nusing the `UpdateMetadata` method. Refer to the\n[full list](#file_metadata_properties) for more information on what properties\ncan be updated. Only the properties specified in the metadata are updated,\nall others are left unmodified. \n\n```c++\n// Create reference to the file whose metadata we want to change\nfirebase::storage::StorageReference forest_ref = storage_ref.child(\"images/forest.jpg\");\n\n// Create file metadata to update\nMetadata new_metadata;\nnewMetadata.set_cache_control(\"public,max-age=300\");\nnewMetadata.set_content_type(\"image/jpeg\");\n\n// Update metadata properties\nFuture future = forest_ref.UpdateMetadata(new_metadata);\n\n// Wait for Future to complete...\n\nif (future.Error() != firebase::storage::kErrorNone) {\n // Uh-oh, an error occurred!\n} else {\n // We can now retrieve the updated metadata for 'images/forest.jpg'\n Metadata* metadata = future.Result();\n}\n```\n\nYou can delete writable metadata properties by passing the empty string: \n\n```c++\n// Create file metadata with property to delete\nStorageMetadata new_metadata;\nnew_metadata.set_content_type(\"\");\n\n// Delete the metadata property\nFuture future = forest_ref.UpdateMetadata(new_metadata);\n\n// Wait for Future to complete...\n\nif (future.Error() != 0) {\n // Uh-oh, an error occurred!\n} else {\n // metadata.content_type() should be an empty string\n Metadata* metadata = future.Result();\n}\n```\n\nHandle Errors\n\nThere are a number of reasons why errors may occur on getting or updating\nmetadata, including the file not existing, or the user not having permission\nto access the desired file. More information on errors can be found in the\n[Handle Errors](/docs/storage/cpp/handle-errors)\nsection of the docs.\n\nCustom Metadata\n\nYou can specify custom metadata as an `std::map` containing `std::string`\nproperties. \n\n```c++\nstd::map\u003cstd::string, std::string\u003e* custom_metadata = metadata.custom_metadata();\ncustom_metadata-\u003einsert(std::make_pair(\"location\", \"Yosemite, CA, USA\");\ncustom_metadata-\u003einsert(std::make_pair(\"activity\", \"Hiking\");\n```\n\nYou can store app-specific data for each file in custom metadata, but we highly\nrecommend using a database (such as the\n[Firebase Realtime Database](/docs/database)) to store and synchronize this type of\ndata.\n\nFile Metadata Properties\n\nA full list of metadata properties on a file is available below:\n\n| Property | Type | Writable |\n|-----------------------|--------------------------------------|----------|\n| `bucket` | const char\\* | NO |\n| `generation` | const char\\* | NO |\n| `metageneration` | const char\\* | NO |\n| `full_path` | const char\\* | NO |\n| `name` | const char\\* | NO |\n| `size` | int64_t | NO |\n| `time_created` | int64_t | NO |\n| `updated` | int64_t | NO |\n| `cache_control` | const char\\* | YES |\n| `content_disposition` | const char\\* | YES |\n| `content_encoding` | const char\\* | YES |\n| `content_language` | const char\\* | YES |\n| `content_type` | const char\\* | YES |\n| `download_urls` | std::vector\\\u003cstd::string\\\u003e | NO |\n| `custom_metadata` | std::map\\\u003cstd::string, std::string\\\u003e | YES |\n\nNext Steps\n\nUploading, downloading, and updating files is important, but so is being able\nto remove them. Let's learn how to\n[delete files](/docs/storage/cpp/delete-files)\nfrom Cloud Storage."]]
