本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon Keyspaces 中建立金鑰空間
<a name="getting-started.keyspaces"></a>

在本節中，您會使用主控台、 `cqlsh`或 建立金鑰空間 AWS CLI。

**注意**  
開始之前，請確定您已設定所有[教學的先決條件](getting-started.before-you-begin.md)。

與一或多個應用程式相關的*鍵空間*群組相關資料表。金鑰空間包含一或多個資料表，並為其包含的所有資料表定義複寫策略。如需金鑰空間的詳細資訊，請參閱下列主題：
+ CQL 語言參考中的資料定義語言 (DDL) 陳述式： [Keyspaces](cql.ddl.keyspace.md)
+ [Amazon Keyspaces 配額 （適用於 Apache Cassandra)](quotas.md)

在本教學課程中，我們會建立單一區域金鑰空間，而金鑰空間的複寫策略為 `SingleRegionStrategy`。Amazon Keyspaces 使用 `SingleRegionStrategy`在一個可用區域中跨三個[可用區域](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)複寫資料 AWS 區域。若要了解如何建立多區域金鑰空間，請參閱 [在 Amazon Keyspaces 中建立多區域金鑰空間](keyspaces-mrr-create.md)。

## 使用主控台
<a name="getting-started.keyspaces.con"></a>

**使用主控台建立金鑰空間**

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇 **金鑰空間**。

1. 選擇**建立金鑰空間**。

1. 在**金鑰空間名稱**方塊中，輸入 **catalog**做為金鑰空間的名稱。

   **名稱限制條件：**
   + 名稱不可為空白。
   + 允許的字元：英數字元和底線 `_` ()。
   + 長度上限為 48 個字元。

1. 在 下**AWS 區域**，確認**單一區域複寫**是 金鑰空間的複寫策略。

1. 若要建立金鑰空間，請選擇**建立金鑰空間**。

1. 執行下列動作，確認`catalog`已建立 金鑰空間：

   1. 在導覽窗格中，選擇 **金鑰空間**。

   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 的複寫係數，並在其區域中的三個 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"
   }
   ```