이 페이지에는 Datastore 모드의 Firestore API를 사용하여 명령줄 TaskList 애플리케이션을 빌드하는 짧은 연습이 나와 있습니다. TaskList 애플리케이션은 태스크를 저장, 나열, 업데이트, 삭제합니다.
기본 요건
- 이 주제에 사용된 프로그래밍 언어로 명령줄 애플리케이션을 작성하고 실행할 수 있는 능력
애플리케이션 개발 방법에 대한 기본 지식 외에 이 가이드를 시작하기 전에 추가 라이브러리를 다운로드하고 설치할 수 있어야 합니다. - Datastore 모드 API가 사용 설정된 Google Cloud 프로젝트
Datastore 모드를 사용하는 애플리케이션은 Datastore 모드 API가 사용 설정된 Google Cloud 프로젝트와 연결됩니다. 이 프로젝트는 Google에서 애플리케이션을 인증하고 Datastore 모드 API 사용을 승인받도록 애플리케이션에서 사용하는 사용자 인증 정보를 제공합니다.
이 안내를 따라 프로젝트를 만들고, 프로젝트에 Datastore 모드 API를 사용 설정하고,gcloud auth login
명령어를 사용하여 사용자 인증 정보로 로컬 개발 환경을 설정합니다. 나중에 사용할 수 있도록 프로젝트 ID를 기록합니다.
설치 및 설정
클라이언트 라이브러리를 설치하고 개발 환경의 모든 추가 설정을 구성합니다.
C#
- Visual Studio(버전 2013 이상)가 설치되어 있는지 확인합니다.
- 샘플 저장소에서 TaskList 샘플 애플리케이션을 다운로드합니다.
- 문서 폴더의 디렉터리에 압축 파일을 풉니다.
- Visual Studio에서
dotnet-docs-samples-master\datastore\api\Datastore.sln
파일을 엽니다. - Visual Studio의 Solution Explorer(솔루션 탐색기) 창에서 TaskList 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 Set as StartUp Project(시작 프로젝트로 설정)을 선택합니다.
- TaskList 프로젝트를 마우스 오른쪽 버튼으로 클릭한 다음 Properties(속성)를 선택합니다.
Properties(속성) 창에서 Debug(디버그)를 클릭하고 Google Cloud 프로젝트의 ID를 Command line arguments:(명령줄 인수:) 상자에 입력합니다.
파일과 저장을 차례로 클릭하여 변경사항을 저장합니다.
애플리케이션을 실행합니다. 키보드의 F5 키를 누릅니다.
Go
TaskList 샘플 애플리케이션을 복제합니다.
go get github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
디렉터리를 샘플을 클론한 위치로 변경합니다.
cd $GOPATH/src/github.com/GoogleCloudPlatform/golang-samples/datastore/tasks
명령어 프롬프트에서 다음을 실행합니다. 여기서
<project-id>
는 Google Cloud 프로젝트의 ID입니다.export DATASTORE_PROJECT_ID=<project-id>
(Windows 사용자:
export
대신set
사용)애플리케이션을 실행합니다.
go run tasks.go
자바
샘플 저장소에서 TaskList 샘플 애플리케이션을 다운로드합니다.
명령 프롬프트에서 다운로드의 압축을 풉니다.
unzip main.zip
디렉터리를 TaskList 애플리케이션으로 변경합니다.
cd java-datastore-main/samples/snippets
다음을 실행합니다. 여기서
<project-id>
는 Google Cloud 프로젝트의 ID입니다.gcloud config set project <project-id>
애플리케이션을 컴파일하고 실행합니다.
mvn clean compile mvn exec:java -Dexec.mainClass="com.google.datastore.snippets.TaskList"
Node.js
샘플 저장소에서 TaskList 샘플 애플리케이션을 다운로드합니다.
다운로드 파일의 압축을 풉니다.
unzip master.zip
디렉터리를 TaskList 애플리케이션으로 변경합니다.
cd nodejs-datastore-master/samples
종속 항목을 설치하고 애플리케이션을 연결합니다.
npm install
명령어 프롬프트에서 다음을 실행합니다. 여기서
<project-id>
는 Google Cloud 프로젝트의 ID입니다.export GCLOUD_PROJECT=<project-id>
(Windows 사용자:
export
대신set
사용)애플리케이션을 실행합니다.
node tasks.js
PHP
Python
- Python(버전 2.7.9 이상), pip, virtualenv가 설치되어 있는지 확인합니다.
virtualenv
세션을 활성화합니다.virtualenv venv source venv/bin/activate
샘플 저장소에서 TaskList 샘플 애플리케이션을 다운로드합니다.
다운로드 파일의 압축을 풉니다.
unzip master.zip
디렉터리를 TaskList 애플리케이션으로 변경합니다.
cd python-docs-samples-master/datastore/cloud-client
종속 항목을 설치합니다.
pip install -r requirements.txt
애플리케이션을 실행합니다.
<project-id>
에 Google Cloud 프로젝트의 ID를 사용합니다.python tasks.py new project-id
Ruby
샘플 저장소에서 TaskList 샘플 애플리케이션을 다운로드합니다.
다운로드 파일의 압축을 풉니다.
unzip master.zip
디렉터리를 TaskList 애플리케이션으로 변경합니다.
cd google-cloud-ruby-master/google-cloud-datastore/samples
종속 항목을 설치합니다.
bundle install
명령어 프롬프트에서 다음을 실행합니다. 여기서
<project-id>
는 Google Cloud 프로젝트의 ID입니다.export GOOGLE_CLOUD_PROJECT=<project-id>
(Windows 사용자:
export
대신set
사용)애플리케이션을 실행합니다.
bundle exec ruby tasks.rb
승인된 서비스 객체 만들기
Google API 클라이언트 라이브러리를 사용하여 Google Cloud API에 인증된 요청을 보내려면 다음을 수행해야 합니다.
- 요청에 사용할 사용자 인증 정보를 가져옵니다.
- 해당 사용자 인증 정보를 사용하는 서비스 객체를 만듭니다.
그런 다음 Datastore 모드 서비스 객체에서 메소드를 호출하는 방법으로 API를 호출할 수 있습니다.
이 예에서는 환경에서 애플리케이션 기본 사용자 인증 정보를 가져온 후 인수로 전달하여 서비스 객체를 만듭니다.
승인된 Datastore 모드 서비스 객체를 만들기 위한 호출 방법은 다음과 같습니다.
C#
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore C# API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Go API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Java API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Node.js API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
PHP
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore PHP API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Python API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Ruby API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
데이터 저장
Datastore 모드의 객체를 항목이라고 하며, 각 항목에는 특정 종류가 지정됩니다. TaskList 애플리케이션은 Task
종류의 항목을 다음 속성과 함께 저장합니다.
description
: 사용자가 태스크 설명으로 지정하는 문자열created
: 태스크가 처음 생성된 시간을 알려주는 날짜done
: 태스크 완료 여부를 나타내는 부울
사용자가 새로운 태스크를 추가하면 TaskList 애플리케이션은 이전에 나열된 속성 값을 사용하여 Task
항목을 만듭니다.
C#
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore C# API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Go API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Java API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Node.js API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
PHP
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore PHP API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Python API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Ruby API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
이 애플리케이션에서는 태스크가 완료되었음을 나타내기 위해 done
속성을 업데이트하는 메서드도 제공합니다.
C#
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore C# API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Go API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Java API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Node.js API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
PHP
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore PHP API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Python API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Ruby API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음은 Task
항목 키를 사용하여 Task
항목을 삭제하는 방법입니다.
C#
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore C# API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Go API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Java API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Node.js API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
PHP
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore PHP API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Python API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Ruby API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
쿼리 실행
애플리케이션은 Datastore 모드에서 항목을 키로 직접 검색할 수 있을 뿐 아니라 속성 값으로 항목을 검색하는 쿼리도 수행할 수 있습니다. 일반적인 쿼리에는 다음이 포함됩니다.
- 쿼리가 적용되는 항목 종류
- 0개 이상의 필터(예: 값과 일치하는 속성의 종류를 선택하는 경우)
- 결과를 순차적으로 배열할 정렬 순서 0개 이상
이 애플리케이션에서는 Datastore 모드에서 생성 시간순으로 정렬된 Task
항목을 쿼리합니다.
C#
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore C# API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Go API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Java API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Node.js API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
PHP
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore PHP API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Python API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Cloud Datastore용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud Datastore 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud Datastore Ruby API 참고 문서를 확인하세요.
Cloud Datastore에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 단계
이 가이드에서는 명령줄 애플리케이션에서 Datastore 모드 API를 호출하는 데 필요한 가장 기본적인 단계만 설명합니다. Datastore 모드는 신속하고 확장성이 높은 ACID 트랜잭션, SQL 방식의 쿼리, 색인 등을 지원합니다.
- Datastore 모드 기능을 더 자세히 알아보려면 Datastore 모드의 Firestore란 무엇인가요?를 참조하세요.
- 애플리케이션 개발 시 Datastore 모드 에뮬레이터를 사용하는 방법은 Datastore 모드 에뮬레이터를 참조하세요.