Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

Cloud Firestore 데이터 모델

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Cloud Firestore는 NoSQL, 문서 지향 데이터베이스입니다. SQL 데이터베이스와 달리 테이블이나 행이 없습니다. 대신 컬렉션 으로 구성된 문서 에 데이터를 저장합니다.

문서 에는 키-값 쌍 세트가 포함되어 있습니다. Cloud Firestore는 작은 문서의 큰 컬렉션을 저장하는 데 최적화되어 있습니다.

모든 문서는 컬렉션에 저장해야 합니다. 문서에는 하위 컬렉션 과 중첩된 개체가 포함될 수 있으며, 둘 다 문자열과 같은 기본 필드나 목록과 같은 복잡한 개체를 포함할 수 있습니다.

컬렉션 및 문서는 Cloud Firestore에서 암시적으로 생성됩니다. 컬렉션 내의 문서에 데이터를 할당하기만 하면 됩니다. 컬렉션이나 문서가 없으면 Cloud Firestore에서 만듭니다.

서류

Cloud Firestore에서 저장 단위는 문서입니다. 문서는 값에 매핑되는 필드가 포함된 간단한 레코드입니다. 각 문서는 이름으로 식별됩니다.

사용자 alovelace 를 나타내는 문서는 다음과 같습니다.

  • 러브레이스

    first : "Ada"
    last : "Lovelace"
    born : 1815

문서의 복잡하고 중첩된 개체를 맵이라고 합니다. 예를 들어 위의 예에서 사용자 이름을 다음과 같이 지도로 구성할 수 있습니다.

  • 러브레이스

    name :
    first : "Ada"
    last : "Lovelace"
    born : 1815

문서가 JSON과 매우 유사하다는 것을 알 수 있습니다. 사실, 그들은 기본적으로 있습니다. 몇 가지 차이점이 있지만(예: 문서가 추가 데이터 유형을 지원하고 크기가 1MB로 제한됨) 일반적으로 문서를 경량 JSON 레코드로 취급할 수 있습니다.

컬렉션

문서는 단순히 문서의 컨테이너인 컬렉션에 있습니다. 예를 들어, 각각 문서로 표시되는 다양한 사용자를 포함하는 users 컬렉션이 있을 수 있습니다.

  • 사용자

    • 러브레이스

      first : "Ada"
      last : "Lovelace"
      born : 1815

    • 어링

      first : "Alan"
      last : "Turing"
      born : 1912

Cloud Firestore는 스키마가 없으므로 각 문서에 입력하는 필드와 해당 필드에 저장하는 데이터 유형을 자유롭게 선택할 수 있습니다. 동일한 컬렉션 내의 문서는 모두 다른 필드를 포함하거나 해당 필드에 다른 유형의 데이터를 저장할 수 있습니다. 그러나 문서를 더 쉽게 쿼리할 수 있도록 여러 문서에서 동일한 필드와 데이터 유형을 사용하는 것이 좋습니다.

컬렉션에는 문서만 포함되어 있습니다. 값이 있는 원시 필드를 직접 포함할 수 없으며 다른 컬렉션을 포함할 수 없습니다. (Cloud Firestore에서 더 복잡한 데이터를 구조화하는 방법에 대한 설명은 계층적 데이터 를 참조하세요.)

컬렉션 내의 문서 이름은 고유합니다. 사용자 ID와 같은 고유한 키를 제공하거나 Cloud Firestore에서 자동으로 임의의 ID를 생성하도록 할 수 있습니다.

컬렉션을 "생성"하거나 "삭제"할 필요가 없습니다. 컬렉션에서 첫 번째 문서를 만든 후 컬렉션이 존재합니다. 컬렉션의 모든 문서를 삭제하면 더 이상 존재하지 않습니다.

참고문헌

Cloud Firestore의 모든 문서는 데이터베이스 내 위치로 고유하게 식별됩니다. 이전 예제는 users 컬렉션 내 alovelace 문서를 보여주었습니다. 코드에서 이 위치를 참조하려면 해당 위치에 대한 참조 를 생성하면 됩니다.

Web version 9

import { doc } from "firebase/firestore";

const alovelaceDocumentRef = doc(db, 'users', 'alovelace');

Web version 8

var alovelaceDocumentRef = db.collection('users').doc('alovelace');
빠른
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
let alovelaceDocumentRef = db.collection("users").document("alovelace")
오브젝티브-C
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
FIRDocumentReference *alovelaceDocumentRef =
    [[self.db collectionWithPath:@"users"] documentWithPath:@"alovelace"];

