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

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

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

始める前に

Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

プロジェクトセレクタに移動

Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する。

プロジェクトに対して Cloud Spanner API を有効化します。

Cloud Spanner API を有効にする

インスタンスの作成

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

Cloud Console で、Cloud Spanner の [インスタンス] ページに移動します。

インスタンスページに移動
[インスタンスを作成] をクリックします。
インスタンス名として、「Test Instance」と入力します。
インスタンス ID として、「test-instance」と入力します。
リージョン構成を使用します。
プルダウンメニューから任意のリージョン構成を選択します。

インスタンスの構成により、インスタンスが保存および複製される地理的なロケーションが決まります。
1000 プロセッシングユニットのデフォルトの計算能力を使用します。

インスタンス作成ページは次のようになります。
[作成] をクリックします。

インスタンスリストにこのインスタンスが表示されます。

データベースの作成

Cloud Console で、Cloud Spanner の [インスタンス] ページに移動します。

インスタンスページに移動
Test Instance インスタンスをクリックします。
[データベースを作成] をクリックします。
データベース名として、「example-db」と入力します。

データベース作成ページは次のようになります。
ここでは、[スキーマの定義] ステップはスキップします。スキーマは、このクイックスタートの次のセクションで定義します。
[作成] をクリックします。

Cloud Console に、作成したデータベースの [概要] ページが表示されます。

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

example-db の [概要] ページで、テーブルのリストの先頭にある [テーブルを作成] をクリックします。

Cloud Console に [DDL ステートメントの書き込み] ページが表示されます。

次のように入力します。

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

[送信] をクリックします。

Cloud Console が example-db の [概要] ページに戻り、スキーマの更新が進行中であることが表示されます。更新が完了すると、ページは次のようになります。

データの挿入と変更

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

データの挿入

example-db の [概要] ページで、テーブルのリストにある [Singers] テーブルをクリックします。

Cloud Console に Singers テーブルの [スキーマ] ページが表示されます。
サイドメニューで [データ] をクリックし、Singers テーブルの [データ] ページを表示します。

[挿入] をクリックします。

Cloud Console は、Singers テーブルに行を挿入してその挿入の結果を表示するために編集するテンプレート INSERT と SELECT ステートメントを含む新しいクエリタブを含む Singers テーブルの [クエリ] ページを表示します。

  -- Add new values in the VALUES clause in order of the column list.
  -- Each value must be type compatible with its associated column.
INSERT INTO
  Singers (SingerId,
    BirthDate,
    FirstName,
    LastName,
    SingerInfo)
VALUES
  (<SingerId>, -- type: INT64
    <BirthDate>, -- type: DATE
    <FirstName>, -- type: STRING(1024)
    <LastName>, -- type: STRING(1024)
    <SingerInfo> -- type: BYTES(MAX)
    );
  -- Change values in the WHERE condition to match the inserted row.
SELECT
  *
FROM
  Singers
WHERE
  SingerId=<SingerId>;

INSERT ステートメントの VALUES 句と SELECT ステートメントの WHERE 句を編集します。

  -- Add new values in the VALUES clause in order of the column list.
  -- Each value must be type compatible with its associated column.
INSERT INTO
  Singers (SingerId,
    BirthDate,
    FirstName,
    LastName,
    SingerInfo)
VALUES
  (1, -- type: INT64
    NULL, -- type: DATE
    'Marc', -- type: STRING(1024)
    'Richards', -- type: STRING(1024)
    NULL -- type: BYTES(MAX)
    );
  -- Change values in the WHERE condition to match the inserted row.
SELECT
  *
FROM
  Singers
WHERE
  SingerId=1;

[実行] をクリックします。

Cloud Spanner がステートメントを実行します。完了すると、[結果] タブには、最初のステートメントで 1 行が挿入されたことと、テーブルのデータを表示するリンクが示されます。
[結果] タブで [テーブル] リンクをクリックします。Singers テーブルに行が 1 つ追加されました。
[挿入] をクリックして行を 1 つ追加します。

Cloud Console は、同じテンプレート INSERT および SELECT ステートメントを含む新しいクエリタブを含む Singers テーブルの [クエリ] ページを再び表示します。

INSERT ステートメントの VALUES 句と SELECT ステートメントの WHERE 句を編集します。

  -- Add new values in the VALUES clause in order of the column list.
  -- Each value must be type compatible with its associated column.
INSERT INTO
  Singers (SingerId,
    BirthDate,
    FirstName,
    LastName,
    SingerInfo)
VALUES
  (2, -- type: INT64
    NULL, -- type: DATE
    'Catalina', -- type: STRING(1024)
    'Smith', -- type: STRING(1024)
    NULL -- type: BYTES(MAX)
    );
  -- Change values in the WHERE condition to match the inserted row.
SELECT
  *
