웹에서 저장소 참조 만들기

파일은 Google Cloud Storage 버킷에 저장됩니다. 이 버킷의 파일은 로컬 하드 디스크의 파일 시스템 또는 Firebase 실시간 데이터베이스의 데이터와 같이 계층 구조로 표현됩니다. 앱에서 파일에 액세스하려면 파일을 가리키는 참조를 만듭니다. 이러한 참조를 사용하여 데이터 업로드/다운로드, 메타데이터 가져오기/업데이트, 파일 삭제 등을 할 수 있습니다. 참조는 특정 파일을 가리킬 수도 있고, 계층의 상위 노드를 가리킬 수도 있습니다.

Firebase 실시간 데이터베이스를 사용해 보았다면 경로가 매우 친숙하게 느껴질 것입니다. 그러나 파일은 실시간 데이터베이스가 아니라 Google Cloud Storage에 저장된다는 점에 주의하세요.

참조 만들기

파일 업로드, 다운로드, 삭제, 메타데이터 가져오기 또는 업데이트를 수행하려면 작업할 파일을 가리키는 참조를 만들어야 합니다. 참조는 클라우드의 파일을 가리키는 포인터라고 생각할 수 있습니다. 참조는 메모리에 부담을 주지 않으므로 얼마든지 많이 만들 수 있으며 여러 작업에서 재사용할 수도 있습니다.

Firebase 앱의 storage() 서비스에서 참조를 만듭니다. 이 참조는 Cloud Storage 저장소 버킷의 루트를 가리킵니다.

// Get a reference to the storage service, which is used to create references in your storage bucket
var storage = firebase.storage();

// Create a storage reference from our storage service
var storageRef = storage.ref();

기존 참조에 대해 child() 메소드를 사용하여 'images/space.jpg'와 같이 트리에서 하위 위치를 가리키는 참조를 만들 수 있습니다.

// Create a child reference
var imagesRef = storageRef.child('images');
// imagesRef now points to 'images'

// Child references can also take paths delimited by '/'
var spaceRef = storageRef.child('images/space.jpg');
// spaceRef now points to "images/space.jpg"
// imagesRef still points to "images"

parentroot 속성을 사용하여 파일 계층에서 상위로 탐색할 수 있습니다. parent는 한 단계 위로 탐색하며 root는 맨 위로 탐색합니다.

// Parent allows us to move to the parent of a reference
var imagesRef = spaceRef.parent;
// imagesRef now points to 'images'

// Root allows us to move all the way back to the top of our bucket
var rootRef = spaceRef.root;
// rootRef now points to the root

child(), parentroot는 각각 참조를 반환하므로 여러 번 연결할 수 있습니다. 예외적으로 rootparentnull입니다.

// References can be chained together multiple times
var earthRef = spaceRef.parent.child('earth.jpg');
// earthRef points to 'images/earth.jpg'

// nullRef is null, since the parent of root is null
var nullRef = spaceRef.root.parent;

참조 속성

fullPath, namebucket 속성을 사용하여 참조를 조사하면 참조가 가리키는 파일을 자세히 파악할 수 있습니다. 이러한 속성은 파일의 전체 경로, 파일의 이름 및 파일이 저장된 버킷을 가져옵니다.

// Reference's path is: 'images/space.jpg'
// This is analogous to a file path on disk
spaceRef.fullPath;

// Reference's name is the last segment of the full path: 'space.jpg'
// This is analogous to the file name
spaceRef.name;

// Reference's bucket is the name of the storage bucket where files are stored
spaceRef.bucket;

참조 제한사항

참조 경로 및 이름에는 유효한 Unicode 문자를 어떤 순서로든 포함할 수 있지만 다음을 비롯하여 몇 가지 제한사항이 있습니다.

  1. reference.fullPath의 전체 길이는 UTF-8 인코딩 시 1~1024바이트 사이여야 합니다.
  2. 캐리지 리턴 또는 라인 피드 문자는 사용할 수 없습니다.
  3. #, [, ], * 또는 ?Firebase 실시간 데이터베이스 또는 gsutil 등의 다른 도구와 잘 호환되지 않으므로 사용하지 마세요.

전체 예

// Points to the root reference
var storageRef = firebase.storage().ref();

// Points to 'images'
var imagesRef = storageRef.child('images');

// Points to 'images/space.jpg'
// Note that you can use variables to create child values
var fileName = 'space.jpg';
var spaceRef = imagesRef.child(fileName);

// File path is 'images/space.jpg'
var path = spaceRef.fullPath

// File name is 'space.jpg'
var name = spaceRef.name

// Points to 'images'
var imagesRef = spaceRef.parent;

다음으로 Cloud Storage에 파일을 업로드하는 방법을 알아보겠습니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.