在 Amazon Keyspaces 中创建键空间 - Amazon Keyspaces（Apache Cassandra 兼容）

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Amazon Keyspaces 中创建键空间

在本部分中，将使用控制台、cqlsh 或 AWS CLI 创建键空间。

注意

开始之前，请确保您已具备所有教程先决条件。

键空间 对与一个或多个应用程序相关的表进行分组。键空间包含一个或多个表，并为其包含的所有表定义复制策略。有关键空间的更多信息，请参阅以下主题：

在本教程中，我们创建一个单区域键空间，键空间的复制策略是 SingleRegionStrategy。使用 SingleRegionStrategy，Amazon Keyspaces 在一个 AWS 区域的三个可用区中复制数据。要了解如何创建多区域键空间，请参阅在 Amazon Keyspaces 中创建多区域键空间。

使用控制台创建键空间

  1. 登录 AWS Management Console，然后打开 Amazon Keyspaces 控制台：https://console.aws.amazon.com/keyspaces/home。

  2. 在导航窗格中，选择 Keyspaces (键空间)。

  3. 选择 Create keyspace (创建键空间)。

  4. 在 Keyspace name (键空间名称) 框中，输入 catalog 作为键空间的名称。

    名称约束：

    • 名称不能为空。

    • 允许的字符：字母数字字符和下划线 (_)。

    • 最大长度为 48 个字符。

  5. 在 AWS 区域下，确认单区域复制是键空间的复制策略。

  6. 要创建键空间，请选择 Create keyspace (创建键空间)。

  7. 通过执行以下操作，验证键空间 catalog 是否已创建：

    1. 在导航窗格中，选择 Keyspaces (键空间)。

    2. 在键空间列表中，查找键空间 catalog。

以下过程使用 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.

  2. 使用以下 CQL 命令创建键空间。

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

    SingleRegionStrategy 使用复制因子 3，跨其区域内的多个 AWS 可用区复制数据。

    注意

    Amazon Keyspaces 默认所有输入为小写，除非括在引号中。

  3. 验证键空间是否已创建。

    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 创建键空间。

使用 AWS CLI 创建键空间

  1. 要确认您的环境已设置，您可以在 CloudShell 中运行以下命令。

    aws keyspaces help

  2. 使用以下 AWS CLI 语句创建键空间。

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

  3. 使用以下 AWS CLI 语句确认您的键空间是否已创建

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

    此命令的输出应类似于以下示例。

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