이제 네이티브 모드의 Cloud Firestore Enterprise 버전을 사용할 수 있습니다. 자세히 알아보기

서버 클라이언트 라이브러리를 사용하여 Cloud Firestore Enterprise 버전 시작하기

이 빠른 시작에서는 Cloud Firestore를 설정하고 데이터를 추가한 후 핵심 작업 또는 파이프라인 작업을 사용하여 Java, Node.js, Python용 서버 클라이언트 라이브러리를 사용하여 Firebase Console에서 방금 추가한 데이터를 쿼리하는 방법을 보여줍니다.

이러한 클라이언트 라이브러리를 사용하여 데이터베이스에 대한 전체 액세스 권한이 있는 권한 서버 환경을 설정합니다.

Cloud Firestore 데이터베이스 만들기

Firebase 프로젝트를 아직 만들지 않았다면 Firebase Console에서 프로젝트 추가를 클릭한 후 화면에 표시된 안내를 따라 Firebase 프로젝트를 만들거나 기존 Google Cloud 프로젝트에 Firebase 서비스를 추가합니다.
Firebase Console에서 프로젝트를 엽니다. 왼쪽 패널에서 빌드를 펼친 다음 Firestore 데이터베이스를 선택합니다.
데이터베이스 만들기를 클릭합니다.
데이터베이스 모드로 Enterprise를 선택합니다.
작업 모드로 Native 모드의 Firestore를 선택합니다. 이 모드는 핵심 작업과 파이프라인 작업을 지원합니다.

참고: 네이티브 모드 또는 MongoDB 호환 모드로 데이터베이스를 만들 수 있습니다. MongoDB 호환 모드에 대한 자세한 내용은 MongoDB 호환 데이터베이스 만들기 빠른 시작을 참고하세요.
데이터베이스의 위치를 선택합니다.
Cloud Firestore Security Rules의 시작 모드를 선택합니다.

테스트 모드

모바일 및 웹 클라이언트 라이브러리를 시작할 때 유용하지만 모든 사용자가 데이터를 읽고 덮어쓸 수 있습니다. 테스트 완료 후 데이터 보안 섹션을 검토해야 합니다.

웹, Apple 플랫폼 또는 Android SDK를 시작하려면 테스트 모드를 선택하세요.

프로덕션 모드

모바일 및 웹 클라이언트의 모든 읽기 및 쓰기를 거부합니다. 인증된 애플리케이션 서버(Node.js, Python, Java)에서는 사용자의 데이터베이스에 계속 액세스할 수 있습니다.

Cloud Firestore Security Rules의 초기 집합이 기본 Cloud Firestore 데이터베이스에 적용됩니다. 프로젝트에 데이터베이스를 여러 개 만드는 경우 각 데이터베이스에 Cloud Firestore Security Rules를 배포할 수 있습니다.
만들기를 클릭합니다.

Cloud Firestore 및 App Engine: 여러 데이터베이스를 지원하므로 동일한 프로젝트에서 Cloud Firestore와 Datastore를 모두 사용할 수 있습니다. App Engine을 사용하는 경우 Datastore 또는 Firestore Native API가 있는 표준 모드의 (default) 데이터베이스만 App Engine과 함께 사용할 수 있습니다.

Cloud Firestore를 사용 설정하면 Cloud API Manager의 API도 사용 설정됩니다.

개발 환경 설정

필요한 종속 항목 및 클라이언트 라이브러리를 앱에 추가하세요.

Node.js

Firebase Admin SDK를 앱에 추가합니다.
```
npm install firebase-admin --save
```
아래 안내에 따라 사용자 환경에서 적절한 사용자 인증 정보를 사용해 Cloud Firestore를 초기화합니다.

Python

Firebase Admin SDK를 Python 앱에 추가합니다.
```
pip install --upgrade firebase-admin
```
아래 안내에 따라 사용자 환경에서 적절한 사용자 인증 정보를 사용해 Cloud Firestore를 초기화합니다.

자바

Firebase Admin SDK를 앱에 추가합니다.

Gradle 사용:

implementation 'com.google.firebase:firebase-admin:9.7.0'

Maven 사용:

<dependency>
  <groupId>com.google.firebase</groupId>
  <artifactId>firebase-admin</artifactId>
  <version>9.7.0</version>
</dependency>

아래 안내에 따라 사용자 환경에서 적절한 사용자 인증 정보를 사용해 Cloud Firestore를 초기화합니다.

