

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Keyspaces でキースペースを作成する
<a name="getting-started.keyspaces"></a>

このセクションでは、コンソール、`cqlsh`、または AWS CLIを使用してキースペースを作成します。

**注記**  
このチュートリアルを開始する前に、次の[前提条件](getting-started.before-you-begin.md)をすべて設定してください。

*キースペース*は、1 つ以上のアプリケーションに関係している関連テーブルをグループ化するものです。キースペースには 1 つ以上のテーブルが含まれており、キースペースに含まれるすべてのテーブルのレプリケーション戦略がキースペースによって定義されます。キースペースの詳細については、次のトピックを参照してください。
+ CQL 言語リファレンスのデータ定義言語 (DDL) ステートメント: [Keyspaces](cql.ddl.keyspace.md)
+ [Amazon Keyspaces (Apache Cassandra 向け) のクォータ](quotas.md)

このチュートリアルでは、単一リージョンのキースペースを作成します。キースペースのレプリケーション戦略は `SingleRegionStrategy` です。`SingleRegionStrategy` を使用する場合、Amazon Keyspaces は 1 つの AWS リージョン内で 3 つの[アベイラビリティーゾーン](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)にわたってデータをレプリケートします。マルチリージョンのキースペースの作成方法については、「[Amazon Keyspaces でマルチリージョンキースペースを作成する](keyspaces-mrr-create.md)」を参照してください。

## コンソールを使用する
<a name="getting-started.keyspaces.con"></a>

**コンソールを使用してキースペースを作成するには**

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。

1. ナビゲーションペインで、[**Keyspaces (キー空間)**] を選択します。

1. [**Create keyspace (キースペースの作成)**] を選択します。

1. [**Keyspace name (キースペース名)**] ボックスに、キースペースの名前として **catalog** を入力します。

   **名前の制約:**
   + 名前を空にすることはできません。
   + 使用できる文字: 英数字と下線 (`_`) です。
   + 最大長は 48 文字です。

1. **[AWS リージョン]** で、**[単一リージョンレプリケーション]** がキースペースのレプリケーション戦略になっていることを確認します。

1. キースペースを作成するには、[**Create keyspace (キースペースの作成)**] を選択します。

1. 以下の作業により、キースペース `catalog` が作成されたことを確認します。

   1. ナビゲーションペインで、[**Keyspaces (キー空間)**] を選択します。

   1. キースペースのリストで該当するキースペース `catalog` を見つけます。

## CQL の使用
<a name="getting-started.keyspaces.cql"></a>

以下の手順では、CQL を使用してキースペースを作成します。

**CQL を使用してキースペースを作成するには**

1. を開き AWS CloudShell 、次のコマンドを使用して Amazon Keyspaces に接続します。*us-east-1* は実際のリージョンに置き換えてください。

   ```
   cqlsh-expansion cassandra.us-east-1.amazonaws.com 9142 --ssl
   ```

   このコマンドの出力は次のようになります。

   ```
   Connected to Amazon Keyspaces at cassandra.us-east-1.amazonaws.com:9142
   [cqlsh 6.1.0 | Cassandra 3.11.2 | CQL spec 3.4.4 | Native protocol v4]
   Use HELP for help.
   cqlsh current consistency level is ONE.
   ```

1. 次の CQL コマンドを使用して、キースペースを作成します。

   ```
   CREATE KEYSPACE catalog WITH REPLICATION = {'class': 'SingleRegionStrategy'};
   ```

   `SingleRegionStrategy` は 3 つのレプリケーション係数を使用し、そのリージョンの 3 つの AWS アベイラビリティーゾーンにデータをレプリケートします。
**注記**  
Amazon Keyspaces ではすべての入力がデフォルトで小文字に設定されます。ただし、引用符で囲まれた入力はこれに該当しません。

1. キースペースが作成されていることを確認します。

   ```
   SELECT * from system_schema.keyspaces;
   ```

   このコマンドの出力は、次のようになります。

   ```
   cqlsh> SELECT * from system_schema.keyspaces;
   
    keyspace_name           | durable_writes | replication
   -------------------------+----------------+-------------------------------------------------------------------------------------
              system_schema |           True | {'class': 'org.apache.cassandra.locator.SimpleStrategy', 'replication_factor': '3'}
          system_schema_mcs |           True | {'class': 'org.apache.cassandra.locator.SimpleStrategy', 'replication_factor': '3'}
                     system |           True | {'class': 'org.apache.cassandra.locator.SimpleStrategy', 'replication_factor': '3'}
    system_multiregion_info |           True | {'class': 'org.apache.cassandra.locator.SimpleStrategy', 'replication_factor': '3'}
                    catalog |           True | {'class': 'org.apache.cassandra.locator.SimpleStrategy', 'replication_factor': '3'}
   
   (5 rows)
   ```

## の使用 AWS CLI
<a name="getting-started.keyspaces.cli"></a>

以下の手順では、 AWS CLIを使用してキースペースを作成します。

**を使用してキースペースを作成するには AWS CLI**

1. 環境がセットアップされていることを確認するには、CloudShell で次のコマンドを実行します。

   ```
   aws keyspaces help
   ```

1. 次の AWS CLI ステートメントを使用してキースペースを作成します。

   ```
   aws keyspaces create-keyspace --keyspace-name 'catalog'
   ```

1. 次の AWS CLI ステートメントを使用してキースペースが作成されたことを確認します。

   ```
   aws keyspaces get-keyspace --keyspace-name 'catalog'
   ```

   このコマンドの出力は、次の例のようになります。

   ```
   {
       "keyspaceName": "catalog",
       "resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/catalog/",
       "replicationStrategy": "SINGLE_REGION"
   }
   ```