Firestore 스튜디오(Standard 버전) 사용
콘솔Google Cloud 에서 다음 작업을 통해 Firestore Standard 버전을 관리할 수 있습니다.
- 데이터 보기, 쿼리, 추가, 편집, 삭제
- 색인 관리
- 보안 규칙 관리
데이터 보기
콘솔 Google Cloud 에서 모든 Firestore Standard 버전 데이터를 볼 수 있습니다. Firestore Standard 버전 데이터 뷰어에서 문서나 컬렉션을 클릭하여 해당 항목에서 중첩된 데이터를 엽니다.
Google Cloud 콘솔에서 데이터베이스 페이지로 이동합니다.
데이터베이스 목록에서 필요한 데이터베이스를 선택합니다.
탐색 메뉴에서 Firestore 스튜디오 를 클릭합니다.
특정 경로 열기
특정 경로의 문서나 컬렉션을 열려면 경로 수정 버튼 을 사용하세요.
패널 설정 구성
Firestore 스튜디오에서 데이터 뷰어의 환경설정을 구성할 수 있습니다. 이 환경설정은 콘솔 뷰에만 영향을 미치며 데이터베이스 메타데이터는 변경되지 않습니다.
패널 설정을 구성하려면 다음 안내를 따르세요.
데이터 뷰어 툴바에서 패널 설정 을 클릭합니다.
프로젝트 패널 설정 패널에서 다음 옵션을 구성합니다.
- 존재하지 않는 상위 요소 표시: 문서 목록에 존재하지 않는 상위 문서 를 표시할지 전환합니다. 이 설정은 기본적으로 사용 설정되어 있습니다.
- 실시간 업데이트 사용 설정: 문서가 변경될 때 실시간 업데이트를 수신할지 전환합니다. 이 설정은 기본적으로 사용 설정되어 있습니다. 실시간 업데이트를 사용 중지하면 읽기 작업을 줄여 비용을 절감할 수 있습니다.
저장 을 클릭합니다.
존재하지 않는 상위 문서
하나 이상의 상위 요소가 존재하지 않더라도 문서는 존재할 수 있습니다. 예를 들어 경로
/mycoll/mydoc/mysubcoll/mysubdoc의 문서는 상위 문서
/mycoll/mydoc이 존재하지 않더라도 존재할 수 있습니다.
기본적으로 Firestore Standard 버전 데이터 뷰어에는 다음과 같이 존재하지 않는 상위 문서가 표시됩니다.
- 컬렉션의 문서 목록에서 존재하지 않는 상위 문서의 문서 ID는 기울임꼴 로 표시됩니다.
- 존재하지 않는 상위 문서 정보 패널의 데이터 뷰어에 문서가 존재하지 않는다고 표시됩니다.
컬렉션 문서 목록에서 존재하지 않는 상위 문서를 숨기려면 존재하지 않는 상위 요소 표시를 패널 설정에서 사용 중지합니다.
데이터 필터링
필드 값과 ==, !-, >, >=, <, <=, in, not-in, array-contains, array-contains-any 조건에 따라 컬렉션의 문서를 필터링할 수 있습니다. 예를 들어 필드 firstname 값이 Sam인 문서만 표시할 수 있습니다.
컬렉션 필터를 적용하려면 다음 안내를 따르세요.
컬렉션 ID 옆에 있는 필터 버튼 을 클릭합니다.
필터 추가 메뉴에서 문서 필드, 필터 조건, 정렬 순서를 선택합니다.
적용 을 클릭합니다.
컬렉션 필터를 삭제하려면 같은 메뉴를 열고 필터 지우기를 클릭합니다.
데이터 쿼리
Firestore 스튜디오 페이지의 쿼리 빌더 탭에서 문서를 쿼리할 수 있습니다.
콘솔 Google Cloud 에서 데이터베이스 페이지로 이동합니다.
데이터베이스 목록에서 필요한 데이터베이스를 선택합니다.
탐색 메뉴에서 Firestore 스튜디오 를 클릭합니다.
쿼리 빌더 탭을 클릭합니다.
쿼리 범위를 선택합니다.
단일 컬렉션을 쿼리하려면 컬렉션을 선택합니다. 텍스트 필드에 컬렉션 경로를 입력합니다.
ID가 동일한 모든 컬렉션을 쿼리하려면 컬렉션 그룹을 선택합니다. 컬렉션 그룹 필드에 컬렉션 그룹 ID를 입력합니다.
지정한 컬렉션이나 컬렉션 그룹의 문서가 자동으로 테이블에 표시됩니다.
쿼리에 추가를 클릭하여 반환된 문서 모음을 필터링합니다. 기본적으로 쿼리 빌더는
WHERE절을 추가합니다. 드롭다운과 텍스트 필드를 사용하여 이 절을 수정하거나 사용 가능한 다른 절 중 하나로 변경할 수 있습니다. 더 복잡한 쿼리를 계속 빌드하려면 쿼리에 추가를 클릭합니다.쿼리 절을 삭제하려면 삭제 버튼 을 클릭합니다. 모든 쿼리 절을 삭제하려면 지우기 를 클릭합니다.
실행을 클릭하여 데이터베이스에서 결과를 검색합니다.
쿼리 요구사항 및 제한사항
쿼리 빌더를 사용할 때는 쿼리에 대한 다음 요구사항과 제한사항에 유의하세요.
모든 쿼리는 1개 이상의 색인에서 지원해야 합니다. 데이터베이스가 쿼리를 지원할 색인을 찾을 수 없는 경우 필요한 색인을 빌드할 수 있는 링크가 포함된 오류가 반환됩니다.
ORDER BY절은WHERE절의 필드와 일치해야 하며 순서도 동일해야 합니다. 기본적으로 결과는 문서 ID를 기준으로 정렬됩니다. 같음(==) 이외의 필드로 필터링하면 해당 필드에ORDER BY절을 추가합니다.
범위(
<,<=,>,>=)와 같지 않음(!=,not-in) 쿼리 절은 모두 동일한 필드에서 필터링되어야 합니다.
추가 제한사항은 쿼리 제한사항을 참조하세요.
데이터 관리
Firestore Standard 버전은 데이터를 문서에 저장하고 문서를 컬렉션으로 구성합니다. 데이터 추가를 시작하기 전에 Firestore Standard 버전 데이터 모델에 대해 자세히 알아보세요.
Firebase Console에서 문서와 컬렉션을 추가, 수정, 삭제할 수 있습니다. GCP Console에서 데이터를 관리하려면 Firestore 스튜디오 페이지로 이동합니다.
콘솔 Google Cloud 에서