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

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

파일 메타데이터 가져오기

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

웹 모듈식 API

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!
  });

웹 네임스페이스화된 API

// 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!
  });

파일 메타데이터 업데이트

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

웹 모듈식 API

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!
  });

웹 네임스페이스화된 API

// 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!
  });

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

웹 모듈식 API

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!
  });

웹 네임스페이스화된 API

// 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!
  });

오류 처리

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

커스텀 메타데이터

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

웹 모듈식 API

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

웹 네임스페이스화된 API

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

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

파일 메타데이터 속성

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

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

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