Java

DocumentReference alovelaceDocumentRef = db.collection("users").document("alovelace");

Kotlin+KTX

val alovelaceDocumentRef = db.collection("users").document("alovelace")

Dart

final alovelaceDocumentRef = db.collection("users").doc("alovelace");
자바
// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.collection("users").document("alovelace");
파이썬
a_lovelace_ref = db.collection(u'users').document(u'alovelace')

Python

a_lovelace_ref = db.collection("users").document("alovelace")
C++
DocumentReference alovelace_document_reference =
    db->Collection("users").Document("alovelace");
노드.js
const alovelaceDocumentRef = db.collection('users').doc('alovelace');
가다
alovelaceRef := client.Collection("users").Doc("alovelace")
PHP

PHP

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

$document = $db->collection('samples/php/users')->document('alovelace');
단일성
DocumentReference documentRef = db.Collection("users").Document("alovelace");
씨#

씨#

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

DocumentReference documentRef = db.Collection("users").Document("alovelace");
루비
document_ref = firestore.col("users").doc("alovelace")

참조는 데이터베이스의 위치를 ​​가리키는 간단한 개체입니다. 데이터의 존재 여부에 관계없이 참조를 생성할 수 있으며 참조 생성은 네트워크 작업을 수행하지 않습니다.

컬렉션 에 대한 참조를 만들 수도 있습니다.

Web version 9

import { collection } from "firebase/firestore";

const usersCollectionRef = collection(db, 'users');

Web version 8

var usersCollectionRef = db.collection('users');
빠른
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
let usersCollectionRef = db.collection("users")
오브젝티브-C
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
FIRCollectionReference *usersCollectionRef = [self.db collectionWithPath:@"users"];

Java

CollectionReference usersCollectionRef = db.collection("users");

Kotlin+KTX

val usersCollectionRef = db.collection("users")

Dart

final usersCollectionRef = db.collection("users");
자바
// Reference to the collection "users"
CollectionReference collection = db.collection("users");
파이썬
users_ref = db.collection(u'users')

Python

users_ref = db.collection("users")
C++
CollectionReference users_collection_reference = db->Collection("users");
노드.js
const usersCollectionRef = db.collection('users');
가다
usersRef := client.Collection("users")
PHP

PHP

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

$collection = $db->collection('samples/php/users');
단일성
CollectionReference collectionRef = db.Collection("users");
씨#

씨#

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

CollectionReference collectionRef = db.Collection("users");
루비
collection_ref = firestore.col "users"

편의를 위해 슬래시( / )로 구분된 경로 구성 요소를 사용하여 문서 또는 컬렉션의 경로를 문자열로 지정하여 참조를 만들 수도 있습니다. 예를 들어 alovelace 문서에 대한 참조를 만들려면 다음을 수행합니다.

Web version 9

import { doc } from "firebase/firestore"; 

const alovelaceDocumentRef = doc(db, 'users/alovelace');

Web version 8

var alovelaceDocumentRef = db.doc('users/alovelace');
빠른
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
let aLovelaceDocumentReference = db.document("users/alovelace")
오브젝티브-C
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
FIRDocumentReference *aLovelaceDocumentReference =
    [self.db documentWithPath:@"users/alovelace"];

Java

DocumentReference alovelaceDocumentRef = db.document("users/alovelace");

Kotlin+KTX

val alovelaceDocumentRef = db.document("users/alovelace")

Dart

final aLovelaceDocRef = db.doc("users/alovelace");
자바
// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.document("users/alovelace");
파이썬
a_lovelace_ref = db.document(u'users/alovelace')

Python

a_lovelace_ref = db.document("users/alovelace")
C++
DocumentReference alovelace_document = db->Document("users/alovelace");
노드.js
const alovelaceDocumentRef = db.doc('users/alovelace');
가다
// Reference to a document with id "alovelace" in the collection "users"
alovelaceRef := client.Doc("users/alovelace")
PHP

PHP

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

$document = $db->document('users/alovelace');
단일성
DocumentReference documentRef = db.Document("users/alovelace");
씨#

씨#

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

DocumentReference documentRef = db.Document("users/alovelace");
루비
document_path_ref = firestore.doc "users/alovelace"

계층적 데이터

Cloud Firestore에서 계층적 데이터 구조가 작동하는 방식을 이해하려면 메시지 및 채팅방이 있는 예시 채팅 앱을 살펴보세요.

