

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Crie um keyspace no Amazon Keyspaces.
<a name="getting-started.keyspaces"></a>

Nesta seção, você cria um keyspace usando o console, `cqlsh` ou AWS CLI.

**nota**  
Antes de começar, certifique-se de que você configurou todos os [pré-requisitos do tutorial](getting-started.before-you-begin.md). 

Um *espaço de chave* agrupa tabelas relacionadas que são relevantes para um ou mais aplicativos. Um espaço de chave contém uma ou mais tabelas e define a estratégia de replicação para todas as tabelas que ele contém. Para obter mais informações sobre espaços de chaves, consulte os seguintes tópicos:
+ Instruções de Data Definition Language (DDL) na referência da linguagem CQL: [Keyspaces](cql.ddl.keyspace.md)
+ [Cotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md)

Neste tutorial, criamos um keyspace de região única, e a estratégia de replicação do keyspace é `SingleRegionStrategy`. Usando `SingleRegionStrategy`, o Amazon Keyspaces replica dados em três [zonas de disponibilidade](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) em uma Região da AWS. Para saber como criar chaves de réplica de várias regiões, consulte [Criar um espaço de chaves multirregional no Amazon Keyspaces](keyspaces-mrr-create.md).

## Utilizar o console
<a name="getting-started.keyspaces.con"></a>

**Para criar um espaço de chave usando o console**

1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)

1. No painel de navegação, escolha **Keyspaces**.

1. Selecione **Criar espaço de chaves**.

1. Na caixa **Nome do keyspace**, insira **catalog** como o nome do espaço de chaves.

   **Restrições de nome:**
   + Nome não pode estar vazio.
   + Caracteres permitidos: caracteres alfanuméricos e sublinhado ( `_` ).
   + O tamanho máximo é de 48 caracteres.

1. Em **Regiões da AWS**, confirme se a **Replicação em região única** é a estratégia de replicação para o espaço de chave.

1. Para criar o espaço de chaves, escolha **Criar espaço de chaves**.

1. Verifique se o espaço de chave `catalog` foi criado fazendo o seguinte:

   1. No painel de navegação, escolha **Keyspaces**.

   1. Localize seu espaço de chave `catalog` na lista de espaços de chave.

## Usar SSL
<a name="getting-started.keyspaces.cql"></a>

O procedimento a seguir cria um espaço de chave usando CQL.

**Para criar um espaço de chave usando CQL**

1. Abra AWS CloudShell e conecte-se ao Amazon Keyspaces usando o comando a seguir. Certifique-se de atualizar *us-east-1* com sua própria região.

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

   A saída do comando deve ser algo parecido com isso.

   ```
   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. Crie seu espaço de chave usando o seguinte comando CQL.

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

   `SingleRegionStrategy`usa um fator de replicação de três e replica dados em três zonas de AWS disponibilidade em sua região.
**nota**  
O Amazon Keyspaces usa como padrão todas as entradas em minúsculas, a menos que você as coloque entre aspas. 

1. Verifique se seu espaço de chave foi criado.

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

   A saída deste comando deve ser semelhante a esta.

   ```
   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)
   ```

## Usando o AWS CLI
<a name="getting-started.keyspaces.cli"></a>

O procedimento a seguir cria um espaço de chave usando AWS CLI.

**Para criar um espaço de teclas usando o AWS CLI**

1. Para confirmar se seu ambiente está configurado, você pode executar o seguinte comando em CloudShell.

   ```
   aws keyspaces help
   ```

1. Crie seu keyspace usando a seguinte AWS CLI declaração.

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

1. Verifique se o seu keyspace foi criado com a seguinte declaração AWS CLI 

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

   A saída deste comando deve ser semelhante a este exemplo.

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