이 페이지에서는 Google Cloud Console을 사용하여 Datastore 모드의 Firestore에서 데이터를 저장하고 쿼리하는 방법을 설명합니다.
시작하기 전에
-
Google 계정으로
로그인합니다.
아직 계정이 없으면 새 계정을 등록하세요.
-
Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.
-
프로젝트 소유자가 아닌 경우 이 빠른 시작을 완료하려면 계정에 다음 권한이 필요합니다.
- 계정에 Datastore 모드 인스턴스를 만드는 데 필요한
datastore.databases.create
권한이 포함된 Datastore 소유자 역할이 필요합니다. - Datastore 모드에는 활성 App Engine 애플리케이션이 필요합니다.
프로젝트에 애플리케이션이 없으면 이 빠른 시작에서 자동으로 애플리케이션을 만듭니다. 이러한 경우
appengine.applications.create
권한이 필요합니다. 프로젝트 소유자는 IAM 커스텀 역할과 함께 이 권한을 할당할 수 있습니다.
- 계정에 Datastore 모드 인스턴스를 만드는 데 필요한
데이터베이스 만들기
새 데이터베이스 인스턴스를 만들려면 Google Cloud Console에서 Datastore 섹션을 엽니다.
Datastore 페이지로 이동
Firestore: Native 모드 또는 Datastore 모드
새 Firestore 데이터베이스를 만들 때 Firestore를 Native 모드로 사용할지 Datastore 모드로 사용할지 선택할 수 있습니다.
다음 데이터베이스 옵션 중 하나를 선택합니다.
-
Native 모드의 Firestore
모바일 및 웹 앱에는 Native 모드의 Firestore를 사용하세요. Firestore를 시작하려면 Firestore 빠른 시작에서 계속하세요.
-
Datastore 모드의 Firestore
새 서버 프로젝트에는 Datastore 모드의 Firestore를 사용하세요. Datastore 모드의 Firestore를 선택하면 Datastore 모드 시스템 동작을 유지하면서 향상된 Firestore 스토리지 레이어를 사용할 수 있습니다.
됩니다.
데이터베이스 모드 선택 및 기능별 비교에 대한 자세한 내용은 기본 모드와 Datastore 모드 중 선택을 참조하세요.
데이터 저장
- Google Cloud Console에서 Datastore 항목 페이지로 이동합니다.
Datastore 항목 페이지로 이동
이 페이지에서 데이터를 저장, 쿼리, 업데이트, 삭제할 수 있습니다. - 항목 만들기를 클릭합니다.
다음 페이지가 보이면 위치를 선택해야 합니다. 이 페이지가 보이지 않으면 다음 단계로 이동합니다.
이 위치는 Google Cloud Platform 프로젝트의 App Engine 앱과 Datastore 모드 데이터베이스 모두에 적용됩니다.
위치를 저장하려면 위치 값 중 하나를 선택하고 다음을 클릭합니다.항목 만들기 페이지에서 네임스페이스로
[default]
를 사용합니다.종류에
Task
를 입력합니다.속성의 속성 추가 버튼을 사용하여 이러한 속성을 추가합니다.
이름 유형 값 색인 생성됨 설명 문자열 Google Datastore 모드 알아보기 생성됨 날짜 및 시간 (오늘 날짜) ✓ 완료 부울 거짓 ✓ 만들기를 클릭합니다. 방금 만든
Task
항목이 Console에 표시됩니다.
이제 데이터베이스에 데이터가 저장되었습니다.
쿼리 실행
Datastore 모드 데이터베이스는 종류 또는 Google 쿼리 언어(GQL)별 데이터 쿼리 기능을 지원합니다. 아래에서는 이 두 가지 작업을 단계별로 설명합니다.
종류 쿼리 실행
- 종류로 쿼리를 클릭합니다.
- 종류로
Task
를 선택합니다.
만든 Task
항목이 쿼리 결과에 표시됩니다.
다음으로 쿼리 필터를 추가하여 특정 조건을 만족하는 항목으로 결과를 제한합니다.
- 항목 필터링을 클릭합니다.
- 드롭다운 목록에서
done
, 부울, false인 항목을 선택합니다. - 필터 적용을 클릭합니다.
done
값이false
이므로 만든Task
항목이 결과에 표시됩니다. - 이제
done
, 부울, true인 항목의 쿼리를 실행해 봅니다.done
값이true
가 아니므로 만든Task
항목이 결과에 포함되지 않습니다.
GQL 쿼리 실행
- GQL로 쿼리를 클릭합니다.
- 쿼리로
SELECT * FROM Task
를 입력합니다.Task
는 대소문자를 구분합니다. - 쿼리 실행을 클릭합니다.
만든 Task
항목이 쿼리 결과에 표시됩니다.
다시 쿼리 필터를 추가하여 특정 조건을 만족하는 항목으로 결과를 제한합니다.
SELECT * FROM Task WHERE done=false
와 같은 쿼리를 실행합니다.Task
및done
은 대소문자를 구분합니다.done
값이false
이므로 만든Task
항목이 결과에 표시됩니다.- 이제
SELECT * FROM Task WHERE done=true
와 같은 쿼리를 실행합니다.done
값이true
가 아니므로 만든Task
항목이 결과에 포함되지 않습니다.
정리
- 종류별 쿼리를 클릭하고
Task
가 선택한 종류인지 확인합니다. - 필터 지우기를 클릭합니다.
- 만든
Task
항목을 선택합니다. - 삭제를 클릭한 후
Task
항목 삭제 여부를 확인합니다. 삭제되면 데이터베이스에서 항목이 영구 삭제됩니다.
이제 빠른 시작이 완료되었습니다.
다음 단계
- Datastore 쿼리 자세히 알아보기
- Datastore 모드 데이터베이스 자세히 알아보기