다른 대화방을 저장하기 위해 rooms 이라는 컬렉션을 만들 수 있습니다.

  • _북마크 방

    • A

      name : "my chat room"

    • B

      ...

이제 대화방이 있으므로 메시지를 저장하는 방법을 결정하십시오. 대화방 문서에 저장하고 싶지 않을 수 있습니다. Cloud Firestore의 문서는 가벼워야 하며 대화방에는 많은 수의 메시지가 포함될 수 있습니다. 그러나 대화방 문서 내에서 하위 컬렉션으로 추가 컬렉션을 만들 수 있습니다.

하위 컬렉션

이 시나리오에서 메시지를 저장하는 가장 좋은 방법은 하위 컬렉션을 사용하는 것입니다. 하위 컬렉션은 특정 문서와 연결된 컬렉션입니다.

rooms 컬렉션의 모든 회의실 문서에 대해 messages 라는 하위 컬렉션을 만들 수 있습니다.

  • _북마크 방

    • A

      name : "my chat room"

      • 메시지

        • 메시지1

          from : "alex"
          msg : "Hello World!"

        • 메시지2

          ...

    • B

      ...

이 예에서는 다음 코드를 사용하여 하위 컬렉션의 메시지에 대한 참조를 만듭니다.

Web version 9

import { doc } from "firebase/firestore"; 

const messageRef = doc(db, "rooms", "roomA", "messages", "message1");

Web version 8

var messageRef = db.collection('rooms').doc('roomA')
                .collection('messages').doc('message1');
빠른
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
let messageRef = db
    .collection("rooms").document("roomA")
    .collection("messages").document("message1")
오브젝티브-C
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
FIRDocumentReference *messageRef =
    [[[[self.db collectionWithPath:@"rooms"] documentWithPath:@"roomA"]
    collectionWithPath:@"messages"] documentWithPath:@"message1"];

Java

DocumentReference messageRef = db
        .collection("rooms").document("roomA")
        .collection("messages").document("message1");

Kotlin+KTX

val messageRef = db
        .collection("rooms").document("roomA")
        .collection("messages").document("message1")

Dart

final messageRef = db
    .collection("rooms")
    .doc("roomA")
    .collection("messages")
    .doc("message1");
자바
// Reference to a document in subcollection "messages"
DocumentReference document =
    db.collection("rooms").document("roomA").collection("messages").document("message1");
파이썬
room_a_ref = db.collection(u'rooms').document(u'roomA')
message_ref = room_a_ref.collection(u'messages').document(u'message1')

Python

room_a_ref = db.collection("rooms").document("roomA")
message_ref = room_a_ref.collection("messages").document("message1")
C++
DocumentReference message_reference = db->Collection("rooms")
    .Document("roomA")
    .Collection("messages")
    .Document("message1");
노드.js
const messageRef = db.collection('rooms').doc('roomA')
  .collection('messages').doc('message1');
가다
messageRef := client.Collection("rooms").Doc("roomA").
	Collection("messages").Doc("message1")
PHP

PHP

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

$document = $db
    ->collection('rooms')
    ->document('roomA')
    ->collection('messages')
    ->document('message1');
단일성
DocumentReference documentRef = db
	.Collection("Rooms").Document("RoomA")
	.Collection("Messages").Document("Message1");
씨#

씨#

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

DocumentReference documentRef = db
    .Collection("Rooms").Document("RoomA")
    .Collection("Messages").Document("Message1");
루비
message_ref = firestore.col("rooms").doc("roomA").col("messages").doc("message1")

컬렉션과 문서의 교대 패턴에 주목하십시오. 컬렉션과 문서는 항상 이 패턴을 따라야 합니다. 컬렉션의 컬렉션이나 문서의 문서를 참조할 수 없습니다.

하위 컬렉션을 사용하면 데이터를 계층적으로 구조화하여 데이터에 더 쉽게 액세스할 수 있습니다. roomA 의 모든 메시지를 가져오려면 하위 컬렉션 messages 에 대한 컬렉션 참조를 만들고 다른 컬렉션 참조와 마찬가지로 상호 작용할 수 있습니다.

하위 컬렉션의 문서에는 하위 컬렉션도 포함될 수 있으므로 데이터를 추가로 중첩할 수 있습니다. 최대 100레벨까지 데이터를 중첩할 수 있습니다.

,

