빠른 시작

이 페이지에서는 Google Cloud Platform 콘솔을 사용하여 Google Cloud Datastore에 데이터를 저장하고 쿼리하는 방법을 보여줍니다.

시작하기 전에

• Google 계정에 로그인합니다.

  아직 계정이 없으면 새 계정을 등록하세요.

• Google Cloud Platform 프로젝트를 선택하거나 만듭니다.

  참고: 이 절차에서 생성한 리소스를 보관할 생각이 없다면, 기존 프로젝트를 선택하지 말고 새 프로젝트를 만들어야 합니다. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

  리소스 관리 페이지로 이동

• 프로젝트 소유자가 아닌 경우, 이 빠른 시작을 완료하려면 계정에 다음 권한이 필요합니다.

  • 계정에 Cloud Datastore 인스턴스를 만드는 데 필요한 datastore.databases.create 권한이 포함된 Cloud Datastore 소유자 역할이 필요합니다.
  • Cloud Datastore에는 활성 App Engine 애플리케이션이 필요합니다. 프로젝트에 애플리케이션이 없으면 이 빠른 시작에서 자동으로 애플리케이션이 만들어집니다. 이 경우 appengine.applications.create 권한이 필요합니다. 프로젝트 소유자는 IAM 커스텀 역할과 함께 이 권한을 할당할 수 있습니다.

데이터베이스 선택

새 데이터베이스 인스턴스를 만들려면 Google Cloud Platform 콘솔에서 Cloud Datastore 섹션을 엽니다.
Cloud Datastore 페이지로 이동

Cloud Firestore 또는 Cloud Datastore

새로운 Cloud Datastore 데이터베이스를 만들 때 Cloud Datastore를 사용하거나 Cloud Firestore로 업그레이드 할 수 있습니다. Cloud Firestore는 Cloud Datastore의 새 버전이며 몇 가지 개선사항과 새로운 기능을 포함합니다. Cloud Firestore는 Cloud Datastore의 상위 집합이며 이전 버전과 호환되는 Datastore 모드에서 실행할 수 있습니다.

경고: 데이터베이스 옵션이 설정된 후에는 전환할 수 없습니다. 같은 프로젝트에서 Cloud Firestore와 Cloud Datastore를 동시에 사용할 수 없습니다.

다음 데이터베이스 옵션 중 하나를 선택하세요.

• 기본 모드의 Cloud Firestore

  베타 버전의 제품을 사용하는 것이 편하면 모바일 및 웹 앱에 기본 모드의 Cloud Firestore를 사용하는 것이 좋습니다. Cloud Firestore를 시작하려면 Cloud Firestore 빠른 시작에서 계속하세요.

• 데이터 저장소 모드의 Cloud Firestore

  베타 버전의 제품을 사용하는 것이 편하면 새로운 서버 프로젝트에 데이터 저장소 모드의 Cloud Firestore를 사용하세요. Cloud Datastore 시스템 동작을 유지하면서 개선된 Cloud Firestore 저장소 레이어를 사용하려면 데이터 저장소 모드의 Cloud Firestore를 선택하세요.

  참고: Cloud Firestore가 GA인 경우 기존의 모든 Cloud Datastore 프로젝트는 자동으로 데이터 저장소 모드의 Cloud Firestore로 업그레이드됩니다.

• Cloud Datastore

  앱에 서비스수준계약(SLA)이 필요한 경우 Cloud Datastore를 선택하세요.

데이터베이스 선택 및 기능별 비교에 대한 자세한 내용은 Cloud Firestore와 Cloud Datastore 중 선택을 참조하세요.

데이터 저장

1. Google Cloud Platform 콘솔의 Datastore 항목 페이지로 이동합니다.
   Datastore 항목 페이지로 이동
   이 페이지에서 데이터 저장, 쿼리, 업데이트, 삭제 작업을 수행할 수 있습니다.
2. 항목 만들기를 클릭합니다.

