웹에서 Cloud Storage로 파일 메타데이터 사용

Cloud Storage 참조에 파일을 업로드한 후 파일 메타데이터를 가져오거나 업데이트할 수 있습니다. 예를 들어 콘텐츠 유형을 업데이트할 수 있습니다. 또한 추가 파일 메타데이터로 커스텀 키-값 쌍을 저장할 수 있습니다.

파일 메타데이터 가져오기

파일 메타데이터는 name, size, contentType(통칭 MIME 유형) 등의 일반적인 속성뿐 아니라 contentDisposition 및 timeCreated 등의 비일반적 속성도 포함합니다. getMetadata() 메서드를 사용하여 Cloud Storage 참조에서 이러한 메타데이터를 가져올 수 있습니다. getMetadata()는 전체 메타데이터를 포함하는 Promise를 반환하거나 Promise가 거부되면 오류를 반환합니다.

Web

import { getStorage, ref, getMetadata } from "firebase/storage";

// Create a reference to the file whose metadata we want to retrieve
const storage = getStorage();
const forestRef = ref(storage, 'images/forest.jpg');

// Get metadata properties
getMetadata(forestRef)
  .then((metadata) => {
    // Metadata now contains the metadata for 'images/forest.jpg'
  })
  .catch((error) => {
    // Uh-oh, an error occurred!
  });storage_get_metadata.js

Web

// Create a reference to the file whose metadata we want to retrieve
var forestRef = storageRef.child('images/forest.jpg');

// Get metadata properties
forestRef.getMetadata()
  .then((metadata) => {
    // Metadata now contains the metadata for 'images/forest.jpg'
  })
  .catch((error) => {
    // Uh-oh, an error occurred!
  });file-metadata.js

파일 메타데이터 업데이트

파일 업로드가 완료된 후 언제든지 updateMetadata() 메서드를 사용하여 파일 메타데이터를 업데이트할 수 있습니다. 업데이트할 수 있는 속성의 종류는 전체 목록을 참조하세요. 메타데이터에 지정된 속성만 업데이트되며 나머지 속성은 그대로 유지됩니다. updateMetadata()는 전체 메타데이터를 포함하는 Promise를 반환하거나 Promise가 거부되면 오류를 반환합니다.

Web

import { getStorage, ref, updateMetadata } from "firebase/storage";

// Create a reference to the file whose metadata we want to change
const storage = getStorage();
const forestRef = ref(storage, 'images/forest.jpg');

// Create file metadata to update
const newMetadata = {
  cacheControl: 'public,max-age=300',
  contentType: 'image/jpeg'
};

// Update metadata properties
updateMetadata(forestRef, newMetadata)
  .then((metadata) => {
    // Updated metadata for 'images/forest.jpg' is returned in the Promise
  }).catch((error) => {
    // Uh-oh, an error occurred!
  });storage_update_metadata.js

Web

// Create a reference to the file whose metadata we want to change
var forestRef = storageRef.child('images/forest.jpg');

// Create file metadata to update
var newMetadata = {
  cacheControl: 'public,max-age=300',
  contentType: 'image/jpeg'
};

// Update metadata properties
forestRef.updateMetadata(newMetadata)
  .then((metadata) => {
    // Updated metadata for 'images/forest.jpg' is returned in the Promise
  }).catch((error) => {
    // Uh-oh, an error occurred!
  });file-metadata.js

다음과 같이 메타데이터 속성을 null로 설정하여 삭제할 수 있습니다.

Web

import { getStorage, ref, updateMetadata } from "firebase/storage";

const storage = getStorage();
const forestRef = ref(storage, 'images/forest.jpg');

// Create file metadata with property to delete
const deleteMetadata = {
  contentType: null
};

// Delete the metadata property
updateMetadata(forestRef, deleteMetadata)
  .then((metadata) => {
    // metadata.contentType should be null
  }).catch((error) => {
    // Uh-oh, an error occurred!
  });storage_delete_metadata.js

Web

// Create file metadata with property to delete
var deleteMetadata = {
  contentType: null
};

// Delete the metadata property
forestRef.updateMetadata(deleteMetadata)
  .then((metadata) => {
    // metadata.contentType should be null
  }).catch((error) => {
    // Uh-oh, an error occurred!
  });file-metadata.js

오류 처리

메타데이터를 가져오거나 업데이트할 때 오류가 발생하는 데에는 파일이 없거나 파일에 대한 액세스 권한이 없는 경우 등 다양한 이유가 있습니다. 오류에 대한 자세한 내용은 문서의 오류 처리 섹션을 참조하세요.

커스텀 메타데이터

커스텀 메타데이터를 String 속성이 포함된 객체로 지정할 수 있습니다.

Web

const metadata = {
  customMetadata: {
    'location': 'Yosemite, CA, USA',
    'activity': 'Hiking'
  }
};storage_custom_metadata.js

Web

var metadata = {
  customMetadata: {
    'location': 'Yosemite, CA, USA',
    'activity': 'Hiking'
  }
};file-metadata.js

커스텀 메타데이터를 사용하여 각 파일의 추가적인 앱별 데이터를 저장할 수 있지만 이러한 유형의 데이터를 저장하고 동기화할 때는 Firebase Realtime Database와 같은 데이터베이스를 사용하는 것이 좋습니다.

파일 메타데이터 속성

파일 메타데이터 속성의 전체 목록은 다음과 같습니다.

속성	유형	쓰기 가능
`bucket`	문자열	아니요
`generation`	문자열	아니요
`metageneration`	문자열	아니요
`fullPath`	문자열	아니요
`name`	문자열	아니요
`size`	숫자	아니요
`timeCreated`	문자열	아니요
`updated`	문자열	아니요
`md5Hash`	문자열	upload에서는 예, updateMetadata에서는 아니요
`cacheControl`	문자열	예
`contentDisposition`	문자열	예
`contentEncoding`	문자열	예
`contentLanguage`	문자열	예
`contentType`	문자열	예
`customMetadata`	문자열->문자열 매핑을 포함하는 개체	예

파일 업로드, 다운로드 및 업데이트도 중요하지만 파일을 삭제할 수도 있어야 합니다. Cloud Storage에서 파일을 삭제하는 방법을 알아보세요.