FROM
  Singers
WHERE
  SingerId=2;

[実行] をクリックします。

Cloud Spanner がステートメントを実行すると、[結果] タブに最初のステートメントが 1 行を挿入したことが示されます。
テーブルのリンクをクリックします。Singers テーブルの行が 2 つになりました。

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

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

Cloud Console は、同じテンプレート INSERT および SELECT ステートメントを含む新しいクエリタブを含む Singers テーブルの [クエリ] ページを再び表示します。

テンプレートの INSERT ステートメントの VALUES 句と SELECT ステートメントの WHERE 句を編集します。

    -- Add new values in the VALUES clause in order of the column list.
  -- Each value must be type compatible with its associated column.
INSERT INTO
  Singers (SingerId,
    BirthDate,
    FirstName,
    LastName,
    SingerInfo)
VALUES
  (3, -- type: INT64
    NULL, -- type: DATE
    'Kena', -- type: STRING(1024)
    '', -- type: STRING(1024)
    NULL -- type: BYTES(MAX)
    );
  -- Change values in the WHERE condition to match the inserted row.
SELECT
  *
FROM
  Singers
WHERE
  SingerId=3;

LastName に指定した値は、NULL 値ではなく、空の文字列 '' です。

[実行] をクリックします。

Cloud Spanner がステートメントを実行すると、[結果] タブに最初のステートメントが 1 行を挿入したことが示されます。
テーブルのリンクをクリックします。Singers テーブルの行が 3 つになり、SingerID 3 の行の LastName が空の文字列になりました。

データの編集

Singers テーブルの [データ] ページで、SingerId 3 の行の横にあるチェックボックスをオンにして、[編集] をクリックします。

Cloud Console に [Singers] テーブルの [クエリ] ページが開かれ、Singers テーブルの行を更新するために編集したテンプレート UPDATE ステートメントと SELECT ステートメントを含む新しいクエリタブが表示され、更新の結果が表示されます。両方のステートメントの WHERE 句で、更新する行が SingerId 3 の行であることを示しています。
```
  -- Change values in the SET clause to update the row where the WHERE condition is true.
UPDATE
  Singers
SET
  BirthDate='',
  FirstName='Kena',
  LastName='',
  SingerInfo=''
WHERE
  SingerId=3;
SELECT
  *
FROM
  Singers
WHERE
  SingerId=3;
```

UPDATE ステートメントの SET 句を編集して、BirthDate 列のみを更新します。

  -- Change values in the SET clause to update the row where the WHERE condition is true.
UPDATE
  Singers
SET
  BirthDate='1961-04-01'
WHERE
  SingerId=3;
SELECT
  *
FROM
  Singers
WHERE
  SingerId=3;

[実行] をクリックします。

Cloud Spanner がステートメントを実行します。完了すると、[結果] タブには、最初のステートメントで 1 行が更新され、テーブルのデータを表示するリンクが示されます。
[結果] タブで [テーブル] リンクをクリックします。Singers テーブルの SingerId 3 の行に BirthDate 値が追加されました。

データの削除

Singers テーブルの [データ] ページで、SingerId 2 の行の横にあるチェックボックスをオンにして、[削除] をクリックします。
表示されるダイアログで [確認] をクリックします。

Singers テーブルの行が 2 つになりました。

クエリの実行

example-db の [概要] ページのサイドメニューで [クエリ] をクリックし、example-db の [クエリ] ページを表示します。
[新しいタブ] をクリックして、新しいクエリタブを作成します。次のクエリを入力します。
```
SELECT * FROM Singers;
```
[実行] をクリックします。

Cloud Spanner がクエリを実行します。完了すると、[結果] タブにクエリの結果が表示されます。

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

クリーンアップ

Cloud 請求先アカウントにこれ以上料金が発生しないようにするには、作成したデータベースとインスタンスを削除します。

データベースの削除

Google Cloud Console で、Cloud Spanner の [インスタンス] ページに移動します。

インスタンスページに移動
[Test Instance] をクリックします。
[example-db] をクリックします。
[データベースの詳細] ページで [データベースの削除] をクリックします。
データベースを削除することを確認し、[削除] をクリックします。

インスタンスの削除

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

Google Cloud Console で、Cloud Spanner の [インスタンス] ページに移動します。

インスタンスページに移動
[Test Instance] をクリックします。
[インスタンスの削除] をクリックします。
インスタンスを削除することを確認し、[削除] をクリックします。

次のステップ

インスタンスについて学習する。
Cloud Spanner のスキーマとデータモデルについて理解する。
データ定義言語（DDL）について詳しく学習する。
クエリ実行プランについて詳しく学習する。
C++、C#、Go、Java、Node.js、PHP、Python、Ruby、REST、gcloud を用いて、Cloud Spanner を使用する方法について学習する。