3. 다음 페이지가 보이면 위치를 선택해야 합니다. 이 페이지가 보이지 않으면 다음 단계로 넘어가세요.
   

   경고: 저장한 후에는 위치를 변경할 수 없습니다.

   

   위치는 Google Cloud Platform 프로젝트의 Cloud Datastore 및 App Engine에 모두 적용됩니다.
   위치를 저장하려면 위치 값 중 하나를 선택한 후 다음을 클릭하세요.

4. 항목 만들기 페이지에서 네임스페이스로 [default]를 사용합니다.

5. 종류로 Task를 입력합니다.

6. 속성의 속성 추가 버튼을 사용하여 이러한 속성을 추가합니다.

   이름	유형	값	색인 생성됨
   설명	문자열	Google Cloud Datastore 알아보기
   생성됨	날짜 및 시간	(오늘 날짜)	✓
   완료	부울	거짓	✓

   이제 생성 페이지는 다음과 같이 나타납니다.

   

7. 만들기를 클릭합니다. 방금 만든 Task 항목이 콘솔에 표시됩니다.

이제 Cloud Datastore에 데이터가 저장되었습니다.

쿼리 실행

Cloud Datastore는 종류 또는 GQL(Google 쿼리 언어)별 데이터 쿼리 기능을 지원합니다. 아래의 지침은 이 두 가지 작업을 단계별로 안내합니다.

종류 쿼리 실행

1. 종류로 쿼리를 클릭합니다.
2. 종류로 Task를 선택합니다.

내가 만든 Task 항목이 쿼리 결과에 나타납니다.

다음으로 쿼리 필터를 추가하여 특정 조건을 만족하는 항목으로 결과를 제한해 봅니다.

1. 항목 필터링을 클릭합니다.
2. 드롭다운 목록에서 done, 부울, false인 항목을 선택합니다.
3. 필터 적용을 클릭합니다. done 값이 false이므로 내가 만든 Task 항목이 결과에 표시됩니다.
4. 이제 done, 부울, true인 항목의 쿼리를 실행해 봅니다. Task 항목의 done 값이 true가 아니기 때문에 내가 만든 항목이 결과에 포함되지 않습니다.

GQL 쿼리 실행

1. GQL로 쿼리를 클릭합니다.
2. 쿼리로 SELECT * FROM Task를 입력합니다. Task는 대소문자를 구분합니다.
3. 쿼리 실행을 클릭합니다.

내가 만든 Task 항목이 쿼리 결과에 나타납니다.

도움말

GQL 쿼리 편집기는 종류의 자동 완성 기능을 지원합니다. 종류 이름을 입력해야 하는 경우 Ctrl+Space 키를 누르면 사용 가능한 종류 목록을 확인할 수 있습니다. 알파벳순으로 정렬된 종류가 최대 300개까지 목록에 나타날 수 있습니다. 일치하는 종류의 범위를 좁히려면 문자를 하나 이상 입력하세요.

마찬가지로 쿼리 필터를 추가하여 특정 조건을 만족하는 항목으로 결과를 제한하세요.

1. SELECT * FROM Task WHERE done=false와 같은 쿼리를 실행합니다. Task 및 done은 대소문자를 구분합니다. done 값이 false이므로 내가 만든 Task 항목이 결과에 표시됩니다.
2. 이제 SELECT * FROM Task WHERE done=true와 같은 쿼리를 실행합니다. Task 항목의 done 값이 true가 아니기 때문에 내가 만든 항목이 결과에 포함되지 않습니다.

삭제

1. 종류별 쿼리를 클릭하고 Task가 선택한 종류인지 확인합니다.
2. 필터 지우기를 클릭합니다.
3. 내가 만든 Task 항목을 선택합니다.
4. 삭제를 클릭한 다음 Task 항목을 삭제하려 한다는 의사를 확인합니다. 삭제되면 Cloud Datastore에서 해당 항목이 영구적으로 삭제됩니다.

이전에 생성한 Task 항목이 Cloud Datastore에서 삭제됩니다.

이제 빠른 시작이 완료되었습니다.

다음 단계

• Datastore 쿼리 자세히 알아보기
• Cloud Datastore 자세히 알아보기