Cloud Firestore는 NoSQL, 문서 지향 데이터베이스입니다. SQL 데이터베이스와 달리 테이블이나 행이 없습니다. 대신 컬렉션 으로 구성된 문서 에 데이터를 저장합니다.

문서 에는 키-값 쌍 세트가 포함되어 있습니다. Cloud Firestore는 작은 문서의 큰 컬렉션을 저장하는 데 최적화되어 있습니다.

모든 문서는 컬렉션에 저장해야 합니다. 문서에는 하위 컬렉션 과 중첩된 개체가 포함될 수 있으며, 둘 다 문자열과 같은 기본 필드나 목록과 같은 복잡한 개체를 포함할 수 있습니다.

컬렉션 및 문서는 Cloud Firestore에서 암시적으로 생성됩니다. 컬렉션 내의 문서에 데이터를 할당하기만 하면 됩니다. 컬렉션이나 문서가 없으면 Cloud Firestore에서 만듭니다.

서류

Cloud Firestore에서 저장 단위는 문서입니다. 문서는 값에 매핑되는 필드를 포함하는 간단한 레코드입니다. 각 문서는 이름으로 식별됩니다.

사용자 alovelace 를 나타내는 문서는 다음과 같습니다.

  • 러브레이스

    first : "Ada"
    last : "Lovelace"
    born : 1815

문서의 복잡하고 중첩된 개체를 맵이라고 합니다. 예를 들어 위의 예에서 사용자 이름을 다음과 같이 지도로 구성할 수 있습니다.

  • 러브레이스

    name :
    first : "Ada"
    last : "Lovelace"
    born : 1815

문서가 JSON과 매우 유사하다는 것을 알 수 있습니다. 사실, 그들은 기본적으로 있습니다. 몇 가지 차이점이 있지만(예: 문서가 추가 데이터 유형을 지원하고 크기가 1MB로 제한됨) 일반적으로 문서를 경량 JSON 레코드로 취급할 수 있습니다.

컬렉션

문서는 단순히 문서의 컨테이너인 컬렉션에 있습니다. 예를 들어, 각각 문서로 표시되는 다양한 사용자를 포함하는 users 컬렉션이 있을 수 있습니다.

  • 사용자

    • 러브레이스

      first : "Ada"
      last : "Lovelace"
      born : 1815

    • 어링

      first : "Alan"
      last : "Turing"
      born : 1912

Cloud Firestore는 스키마가 없으므로 각 문서에 입력하는 필드와 해당 필드에 저장하는 데이터 유형을 자유롭게 선택할 수 있습니다. 동일한 컬렉션 내의 문서는 모두 다른 필드를 포함하거나 해당 필드에 다른 유형의 데이터를 저장할 수 있습니다. 그러나 문서를 더 쉽게 쿼리할 수 있도록 여러 문서에서 동일한 필드와 데이터 유형을 사용하는 것이 좋습니다.

컬렉션에는 문서만 포함되어 있습니다. 값이 있는 원시 필드를 직접 포함할 수 없으며 다른 컬렉션을 포함할 수 없습니다. (Cloud Firestore에서 더 복잡한 데이터를 구조화하는 방법에 대한 설명은 계층적 데이터 를 참조하세요.)

컬렉션 내의 문서 이름은 고유합니다. 사용자 ID와 같은 고유한 키를 제공하거나 Cloud Firestore에서 자동으로 임의의 ID를 생성하도록 할 수 있습니다.

컬렉션을 "생성"하거나 "삭제"할 필요가 없습니다. 컬렉션에서 첫 번째 문서를 만든 후 컬렉션이 존재합니다. 컬렉션의 모든 문서를 삭제하면 더 이상 존재하지 않습니다.

참고문헌

Cloud Firestore의 모든 문서는 데이터베이스 내 위치로 고유하게 식별됩니다. 이전 예제는 users 컬렉션 내 alovelace 문서를 보여주었습니다. 코드에서 이 위치를 참조하려면 해당 위치에 대한 참조 를 생성하면 됩니다.

Web version 9

import { doc } from "firebase/firestore";

const alovelaceDocumentRef = doc(db, 'users', 'alovelace');

Web version 8

var alovelaceDocumentRef = db.collection('users').doc('alovelace');
빠른
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
let alovelaceDocumentRef = db.collection("users").document("alovelace")
오브젝티브-C
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
FIRDocumentReference *alovelaceDocumentRef =
    [[self.db collectionWithPath:@"users"] documentWithPath:@"alovelace"];

Java

DocumentReference alovelaceDocumentRef = db.collection("users").document("alovelace");

