Firestore는 자동 확장, 고성능, 간편한 애플리케이션 개발을 위해 설계된 NoSQL 문서 데이터베이스입니다. Datastore의 최신 버전이며 Datastore에 비해 여러 가지 부분이 개선되었습니다.
Datastore 모드의 Firestore(Datastore)는 서버 사용 사례 및 App Engine에 최적화되어 있으므로 App Engine 앱에서 주로 사용하는 데이터베이스에는 Datastore를 사용하는 것이 좋습니다. 기본 모드의 Firestore는 모바일 및 실시간 알림 사용 사례에 가장 유용합니다. Firestore 모드에 대한 자세한 내용은 Native 모드와 Datastore 모드 중 선택을 참조하세요.
이 문서에서는 Cloud 클라이언트 라이브러리를 사용하여 Datastore 모드 데이터베이스에서 데이터를 저장하고 검색하는 방법을 설명합니다.
기본 요건 및 설정
환경 및 프로젝트를 설정하여 App Engine에서 앱이 구조화되는 방법을 알아봅니다. 이 문서에 설명된 샘플 애플리케이션을 실행할 때 필요하므로 프로젝트 ID를 기록해 둡니다.
저장소 복제
샘플을 다운로드(복제)합니다.
프로젝트 구성 수정 및 종속 항목 설정
애플리케이션 코드
index.yaml 파일 사용
샘플 앱은 쿼리를 수행합니다. 보다 정교한 Datastore 모드 쿼리를 위해서는 색인이 한 개 이상 필요하며, 앱과 함께 업로드하는 index.yaml 파일에서 지정해야 합니다. 이 파일은 수동으로 만들거나 로컬에서 앱을 테스트하는 동안 자동으로 생성될 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eFirestore in Datastore mode is a NoSQL document database optimized for server use cases and App Engine, making it ideal for applications primarily used within App Engine.\u003c/p\u003e\n"],["\u003cp\u003eFirestore in Native mode is better suited for mobile applications and those requiring real-time notifications, offering a different set of functionalities compared to Datastore mode.\u003c/p\u003e\n"],["\u003cp\u003eUsing Datastore mode queries often requires defining indexes in an \u003ccode\u003eindex.yaml\u003c/code\u003e file, which can be created manually or generated automatically during local testing of your application.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the Datastore mode emulator for local development and testing of applications, allowing for a simulated environment before deployment.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive information on Datastore mode, including optimizations and core concepts, can be found in the Firestore in Datastore mode documentation.\u003c/p\u003e\n"]]],[],null,["# Use Firestore in Datastore mode (Datastore)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nGo Java Node.js PHP Python Ruby .NET Custom\n\nFirestore is a NoSQL document database built for automatic scaling,\nhigh performance, and ease of application development. It is the newest version\nof Datastore and introduces several improvements over\nDatastore.\nBecause [Firestore in Datastore mode (Datastore)](/datastore/docs)\nis optimized for server use cases and for App Engine, we recommend using\nDatastore for databases that will be used primarily by\nApp Engine apps. Firestore in Native mode is most useful for\nmobile and real-time notification use cases. For more information about\nFirestore modes, see [Choosing between Native Mode and\nDatastore mode](/datastore/docs/firestore-or-datastore).\n\nThis document describes how to use the\n[Cloud Client Libraries](/datastore/docs/reference/libraries) to store and\nretrieve data in a Datastore mode database.\n\nPrerequisites and setup\n-----------------------\n\n- [Set up your environment and project](/appengine/docs/flexible/setting-up-environment) to understand how apps are structured in App Engine. Write down and save your project ID, because you will need it to run the sample application described in this document.\n\nClone the repository\n--------------------\n\nDownload (clone) the sample:\n\n\u003cbr /\u003e\n\nEdit project configuration and set dependencies\n-----------------------------------------------\n\n\u003cbr /\u003e\n\nApplication code\n----------------\n\n\nUsing `index.yaml` files\n------------------------\n\nThe sample app performs queries. More elaborate Datastore mode queries require one or more [indexes](/datastore/docs/concepts/indexes), which you must specify in an [`index.yaml` file](/appengine/docs/flexible/configuring-datastore-indexes-with-index-yaml) that you upload along with your app. This file may be created manually, or generated automatically while testing your app locally.\n\nLocal testing\n-------------\n\nIf you need to develop and test your application locally, you can [use the\nDatastore mode emulator](/datastore/docs/tools/datastore-emulator).\n\nFor more information\n--------------------\n\nFor complete information on Datastore mode, including\noptimizations and concepts, see the\n[Firestore in Datastore mode documentation](/datastore/docs/overview)."]]