Apple 플랫폼에서 데이터 목록 다루기

FIRDatabaseReference 가져오기

데이터베이스에서 데이터를 읽거나 쓰려면 FIRDatabaseReference 인스턴스가 필요합니다.

Swift

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
var ref: DatabaseReference!

ref = Database.database().reference()

Objective-C

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
@property (strong, nonatomic) FIRDatabaseReference *ref;

self.ref = [[FIRDatabase database] reference];

목록 읽기 및 쓰기

데이터 목록에 추가

멀티 사용자 애플리케이션에서 목록에 데이터를 추가하려면 childByAutoId 메서드를 사용합니다. childByAutoId 메서드는 지정된 Firebase 참조에 새 하위 항목이 추가될 때마다 고유 키를 생성합니다. 목록의 새 요소마다 이러한 자동 생성 키를 사용하면 여러 클라이언트에서 쓰기 충돌 없이 동시에 같은 위치에 하위 요소를 추가할 수 있습니다. childByAutoId가 생성하는 고유 키는 타임스탬프에 기반하므로 목록 항목은 시간순으로 자동 정렬됩니다.

childByAutoId 메서드가 반환하는 새 데이터에 대한 참조를 사용하여 하위 요소의 자동 생성 키 값을 가져오거나 하위 데이터를 설정할 수 있습니다. childByAutoId 참조에 대해 getKey를 호출하면 자동 생성 키가 반환됩니다.

이러한 자동 생성 키를 사용하면 데이터 구조의 평면화 작업이 단순해집니다. 자세한 내용은 데이터 팬아웃 예시를 참조하세요.

하위 이벤트 수신 대기

하위 이벤트는 노드의 하위 요소에서 발생하는 특정 작업에 대응하여 트리거됩니다. 하위 요소가 childByAutoId 메서드를 통해 새로 추가되거나 updateChildValues 메서드를 통해 업데이트되는 경우가 그 예입니다.

이벤트 유형 일반적인 용도
FIRDataEventTypeChildAdded 항목 목록을 검색하거나 항목 목록에 대한 추가를 수신 대기합니다. 이 이벤트는 기존 하위 요소마다 한 번씩 트리거된 후 지정된 경로에 하위 요소가 새로 추가될 때마다 다시 트리거됩니다. 리스너에는 새 하위 요소의 데이터를 포함하는 스냅샷이 전달됩니다.
FIRDataEventTypeChildChanged 목록의 항목에 대한 변경사항을 수신 대기합니다. 이 이벤트는 하위 노드가 수정될 때마다 트리거됩니다. 여기에는 하위 노드의 하위 요소에 대한 수정이 포함됩니다. 이벤트 리스너에 전달되는 스냅샷에는 하위 요소의 업데이트된 데이터가 포함됩니다.
FIRDataEventTypeChildRemoved 목록의 항목 삭제를 수신 대기합니다. 이 이벤트는 바로 아래 하위 요소가 삭제될 때 트리거됩니다. 콜백 블록에 전달되는 스냅샷에는 삭제된 하위 요소의 데이터가 포함됩니다.
FIRDataEventTypeChildMoved 순서가 지정된 목록의 항목 순서 변경사항을 수신 대기합니다. 이 이벤트는 업데이트로 인해 하위 요소가 재정렬될 때마다 트리거됩니다. queryOrderedByChild 또는 queryOrderedByValue로 정렬된 데이터에 사용됩니다.

이러한 메서드는 데이터베이스의 특정 노드에 대한 변경사항을 수신 대기하는 데 유용할 수 있습니다. 예를 들어 아래와 같이 소셜 블로깅 앱은 이러한 메서드를 함께 사용하여 게시물의 댓글 활동을 모니터링할 수 있습니다.

Swift

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
// Listen for new comments in the Firebase database
commentsRef.observe(.childAdded, with: { (snapshot) -> Void in
  self.comments.append(snapshot)
  self.tableView.insertRows(
    at: [IndexPath(row: self.comments.count - 1, section: self.kSectionComments)],
    with: UITableView.RowAnimation.automatic
  )
})
// Listen for deleted comments in the Firebase database
commentsRef.observe(.childRemoved, with: { (snapshot) -> Void in
  let index = self.indexOfMessage(snapshot)
  self.comments.remove(at: index)
  self.tableView.deleteRows(
    at: [IndexPath(row: index, section: self.kSectionComments)],
    with: UITableView.RowAnimation.automatic
  )
})

