Console を使用したクイックスタート

このクイックスタートでは、Google Cloud Platform Console を使用して Cloud Spanner の基本オペレーションを行う方法について説明します。このクイックスタートでは、以下の操作を行います。

  • Cloud Spanner のインスタンス、データベース、テーブルを作成する。
  • スキーマを追加する。
  • データを書き込んで変更する。
  • クエリを実行する。

始める前に

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

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

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

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

  3. プロジェクトに対して課金が有効になっていることを確認します。

    課金を有効にする方法について

インスタンスの作成

Cloud Spanner を最初に使用するときは、インスタンスを作成する必要があります。これは、そのインスタンスの Cloud Spanner データベースによって使用されるリソースの割り当てです。

  1. GCP Console の [Spanner] ページに移動します。
    [Spanner] ページに移動
  2. [インスタンスを作成] をクリックします。
  3. インスタンス名として、「Test Instance」と入力します。
  4. インスタンス ID として、「test-instance」と入力します。
  5. リージョン構成を使用します。
  6. プルダウン メニューから任意のリージョン構成を選択します。
    インスタンスの構成により、インスタンスが保存および複製される地理的なロケーションが決まります。
  7. ノード数には 1 を使用します。
    インスタンス作成ページは次のようになります。

    インスタンス作成ウィンドウのスクリーンショット

  8. [作成] をクリックします。
    Spanner インスタンス ページにインスタンスが表示されます。

データベースの作成

  1. GCP Console の Spanner インスタンス ページに移動します。
    Spanner インスタンス ページに移動
  2. Test Instance インスタンスをクリックします。
  3. [データベースを作成] をクリックします。
  4. データベース名として、「example-db」と入力します。データベース作成ページは次のようになります。

    データベース作成ウィンドウのスクリーンショット

  5. [続行] をクリックします。

  6. ここでは、[データベース スキーマの定義] ステップはスキップします。スキーマは、このクイックスタートの次のセクションで定義します。

  7. [作成] をクリックします。
    データベースが作成されると、GCP Console に [データベースの詳細] ページが表示されます。

データベースのスキーマの作成

GCP Console では、データベースのテーブルとインデックスの作成、変更、削除を次の 2 つの方法で行うことができます。

  • デフォルトのデータベース エディタを使用して、テーブル、列、インデックスの各部分を指定します。
  • エディタを [テキストとして編集] モードに切り替え、Cloud Spanner のデータ定義言語(DDL)構文で SQL ステートメントを入力します。

このクイックスタートでは DDL を使用します。

  1. GCP Console の左側のペインで、example-db データベースをクリックします。
  2. [テーブルを作成] をクリックします。
  3. [テキストとして編集] に切り替えます。
  4. [DDL ステートメント] フィールドに、次のように入力します。

    CREATE TABLE Singers (
      SingerId   INT64 NOT NULL,
      FirstName  STRING(1024),
      LastName   STRING(1024),
      SingerInfo BYTES(MAX),
      BirthDate  DATE,
    ) PRIMARY KEY(SingerId);
    

  5. [作成] をクリックします。
    完了するまで数分かかることがあります。完了すると、作成したテーブルの詳細が GCP Console に表示されます。

    テーブルのスクリーンショット

データの挿入と変更

GCP Console には、データを挿入、編集、および削除するためのインターフェースがあります。

データの挿入

  1. GCP Console の左側のペインで、[Singers] をクリックします。
  2. [データ] をクリックします。
  3. [挿入] をクリックします。
  4. 次の値を入力します。

    フィールド
    SingerID:INT64 1
    BirthDate:DATE [空白のまま]
    FirstName:STRING Marc
    LastName:STRING Richards
    SingerInfo:BYTES [空白のまま]
  5. [保存] をクリックします。
    Singers テーブルに行が 1 つ追加されました。
    1 行で構成される Singers テーブルデータのスクリーンショット

  6. [挿入] をクリックして行を 1 つ追加します。

  7. 次の値を入力します。

    フィールド
    SingerID:INT64 2
    BirthDate:DATE [空白のまま]
    FirstName:STRING Catalina
    LastName:STRING Smith
    SingerInfo:BYTES [空白のまま]
  8. [保存] をクリックします。
    Singers テーブルの行が 2 つになりました。
    2 行で構成される Singers テーブルデータのスクリーンショット

また、データを入力するときに、空の文字列値を挿入することもできます。

  1. 左側のペインで [Singers] をクリックします。
  2. [データ] をクリックします。
  3. [挿入] をクリックします。
  4. 次の値を入力します。

    フィールド
    SingerID:INT64 3
    BirthDate:DATE [空白のまま]
    FirstName:STRING Kena
    LastName:STRING [[空の文字列] をオンにする]
    SingerInfo:BYTES [空白のまま]
  5. [保存] をクリックします。
    Singers テーブルの行が 3 つになり、SingerID 3 の行の LastName が空の文字列になりました。
    3 行で構成される Singers テーブルデータのスクリーンショット

データの編集

  1. GCP Console の左側のペインで、[Singers] をクリックします。
  2. [データ] をクリックします。
  3. SingerId 3 の行の横にあるチェックボックスをオンにして、[編集] をクリックします。
  4. 次の値を入力します。

    フィールド
    BirthDate:DATE 1961-04-01
    [他のすべてのフィールド] [そのままにする]
  5. [保存] をクリックします。
    Singers テーブルの SingerId 3 の行に BirthDate 値が追加されました。
    3 行で構成される Singers テーブルデータのスクリーンショット(3 行目に BirthData 値が含まれている)

データの削除

  1. GCP Console の左側のペインで、[Singers] をクリックします。
  2. [データ] をクリックします。
  3. SingerId 2 の行の横にあるチェックボックスをオンにして、[削除] をクリックします。
  4. 表示されるダイアログで [OK] をクリックします。
    Singers テーブルの行が 2 つになりました。
    SingerId 2 の行が削除された後、2 行で構成される Singers テーブルデータのスクリーンショット

クエリの実行

クエリページで SQL ステートメントを実行できるようになりました。

  1. GCP Console の左側のペインで、[example-db] をクリックして、[データベースの詳細] ページに移動します。
  2. [データベースの詳細] ページで [クエリ] をクリックします。
  3. 次のクエリを入力します。

    SELECT * FROM Singers
    
  4. [クエリを実行] をクリックします。
    GCP Console にクエリの結果が表示されます。

    クエリ結果のスクリーンショット

これで、Cloud Spanner データベースを作成し、クエリエディタを使用して SQL ステートメントを実行することができました。

クリーンアップ

Google Cloud Platform アカウントに追加料金が課されるのを回避するには、作成したデータベースとインスタンスを削除してください。

データベースの削除

  1. Google Cloud Platform Console で Spanner インスタンス ページに移動します。
    Spanner インスタンス ページに移動
  2. [Test Instance] をクリックします。
  3. [example-db] をクリックします。
  4. [データベースの詳細] ページで [削除] UI 要素の削除のスクリーンショット をクリックします。
  5. データベースを削除することを確認し、[削除] をクリックします。

インスタンスの削除

インスタンスを削除すると、そのインスタンス内に作成されたすべてのデータベースが自動的に削除されます。

  1. Google Cloud Platform Console で Spanner インスタンス ページに移動します。
    Spanner インスタンス ページに移動
  2. [Test Instance] をクリックします。
  3. [削除] UI 要素の削除のスクリーンショット をクリックします。
  4. インスタンスを削除することを確認し、[削除] をクリックします。

次のステップ

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

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

Cloud Spanner のドキュメント