하나 이상의 상위 문서가 없는 경우에도 문서는 존재할 수 있습니다. 예를 들어 /mycoll/mydoc/mysubcoll/mysubdoc 경로에 있는 문서는 상위 문서 /mycoll/mydoc이 없는 경우에도 존재할 수 있습니다. Firestore 데이터 뷰어에는 다음과 같이 존재하지 않는 상위 문서가 표시됩니다.
존재하지 않는 상위 문서의 문서 ID는 컬렉션의 문서 목록에서 기울임꼴로 표시됩니다.
존재하지 않는 상위 문서의 정보 패널에서 데이터 뷰어는 문서가 존재하지 않는다고 표시합니다.
데이터 필터링
필드 값과 ==, !-, >, >=, <, <=, in, not-in, array-contains, array-contains-any 조건에 따라 컬렉션의 문서를 필터링할 수 있습니다. 예를 들어 firstname 필드 값이 Sam인 문서만 표시할 수 있습니다. 컬렉션 필터를 적용하려면 다음 안내를 따르세요.
ID가 동일한 모든 컬렉션을 쿼리하려면 컬렉션 그룹을 선택합니다. 컬렉션 그룹 필드에 컬렉션 그룹 ID를 입력합니다.
지정한 컬렉션이나 컬렉션 그룹의 문서가 자동으로 테이블에 표시됩니다.
쿼리에 추가를 클릭하여 반환된 문서 모음을 필터링합니다. 기본적으로 쿼리 빌더는 WHERE 절을 추가합니다. 드롭다운과 텍스트 필드를 사용하여 이 절을 수정하거나 사용 가능한 다른 절 중 하나로 변경할 수 있습니다. 더 복잡한 쿼리를 계속 빌드하려면 쿼리에 추가를 클릭합니다.
쿼리 절을 삭제하려면 삭제 버튼 delete을 클릭합니다. 모든 쿼리 절을 삭제하려면 지우기를 클릭합니다.
실행을 클릭하여 데이터베이스에서 결과를 검색합니다.
쿼리 요구사항 및 제한사항
쿼리 빌더를 사용할 때는 쿼리에 대한 다음 요구사항과 제한사항에 유의하세요.
모든 쿼리는 1개 이상의 색인에서 지원해야 합니다. 데이터베이스가 쿼리를 지원할 색인을 찾을 수 없는 경우 필요한 색인을 빌드할 수 있는 링크가 포함된 오류가 반환됩니다.
ORDER BY 절은 WHERE 절의 필드와 일치해야 하며 순서도 동일해야 합니다. 기본적으로 결과는 문서 ID를 기준으로 정렬됩니다. 같음(==) 이외의 필드로 필터링하면 해당 필드에 ORDER BY 절을 추가합니다.
범위(<, <=, >, >=)와 같지 않음(!=, not-in) 쿼리 절은 모두 동일한 필드에서 필터링되어야 합니다.
[[["이해하기 쉬움","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)"],[],[],null,["# Manage Firestore with the console\n=================================\n\nYou can manage Firestore through the following actions in the\nGoogle Cloud console:\n\n- View, query, add, edit, and delete data.\n- Manage indexes.\n\n| **Note:** To manage your Security Rules, use the [Firebase console](https://firebase.google.com/docs/firestore/using-console).\n\nView data\n---------\n\nYou can view all your Firestore data in the Google Cloud console. From\nthe Firestore data viewer, click on a document or collection to\nopen the data nested within that item.\n\n1. In the Google Cloud console, go to the **Databases** page.\n\n [Go to Databases](https://console.cloud.google.com/firestore/databases)\n2. Select the required database from the list of databases.\n\n3. In the navigation menu, click **Firestore Studio**.\n\n### Open a specific path\n\nTo open a document or collection at a specific path, use the **Edit path**\nbutton create:\n\n### Non-existent ancestor documents\n\nA document can exist even if one or more its ancestors don't\nexist. For example, the document at path\n`/mycoll/mydoc/mysubcoll/mysubdoc` can exist even if the ancestor document\n`/mycoll/mydoc` does not. The Firestore data viewer displays\nnon-existent ancestor documents as follows:\n\n- In a collection's list of documents, the document IDs of non-existent ancestor documents are *italicized*.\n- In a non-existent ancestor document's information panel, the data viewer points out that the document does not exist.\n\n| **Warning:** Even though non-existent ancestor documents appear in the console, they do not appear in queries and snapshots. You must create the document to include it in query results.\n\n### Filter data\n\nYou can filter documents in a collection based on field value and the\n`==`, `!-`, `\u003e`, `\u003e=`, `\u003c`, `\u003c=`, `in`, `not-in`, `array-contains`,\n`array-contains-any` conditions. For example, you can display only documents\nwhere the value of field `firstname` equals `Sam`. To apply a collection filter:\n\n1. Click the filter button filter_list next to a collection ID:\n\n2. From the **Add filters** menu, select a document field, a filter condition,\n and a sort order.\n\n3. Click **Apply**.\n\nTo remove a collection filter, open the same menu and click **Clear filter**.\n\nQuery data\n----------\n\nYou can query for documents in the ***Query Builder*** tab of the\nFirestore Studio page.\n\n1. In the Google Cloud console, go to the **Databases** page.\n\n [Go to Databases](https://console.cloud.google.com/firestore/databases)\n2. Select the required database from the list of databases.\n\n3. In the navigation menu, click **Firestore Studio**.\n\n4. Click the **Query Builder** tab.\n\n5. Select a [query scope](/firestore/docs/concepts/index-overview#query_scopes).\n\n Select ***Collection*** to query a single collection. In the text field,\n enter a path to a collection.\n\n Select ***Collection group*** to query all collections with the same\n ID. In the ***Collection group*** field, enter a collection group ID.\n\n The table will automatically display documents from the specified collection\n or collection group.\n6. Click ***Add to query*** to filter the returned set of documents. By default,\n the Query Builder adds a `WHERE` clause. You can\n modify this clause using the dropdowns and text fields or change to one\n of the other available clauses. To continue building more complex\n queries, click ***Add to query***.\n\n To remove a query clause, click it's remove button\n delete. To remove all query clauses,\n click ***Clear***.\n | **Note:** Queries must meet Firestore requirements and limitations for queries. Otherwise, the query fails and the page returns an error that describes why the query failed.\n7. Click ***Run*** to retrieve results from your database.\n\n| **Tip:** Queries that you run are stored in your browser history. During the session, you can move forward and back within the browser to access recent queries. You can bookmark queries that you want to access often or to share with others.\n\n### Query requirements and limitations\n\nAs you use the Query Builder, keep in mind the following requirements and\nlimitations for queries.\n\n- All queries must be supported by one more indexes. If the database cannot find\n an index to support the query, it will return an error that contains a link to\n build the required index.\n\n- `ORDER BY` clauses must match the fields in the `WHERE` clauses and come in\n the same order. By default, results are ordered by document ID. If you filter\n by any other field with anything other than an equality (`==`), add an\n `ORDER BY` clause for that field.\n\n- Range (`\u003c`, `\u003c=`, `\u003e`, `\u003e=`) and not equals (`!=`, `not-in`) query clauses\n must all filter on the same field.\n\nFor additional limitations, see\n[Query limitations](/firestore/docs/query-data/queries#query_limitations).\n\nManage data\n-----------\n\nIn Firestore, you store data in documents and organize your\ndocuments into collections. Before you start adding data, learn more about the\n[Firestore data model](./data-model).\n\nYou can add, edit, and delete documents and collections from the Firebase\nconsole. To manage your data from the GCP console,\ngo to the **Firestore Studio** page:\n\n1. In the Google Cloud console, go to the **Databases** page.\n\n [Go to Databases](https://console.cloud.google.com/firestore/databases)\n2. Select the required database from the list of databases.\n\n3. In the navigation menu, click **Firestore Studio**.\n\n| **Note:** Read, write, and delete operations performed in the console count towards your Firestore usage.\n\n### Add data\n\n1. Click **Start Collection**.\n2. Enter a collection ID. Enter a document ID. Firestore will generate document ID, but you can overwrite for a specific document ID. Add fields for the data in your document.\n3. Click **Save**. Your new collection and document appear in the data viewer.\n4. To add more documents to the collection, click **Add Document**.\n\n### Edit data\n\n1. Click on a collection to view its documents, then click on a document to view its fields and subcollections.\n2. Click on a field to edit its value. To add fields or subcollections to the selected document, click **Add Field** or **Start Collection**.\n\n### Delete data\n\nYou can delete documents or collections from the data viewer.\n| **Note:** In some cases, deleting a large number of documents might cause the data viewer to load slowly or to return a timeout error. This applies to delete operations performed through the data viewer and elsewhere.\n\nTo delete a collection:\n\n1. Select the collection you want to delete.\n2. Click the menu icon at the top of the documents column, then click **Delete collection**.\n\nTo delete a document:\n\n1. Select the document you want to delete.\n2. Click the menu icon at the top of the document details column. Select **Delete document** or **Delete document fields**.\n\nDeleting a document deletes all of the nested data in that document, including\nany subcollections.\n\nDeleting a document's fields does not delete its subcollections. Although empty,\nthe document still exists and can appear in query results.\n\nTo delete a specific field in a document:\n\n1. Select the document to view its fields.\n2. Click the delete icon beside the field you want to delete.\n\nManage Firestore Security Rules\n-------------------------------\n\nYou can view your [Firestore Security Rules](/firestore/docs/security/get-started)\nfrom the Google Cloud console. To edit or delete your ruleset, enable Firebase, and\n[use the Firebase CLI or Firebase console](/firestore/docs/security/get-started#deploying_rules).\n\n### Enabling Firebase\n\nTo edit your Firestore Security Rules, you must\nenable Firebase for your Google Cloud project. If Firebase is not enabled,\nyou can enable Firebase from the ***Security Rules*** page:\n\nThe Firestore Security Rules feature is closely integrated with Firebase Auth\nand the Firebase SDKs (Web, Android, Apple platforms). For more on Firebase and\nFirestore, see\n[getting started with Firebase](/firestore/docs/client/get-firebase).\n\n### View Security Rules\n\nTo view your Firestore Security Rules from the Google Cloud console, go to the\n***Security Rules*** page:\n\n1. In the Google Cloud console, go to the **Databases** page.\n\n [Go to Databases](https://console.cloud.google.com/firestore/databases)\n2. Select the required database from the list of databases.\n\n3. In the navigation menu, click **Security Rules**.\n\n### Edit Security Rules\n\nTo edit or delete your Firestore Security Rules,\n[use the Firebase CLI or Firebase console](/firestore/docs/security/get-started#deploying_rules).\nIn the Firebase console, go to the [**Rules** tab](https://console.firebase.google.com/project/_/firestore/rules)\nin the **Firestore in Native Mode** section. Learn\nmore about [setting up and customizing rules](./security/get-started).\n\nManage indexes\n--------------\n\nTo create new indexes for your queries and manage existing indexes from the\nFirebase console, go to the\n[**Indexes** tab](https://console.firebase.google.com/project/_/firestore/indexes)\nin the **Firestore in Native Mode** section. Learn more about [managing indexes](./query-data/indexing)."]]