Objective-C

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
// Listen for new comments in the Firebase database
[_commentsRef
              observeEventType:FIRDataEventTypeChildAdded
              withBlock:^(FIRDataSnapshot *snapshot) {
                [self.comments addObject:snapshot];
                [self.tableView insertRowsAtIndexPaths:@[
                  [NSIndexPath indexPathForRow:self.comments.count - 1 inSection:kSectionComments]
                ]
                                      withRowAnimation:UITableViewRowAnimationAutomatic];
              }];
// Listen for deleted comments in the Firebase database
[_commentsRef
 observeEventType:FIRDataEventTypeChildRemoved
 withBlock:^(FIRDataSnapshot *snapshot) {
   int index = [self indexOfMessage:snapshot];
   [self.comments removeObjectAtIndex:index];
   [self.tableView deleteRowsAtIndexPaths:@[[NSIndexPath indexPathForRow:index inSection:kSectionComments]]
                         withRowAnimation:UITableViewRowAnimationAutomatic];
 }];

값 이벤트 수신 대기

데이터 목록 읽기에 권장되는 방법은 하위 이벤트를 수신 대기하는 것이지만 상황에 따라서는 목록 참조의 값 이벤트를 수신 대기하는 방법이 유용합니다.

데이터 목록에 FIRDataEventTypeValue 관찰자를 연결하면 전체 데이터 목록이 단일 DataSnapshot으로 반환되며, 이를 루프 처리하여 개별 하위 요소에 액세스할 수 있습니다.

쿼리에 일치하는 항목이 단 하나여도 스냅샷은 목록으로 표시됩니다. 다만 항목이 1개일뿐입니다. 항목에 액세스하려면 결과를 루프 처리해야 합니다.

Swift

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
_commentsRef.observe(.value) { snapshot in
  for child in snapshot.children {
    ...
  }
}

Objective-C

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
[_commentsRef
              observeEventType:FIRDataEventTypeValue
              withBlock:^(FIRDataSnapshot *snapshot) {
                // Loop over children
                NSEnumerator *children = [snapshot children];
                FIRDataSnapshot *child;
                while (child = [children nextObject]) {
                  // ...
                }
              }];

하위 추가 이벤트를 추가로 수신 대기하는 대신 한 번의 작업으로 목록의 모든 하위 요소를 가져오려는 경우 이 패턴이 유용할 수 있습니다.

데이터 정렬 및 필터링

실시간 데이터베이스의 FIRDatabaseQuery 클래스를 사용하여 키, 값 또는 하위 요소 값으로 정렬된 데이터를 검색할 수 있습니다. 정렬된 결과를 특정 개수로 필터링하거나 키 또는 값 범위에 따라 필터링할 수도 있습니다.

데이터 정렬

정렬된 데이터를 검색하려면 우선 정렬 기준 메서드 중 하나를 지정하여 결과를 어떤 순서로 정렬할지 결정합니다.

메서드 용도
queryOrderedByKey 하위 키에 따라 결과를 정렬합니다.
queryOrderedByValue 하위 값에 따라 결과를 정렬합니다.
queryOrderedByChild 지정된 하위 키 또는 중첩된 하위 경로의 값에 따라 결과를 정렬합니다.

정렬 기준 메서드는 한번에 하나만 사용할 수 있습니다. 동일한 쿼리에서 정렬 기준 메서드를 여러 번 호출하면 오류가 발생합니다.

다음 예제에서는 별표 개수를 기준으로 사용자의 최상위 글 목록을 검색하는 방법을 보여 줍니다.

Swift

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
// My top posts by number of stars
let myTopPostsQuery = ref.child("user-posts").child(getUid()).queryOrdered(byChild: "starCount")

Objective-C

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
// My top posts by number of stars
FIRDatabaseQuery *myTopPostsQuery = [[[self.ref child:@"user-posts"]
                                      child:[super getUid]]
                                     queryOrderedByChild:@"starCount"];