Kotlin+KTX

val alovelaceDocumentRef = db.collection("users").document("alovelace")

Dart

final alovelaceDocumentRef = db.collection("users").doc("alovelace");
자바
// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.collection("users").document("alovelace");
파이썬
a_lovelace_ref = db.collection(u'users').document(u'alovelace')

Python

a_lovelace_ref = db.collection("users").document("alovelace")
C++
DocumentReference alovelace_document_reference =
    db->Collection("users").Document("alovelace");
노드.js
const alovelaceDocumentRef = db.collection('users').doc('alovelace');
가다
alovelaceRef := client.Collection("users").Doc("alovelace")
PHP

PHP

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

$document = $db->collection('samples/php/users')->document('alovelace');
단일성
DocumentReference documentRef = db.Collection("users").Document("alovelace");
씨#

씨#

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

DocumentReference documentRef = db.Collection("users").Document("alovelace");
루비
document_ref = firestore.col("users").doc("alovelace")

참조는 데이터베이스의 위치를 ​​가리키는 간단한 개체입니다. 데이터의 존재 여부에 관계없이 참조를 생성할 수 있으며 참조 생성은 네트워크 작업을 수행하지 않습니다.

컬렉션 에 대한 참조를 만들 수도 있습니다.

Web version 9

import { collection } from "firebase/firestore";

const usersCollectionRef = collection(db, 'users');

Web version 8

var usersCollectionRef = db.collection('users');
빠른
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
let usersCollectionRef = db.collection("users")
오브젝티브-C
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
FIRCollectionReference *usersCollectionRef = [self.db collectionWithPath:@"users"];

Java

CollectionReference usersCollectionRef = db.collection("users");

Kotlin+KTX

val usersCollectionRef = db.collection("users")

Dart

final usersCollectionRef = db.collection("users");
자바
// Reference to the collection "users"
CollectionReference collection = db.collection("users");
파이썬
users_ref = db.collection(u'users')

Python

users_ref = db.collection("users")
C++
CollectionReference users_collection_reference = db->Collection("users");
노드.js
const usersCollectionRef = db.collection('users');
가다
usersRef := client.Collection("users")
PHP

PHP

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

$collection = $db->collection('samples/php/users');
단일성
CollectionReference collectionRef = db.Collection("users");
씨#

씨#

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

CollectionReference collectionRef = db.Collection("users");
루비
collection_ref = firestore.col "users"

편의를 위해 슬래시( / )로 구분된 경로 구성 요소를 사용하여 문서 또는 컬렉션의 경로를 문자열로 지정하여 참조를 만들 수도 있습니다. 예를 들어 alovelace 문서에 대한 참조를 만들려면 다음을 수행합니다.

Web version 9

import { doc } from "firebase/firestore"; 

const alovelaceDocumentRef = doc(db, 'users/alovelace');

Web version 8

var alovelaceDocumentRef = db.doc('users/alovelace');
빠른
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
let aLovelaceDocumentReference = db.document("users/alovelace")
오브젝티브-C
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
FIRDocumentReference *aLovelaceDocumentReference =
    [self.db documentWithPath:@"users/alovelace"];

Java

DocumentReference alovelaceDocumentRef = db.document("users/alovelace");

Kotlin+KTX

val alovelaceDocumentRef = db.document("users/alovelace")

Dart

final aLovelaceDocRef = db.doc("users/alovelace");
자바
// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.document("users/alovelace");
파이썬
a_lovelace_ref = db.document(u'users/alovelace')

Python

a_lovelace_ref = db.document("users/alovelace")
C++
DocumentReference alovelace_document = db->Document("users/alovelace");
노드.js
const alovelaceDocumentRef = db.doc('users/alovelace');
가다
// Reference to a document with id "alovelace" in the collection "users"
alovelaceRef := client.Doc("users/alovelace")
PHP

PHP

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

$document = $db->document('users/alovelace');
단일성
DocumentReference documentRef = db.Document("users/alovelace");
씨#

씨#

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

DocumentReference documentRef = db.Document("users/alovelace");
루비
document_path_ref = firestore.doc "users/alovelace"

계층적 데이터

Cloud Firestore에서 계층적 데이터 구조가 작동하는 방식을 이해하려면 메시지 및 채팅방이 있는 예시 채팅 앱을 살펴보세요.

다른 대화방을 저장하기 위해 rooms 이라는 컬렉션을 만들 수 있습니다.

  • _북마크 방

    • A

      name : "my chat room"

    • B

      ...