Cloud Firestore 초기화

Cloud Firestore의 인스턴스를 초기화합니다.

Node.js

Cloud Firestore SDK는 환경에 따라 다양한 방식으로 초기화됩니다. 가장 일반적인 방법은 아래와 같습니다. 전체 참조를 보려면 Admin SDK 초기화를 참조하세요.

Cloud Functions에서 초기화

const { initializeApp, applicationDefault, cert } = require('firebase-admin/app');
const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');

initializeApp();

const db = getFirestore();
index.js

Google Cloud에서 초기화

const { initializeApp, applicationDefault, cert } = require('firebase-admin/app');
const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');

initializeApp({
  credential: applicationDefault()
});

const db = getFirestore();index.js

자체 서버에서 초기화
자체 서버(또는 다른 Node.js 환경)에서 Firebase Admin SDK를 사용하려면 서비스 계정을 사용합니다. Google Cloud 콘솔에서 IAM 및 관리자 > 서비스 계정으로 이동합니다. 새 비공개 키를 생성하고 JSON 파일을 저장합니다. 그런 다음 이 파일을 사용하여 SDK를 초기화합니다.
```
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app');
const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
```
```
const serviceAccount = require('./path/to/serviceAccountKey.json');

initializeApp({
  credential: cert(serviceAccount)
});

const db = getFirestore();
index.js
```

Python

Google Cloud에서 초기화

import firebase_admin
from firebase_admin import firestore

# Application Default credentials are automatically created.
app = firebase_admin.initialize_app()
db = firestore.client()firestore.py

기존 애플리케이션 기본 사용자 인증 정보를 사용하여 SDK를 초기화할 수도 있습니다.

import firebase_admin
from firebase_admin import credentials
from firebase_admin import firestore

# Use the application default credentials.
cred = credentials.ApplicationDefault()

firebase_admin.initialize_app(cred)
db = firestore.client()firestore.py

자체 서버에서 초기화

자체 서버에서 Firebase Admin SDK를 사용하려면 서비스 계정을 사용합니다.

Google Cloud 콘솔에서 IAM 및 관리자 > 서비스 계정으로 이동합니다. 새 비공개 키를 생성하고 JSON 파일을 저장합니다. 그런 다음 이 파일을 사용하여 SDK를 초기화합니다.

import firebase_admin
from firebase_admin import credentials
from firebase_admin import firestore

# Use a service account.
cred = credentials.Certificate('path/to/serviceAccount.json')

app = firebase_admin.initialize_app(cred)

db = firestore.client()firestore.py

자바

Google Cloud에서 초기화

import com.google.auth.oauth2.GoogleCredentials;
import com.google.cloud.firestore.Firestore;

import com.google.firebase.FirebaseApp;
import com.google.firebase.FirebaseOptions;

// Use the application default credentials
GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(credentials)
    .setProjectId(projectId)
    .build();
FirebaseApp.initializeApp(options);

Firestore db = FirestoreClient.getFirestore();

자체 서버에서 초기화

자체 서버에서 Firebase Admin SDK를 사용하려면 서비스 계정을 사용합니다.

import com.google.auth.oauth2.GoogleCredentials;
import com.google.cloud.firestore.Firestore;

import com.google.firebase.FirebaseApp;
import com.google.firebase.FirebaseOptions;

// Use a service account
InputStream serviceAccount = new FileInputStream("path/to/serviceAccount.json");
GoogleCredentials credentials = GoogleCredentials.fromStream(serviceAccount);
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(credentials)
    .build();
FirebaseApp.initializeApp(options);

Firestore db = FirestoreClient.getFirestore();

핵심 작업을 사용하여 데이터 추가

데이터 쿼리를 위한 핵심 작업 및 파이프라인 작업을 탐색하려면 핵심 작업을 사용하여 데이터베이스에 데이터를 추가합니다.

Cloud Firestore는 컬렉션에 저장되는 문서에 데이터를 저장합니다. 문서에 데이터를 처음 추가할 때 Cloud Firestore는 암시적으로 컬렉션과 문서를 만듭니다. 컬렉션이나 문서를 명시적으로 만들 필요가 없습니다.

다음 예시 코드를 사용해 새 컬렉션과 문서를 만듭니다.

Node.js

const docRef = db.collection('users').doc('alovelace');

