クイックスタート

このページでは、Google Cloud Platform Console を使用して Google Cloud Datastore でデータを保存しクエリを実行する方法について説明します。

始める前に

  • Google アカウントにログインします。

    Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

  • GCP プロジェクトを選択または作成します。

    [リソースの管理] ページに移動

  • プロジェクトのオーナーではない場合、このクイックスタートを行うにはアカウントに次の権限が必要です。

    • アカウントには Cloud Datastore オーナーの役割が必要です。この役割には、Cloud Datastore インスタンスを作成するために必要な datastore.databases.create 権限が含まれています。
    • Cloud Datastore では、アクティブな App Engine アプリケーションが必要です。プロジェクトにアプリケーションがない場合は、このクイックスタートによってアプリケーションが作成されます。その場合は、appengine.applications.create 権限が必要です。プロジェクト オーナーは、IAM カスタム役割を使ってこの権限を割り当てることができます。

データベースを選択

新しいデータベース インスタンスを作成するには、Google Cloud Platform Console で [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 Firestore のネイティブ モードをご使用ください。Cloud Firestore を使い始めるには、Cloud Firestrore クイックスタートを進めてください。

  • Datastore モードの Cloud Firestore

    ベータ版のプロダクトで問題ない場合は、新しいサーバー プロジェクトに Cloud Firestore の Datastore モードをご使用ください。Datastore モードの Cloud Firestore を選択すると、Cloud Datastore システムの動作を維持しながら、Cloud Firestore の改善されたストレージ レイヤを使用できます。

  • Cloud Datastore

    アプリでサービスレベル契約(SLA)が必要な場合は、Cloud Datastore を選択します。

データベースの選択に関するガイドと各機能の比較については、Cloud Firestore と Cloud Datastore の選択方法をご覧ください。

データの保存

  1. Google Cloud Platform Console の [Datastore エンティティ] ページに移動します。
    [Datastore エンティティ] ページに移動
    このページでは、データを保存、クエリ、更新、削除することができます。
  2. [エンティティを作成] をクリックします。
  3. 以下に示すページが表示された場合は、ロケーションを選択する必要があります(このページが表示されない場合は、次のステップに進みます)。

    ロケーションの選択ページのスクリーンショット

    ロケーションは Google Cloud Platform プロジェクトの Cloud Datastore と App Engine の両方に適用されます。
    ロケーションを保存するには、いずれかのロケーションの値を選択してから [次へ] をクリックします。

  4. [エンティティを作成] ページの [名前空間] には [default] を使用します。

  5. [種類] に Task を入力します。
  6. [プロパティ] の [プロパティを追加] ボタンをクリックして、以下のプロパティを追加します。

    名前 インデックス登録
    description 文字列 Google Cloud Datastore の学習
    created 日時 (今日の日付)
    done ブール値 False
    プロパティの作成ページは次のようになります。

    プロパティを設定したエンティティ作成画面のスクリーンショット

  7. [作成] をクリックします。作成した Task エンティティが Console に表示されます。

これで Cloud Datastore にデータが保存されました。

クエリの実行

Cloud Datastore では種類または Google Query Language(GQL)に基づいて、データのクエリを実行できます。次にそれぞれの手順を詳しく説明します。

種類別クエリの実行

  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 エンティティが表示されます。

ここでも、特定の条件に適合するエンティティだけが返されるよう、結果を制限するクエリフィルタを追加します。

  1. SELECT * FROM Task WHERE done=false のようなクエリを実行します。Taskdone では、大文字と小文字が区別されることに注意してください。クエリの結果として、done 値が false であるため、作成した Task エンティティが表示されます。 フィルタを適用した GQL クエリのスクリーンショット
  2. 次に、SELECT * FROM Task WHERE done=true のようなクエリを実行します。結果には、作成した Task エンティティは含まれません。done の値が true ではないためです。

クリーンアップ

  1. [種類別のクエリ] をクリックし、種類として Task が選択されていることを確認します。
  2. [フィルタをクリア] をクリックします。
  3. 作成した Task エンティティを選択します。
  4. [削除] をクリックして、Task エンティティの削除を確定します。削除すると、このエンティティが Cloud Datastore から完全に削除されます。

これで、作成した Task エンティティが Cloud Datastore から削除されました。

これでクイックスタートの演習はすべて終了です。

次のステップ

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Cloud Datastore ドキュメント