이 쿼리는 사용자 ID를 기준으로 데이터베이스 경로에서 사용자의 글을 검색하고 각 글의 별표 수에 따라 정렬합니다. 이와 같이 ID를 색인 키로 사용하는 기법을 데이터 팬아웃이라고 합니다. 자세한 내용은 데이터베이스 구조화를 참조하세요.

queryOrderedByChild 메서드를 호출할 때는 결과를 정렬하는 기준이 될 하위 키를 지정합니다. 이 예시에서는 글이 각 글의 "starCount" 하위 요소 값에 따라 정렬됩니다. 다음과 같은 데이터가 있다면 중첩된 하위 요소에 따라 쿼리를 정렬할 수도 있습니다.

"posts": {
  "ts-functions": {
    "metrics": {
      "views" : 1200000,
      "likes" : 251000,
      "shares": 1200,
    },
    "title" : "Why you should use TypeScript for writing Cloud Functions",
    "author": "Doug",
  },
  "android-arch-3": {
    "metrics": {
      "views" : 900000,
      "likes" : 117000,
      "shares": 144,
    },
    "title" : "Using Android Architecture Components with Firebase Realtime Database (Part 3)",
    "author": "Doug",
  }
},

이 예시에서는 queryOrderedByChild 호출에서 중첩된 하위 요소에 대한 상대 경로를 지정하여 metrics 키 아래에 중첩된 값에 따라 목록 요소를 정렬할 수 있습니다.

Swift

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
 
let postsByMostPopular = ref.child("posts").queryOrdered(byChild: "metrics/views")

Objective-C

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
 
FIRDatabaseQuery *postsByMostPopular = [[ref child:@"posts"] queryOrderedByChild:@"metrics/views"];

다른 데이터 유형을 정렬하는 방법에 대한 자세한 내용은 쿼리 데이터 정렬 방법을 참조하세요.

데이터 필터링

데이터를 필터링하려면 제한 또는 범위 메서드를 정렬 기준 메서드와 조합하여 쿼리를 작성합니다.

메서드 용도
queryLimitedToFirst 정렬된 결과 목록의 시작 부분부터 반환할 최대 항목 수를 설정합니다.
queryLimitedToLast 정렬된 결과 목록의 맨 끝 부분부터 반환할 최대 항목 수를 설정합니다.
queryStartingAtValue 선택한 정렬 기준 메서드에 따라 지정된 키 또는 값보다 크거나 같은 항목을 반환합니다.
queryStartingAfterValue 선택한 정렬 기준 메서드에 따라 지정된 키 또는 값보다 큰 항목을 반환합니다.
queryEndingAtValue 선택한 정렬 기준 메서드에 따라 지정된 키 또는 값보다 작거나 같은 항목을 반환합니다.
queryEndingBeforeValue 선택한 정렬 기준 메서드에 따라 지정된 키 또는 값보다 작은 항목을 반환합니다.
queryEqualToValue 선택한 정렬 기준 메서드에 따라 지정된 키 또는 값과 동일한 항목을 반환합니다.

정렬 기준 메서드와 달리 여러 개의 제한 또는 범위 함수를 조합할 수 있습니다. 예를 들어 queryStartingAtValuequeryEndingAtValue 메서드를 조합하여 결과를 지정된 값 범위로 제한할 수 있습니다.

결과 수 제한

queryLimitedToFirstqueryLimitedToLast 메서드를 사용하여 특정 콜백에서 동기화할 하위 요소의 최대 개수를 설정할 수 있습니다. 예를 들어 queryLimitedToFirst를 사용하여 제한을 100개로 설정하면 처음에 최대 100개의 FIRDataEventTypeChildAdded 콜백만 수신합니다. Firebase 데이터베이스에 저장된 항목이 100개 미만이면 각 항목에 FIRDataEventTypeChildAdded 콜백이 호출됩니다.

항목이 변경됨에 따라 쿼리에 새로 포함되는 항목에 대해 FIRDataEventTypeChildAdded 콜백, 쿼리에서 제외되는 항목에 대해 FIRDataEventTypeChildRemoved 콜백이 수신되며 총 개수는 100개로 유지됩니다.

다음 예시는 예시 블로깅 앱이 모든 사용자의 글 중에서 최근 100개의 목록을 검색하는 방법을 보여줍니다.

Swift

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
// Last 100 posts, these are automatically the 100 most recent
// due to sorting by push() keys
let recentPostsQuery = (ref?.child("posts").queryLimited(toFirst: 100))!