이제 대화방이 있으므로 메시지를 저장하는 방법을 결정하십시오. 대화방 문서에 저장하고 싶지 않을 수 있습니다. Cloud Firestore의 문서는 가벼워야 하며 대화방에는 많은 수의 메시지가 포함될 수 있습니다. 그러나 대화방 문서 내에서 하위 컬렉션으로 추가 컬렉션을 만들 수 있습니다.

하위 컬렉션

이 시나리오에서 메시지를 저장하는 가장 좋은 방법은 하위 컬렉션을 사용하는 것입니다. 하위 컬렉션은 특정 문서와 연결된 컬렉션입니다.

rooms 컬렉션의 모든 회의실 문서에 대해 messages 라는 하위 컬렉션을 만들 수 있습니다.

  • _북마크 방

    • A

      name : "my chat room"

      • 메시지

        • 메시지1

          from : "alex"
          msg : "Hello World!"

        • 메시지2

          ...

    • B

      ...

이 예에서는 다음 코드를 사용하여 하위 컬렉션의 메시지에 대한 참조를 만듭니다.

Web version 9

import { doc } from "firebase/firestore"; 

const messageRef = doc(db, "rooms", "roomA", "messages", "message1");

Web version 8

var messageRef = db.collection('rooms').doc('roomA')
                .collection('messages').doc('message1');
빠른
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
let messageRef = db
    .collection("rooms").document("roomA")
    .collection("messages").document("message1")
오브젝티브-C
참고: 이 제품은 watchOS 및 App Clip 대상에서 사용할 수 없습니다.
FIRDocumentReference *messageRef =
    [[[[self.db collectionWithPath:@"rooms"] documentWithPath:@"roomA"]
    collectionWithPath:@"messages"] documentWithPath:@"message1"];

Java

DocumentReference messageRef = db
        .collection("rooms").document("roomA")
        .collection("messages").document("message1");

Kotlin+KTX

val messageRef = db
        .collection("rooms").document("roomA")
        .collection("messages").document("message1")

Dart

final messageRef = db
    .collection("rooms")
    .doc("roomA")
    .collection("messages")
    .doc("message1");
자바
// Reference to a document in subcollection "messages"
DocumentReference document =
    db.collection("rooms").document("roomA").collection("messages").document("message1");
파이썬
room_a_ref = db.collection(u'rooms').document(u'roomA')
message_ref = room_a_ref.collection(u'messages').document(u'message1')

Python

room_a_ref = db.collection("rooms").document("roomA")
message_ref = room_a_ref.collection("messages").document("message1")
C++
DocumentReference message_reference = db->Collection("rooms")
    .Document("roomA")
    .Collection("messages")
    .Document("message1");
노드.js
const messageRef = db.collection('rooms').doc('roomA')
  .collection('messages').doc('message1');
가다
messageRef := client.Collection("rooms").Doc("roomA").
	Collection("messages").Doc("message1")
PHP

PHP

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

$document = $db
    ->collection('rooms')
    ->document('roomA')
    ->collection('messages')
    ->document('message1');
단일성
DocumentReference documentRef = db
	.Collection("Rooms").Document("RoomA")
	.Collection("Messages").Document("Message1");
씨#

씨#

Cloud Firestore 클라이언트 설치 및 생성에 대한 자세한 내용은 Cloud Firestore 클라이언트 라이브러리 를 참조하세요.

DocumentReference documentRef = db
    .Collection("Rooms").Document("RoomA")
    .Collection("Messages").Document("Message1");
루비
message_ref = firestore.col("rooms").doc("roomA").col("messages").doc("message1")

컬렉션과 문서의 교대 패턴에 주목하십시오. 컬렉션과 문서는 항상 이 패턴을 따라야 합니다. 컬렉션의 컬렉션이나 문서의 문서를 참조할 수 없습니다.

하위 컬렉션을 사용하면 데이터를 계층적으로 구조화하여 데이터에 더 쉽게 액세스할 수 있습니다. roomA 의 모든 메시지를 가져오려면 하위 컬렉션 messages 에 대한 컬렉션 참조를 만들고 다른 컬렉션 참조와 마찬가지로 상호 작용할 수 있습니다.

하위 컬렉션의 문서에는 하위 컬렉션도 포함될 수 있으므로 데이터를 추가로 중첩할 수 있습니다. 최대 100레벨까지 데이터를 중첩할 수 있습니다.