await docRef.set({
  first: 'Ada',
  last: 'Lovelace',
  born: 1815
});index.js

자바

DocumentReference docRef = db.collection("users").document("alovelace");
// Add document data  with id "alovelace" using a hashmap
Map<String, Object> data = new HashMap<>();
data.put("first", "Ada");
data.put("last", "Lovelace");
data.put("born", 1815);
//asynchronously write data
ApiFuture<WriteResult> result = docRef.set(data);
// ...
// result.get() blocks on response
System.out.println("Update time : " + result.get().getUpdateTime());Quickstart.java

Python

doc_ref = db.collection("users").document("alovelace")
doc_ref.set({"first": "Ada", "last": "Lovelace", "born": 1815})snippets.py

핵심 작업을 사용하여 데이터 읽기

Firebase Console의 데이터 뷰어를 사용하여 Cloud Firestore에 추가한 데이터를 빠르게 확인합니다.

'get' 메서드를 사용해 전체 컬렉션을 가져올 수도 있습니다.

Node.js

const snapshot = await db.collection('users').get();
snapshot.forEach((doc) => {
  console.log(doc.id, '=>', doc.data());
});index.js

Python

users_ref = db.collection("users")
docs = users_ref.stream()

for doc in docs:
    print(f"{doc.id} => {doc.to_dict()}")snippets.py

자바

// asynchronously retrieve all users
ApiFuture<QuerySnapshot> query = db.collection("users").get();
// ...
// query.get() blocks on response
QuerySnapshot querySnapshot = query.get();
List<QueryDocumentSnapshot> documents = querySnapshot.getDocuments();
for (QueryDocumentSnapshot document : documents) {
  System.out.println("User: " + document.getId());
  System.out.println("First: " + document.getString("first"));
  if (document.contains("middle")) {
    System.out.println("Middle: " + document.getString("middle"));
  }
  System.out.println("Last: " + document.getString("last"));
  System.out.println("Born: " + document.getLong("born"));
}Quickstart.java

파이프라인 작업을 사용하여 데이터 읽기

이제 파이프라인 쿼리 환경을 핵심 쿼리 환경과 비교할 수 있습니다.

Node.js

const readDataPipeline = db.pipeline()
  .collection("users");

// Execute the pipeline and handle the result
try {
  const querySnapshot = await readDataPipeline.execute();
  querySnapshot.results.forEach((result) => {
    console.log(`${result.id} => ${result.data()}`);
  });
} catch (error) {
    console.error("Error getting documents: ", error);
}test.firestore.js

Python

pipeline = client.pipeline().collection("users")
for result in pipeline.execute():
    print(f"{result.id} => {result.data()}")firestore_pipelines.py

자바

Pipeline pipeline = firestore.pipeline().collection("users");
ApiFuture<Pipeline.Snapshot> future = pipeline.execute();
for (com.google.cloud.firestore.PipelineResult result : future.get().getResults()) {
  System.out.println(result.getId() + " => " + result.getData());
}
// or, asynchronously
pipeline.execute(
    new ApiStreamObserver<com.google.cloud.firestore.PipelineResult>() {
      @Override
      public void onNext(com.google.cloud.firestore.PipelineResult result) {
        System.out.println(result.getId() + " => " + result.getData());
      }

      @Override
      public void onError(Throwable t) {
        System.err.println(t);
      }

      @Override
      public void onCompleted() {
        System.out.println("done");
      }
    });PipelineSnippets.java

다음 단계

다음 주제를 통해 핵심 및 파이프라인 작업에 대해 자세히 알아보세요.

핵심 작업과 파이프라인 작업의 차이점 숙지하기
핵심 작업으로 쿼리하는 방법 자세히 알아보기
파이프라인 작업으로 쿼리하는 방법 자세히 알아보기

서버 클라이언트 라이브러리를 사용하여 Cloud Firestore Enterprise 버전 시작하기 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Cloud Firestore 데이터베이스 만들기

개발 환경 설정

Node.js

Python

자바

Cloud Firestore 초기화

Node.js

Python

자바

핵심 작업을 사용하여 데이터 추가

Node.js

자바

Python

핵심 작업을 사용하여 데이터 읽기

Node.js

Python

자바

파이프라인 작업을 사용하여 데이터 읽기

Node.js

Python

자바

다음 단계

서버 클라이언트 라이브러리를 사용하여 Cloud Firestore Enterprise 버전 시작하기