Objective-C

참고: 이 Firebase 제품은 앱 클립 대상에서는 사용할 수 없습니다.
// Last 100 posts, these are automatically the 100 most recent
// due to sorting by push() keys
FIRDatabaseQuery *recentPostsQuery = [[self.ref child:@"posts"] queryLimitedToFirst:100];

키 또는 값으로 필터링

queryStartingAtValue, queryStartingAfterValue, queryEndingAtValue, queryEndingBeforeValue, queryEqualToValue를 사용하여 쿼리의 시작, 종료, 동일 지점을 임의로 선택할 수 있습니다. 이 메서드는 특정 값을 갖는 하위 요소로 데이터를 페이지로 나누거나 항목을 찾는 데 유용합니다.

쿼리 데이터의 순서

이 섹션에서는 FIRDatabaseQuery 클래스의 각 정렬 순서 메서드에 따라 데이터를 정렬하는 방법을 설명합니다.

queryOrderedByKey

queryOrderedByKey를 사용하여 데이터를 정렬하는 경우 데이터가 키에 따라 오름차순으로 반환됩니다.

  1. 키가 32비트 정수로 파싱될 수 있는 하위 요소가 맨 처음에 나오며 오름차순으로 정렬됩니다.
  2. 키가 문자열 값인 하위 요소가 그다음에 나오며 오름차순(사전순)으로 정렬됩니다.

queryOrderedByValue

queryOrderedByValue를 사용하면 하위 요소가 값에 따라 정렬됩니다. 정렬 기준은 queryOrderedByChild와 동일하며, 지정된 하위 키의 값 대신 노드의 값이 사용된다는 점이 다릅니다.

queryOrderedByChild

queryOrderedByChild를 사용하면 지정된 하위 키를 포함하는 데이터가 다음과 같이 정렬됩니다.

  1. 지정된 하위 키의 값이 nil인 하위 요소가 맨 처음에 옵니다.
  2. 지정된 하위 키의 값이 false인 하위 요소가 그다음에 옵니다. 값이 false인 하위 요소가 여러 개인 경우 키에 따라 사전순으로 정렬됩니다.
  3. 지정된 하위 키의 값이 true인 하위 요소가 그다음에 옵니다. 값이 true인 하위 요소가 여러 개인 경우 키에 따라 사전순으로 정렬됩니다.
  4. 숫자 값이 있는 하위 요소가 그다음에 나오며 오름차순으로 정렬됩니다. 지정된 하위 노드의 숫자 값이 동일한 하위 요소가 여러 개면 키에 따라 정렬됩니다.
  5. 숫자 다음에는 문자열이 나오며 사전순, 오름차순으로 정렬됩니다. 지정된 하위 노드의 값이 동일한 하위 요소가 여러 개면 키에 따라 사전순으로 정렬됩니다.
  6. 마지막으로 객체가 나오며 키에 따라 사전순, 오름차순으로 정렬됩니다.

리스너 분리

ViewController를 벗어나도 관찰자는 데이터 동기화를 자동으로 중지하지 않습니다. 관찰자를 적절히 삭제하지 않으면 데이터가 계속 로컬 메모리와 동기화되고 이벤트 핸들러 클로저에서 캡처된 모든 객체가 유지되므로 메모리 누수가 발생할 수 있습니다. 관찰자가 더 이상 필요하지 않으면 연결된 FIRDatabaseHandleremoveObserverWithHandle 메서드에 전달하여 삭제하세요.

참조에 콜백 블록을 추가하면 FIRDatabaseHandle이 반환됩니다. 이 핸들을 사용하여 콜백 블록을 삭제할 수 있습니다.

하나의 데이터베이스 참조에 여러 리스너를 추가하면 이벤트가 발생할 때 각 리스너가 모두 호출됩니다. 해당 위치에서의 데이터 동기화를 중지하려면 removeAllObservers 메서드를 호출하여 특정 위치의 모든 관찰자를 삭제해야 합니다.

리스너에서 removeObserverWithHandle 또는 removeAllObservers를 호출해도 하위 노드에 등록된 리스너는 자동으로 삭제되지 않습니다. 이러한 참조 또는 핸들을 추적하여 삭제해야 합니다.

다음 단계