# Conceitos básicos do Aurora DSQL
<a name="getting-started"></a>

O Amazon Aurora DSQL é um banco de dados relacional distribuído, totalmente gerenciado e sem servidor, otimizado para workloads transacionais. Nas seções a seguir, você aprenderá a criar clusters do Aurora DSQL de região única e multirregionais, conectar-se a eles e criar e carregar um esquema de exemplo. Você vai acessar clusters com o Console da AWS e, opcionalmente, interagir com seu banco de dados usando os clientes do PostgreSQL. Ao final, você terá um cluster do Aurora DSQL funcional configurado e pronto para uso em workloads de teste ou produção.

**Topics**
+ [Pré-requisitos](#getting-started-prereqs)
+ [Etapa 1: criar um cluster do Aurora DSQL de região única](#getting-started-create-cluster)
+ [Etapa 2: conectar-se a um cluster do Aurora DSQL](#connect-dsql-cluster)
+ [Etapa 3: executar exemplos de comando SQL no Aurora DSQL](#getting-started-sql)
+ [Etapa 4 (opcional): criar um cluster multirregional](#getting-started-multi-region)
+ [Solução de problemas](#getting-started-sql-troubleshooting)

## Pré-requisitos
<a name="getting-started-prereqs"></a>

Antes de começar a usar o Aurora DSQL, verifique se você atende aos seguintes pré-requisitos.
+ Sua identidade do IAM deve ter permissão para [fazer login no console](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html).
+ Sua identidade do IAM deve atender aos seguintes critérios:
  + Ter acesso para executar qualquer ação em qualquer recurso em sua Conta da AWS.
  + A política gerenciada pela AWS `AmazonAuroraDSQLConsoleFullAccess` é [anexada](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonAuroraDSQLConsoleFullAccess.html).

## Etapa 1: criar um cluster do Aurora DSQL de região única
<a name="getting-started-create-cluster"></a>

A unidade básica do Aurora DSQL é o cluster, onde você armazena seus dados. Nesta tarefa, você cria um cluster em uma única Região da AWS.

**Como criar um cluster de região única no Aurora DSQL**

1. Faça login no Console de gerenciamento da AWS e abra o console do Aurora DSQL em [https://console.aws.amazon.com/dsql](https://console.aws.amazon.com/dsql).

1. Escolha **Criar cluster** e **Região única**.

1. (Opcional) Altere o valor da tag **nome** padrão.

1. (Opcional) Adicione **tags** adicionais para esse cluster.

1. (Opcional) Em **Configurações de cluster**, selecione qualquer uma das seguintes opções:
   + Selecione **Configurações de criptografia personalizadas (avançado)** para escolher ou criar uma AWS KMS key. Ao usar uma chave gerenciada pelo cliente, garanta que a política de chave conceda as permissões necessárias ao Aurora DSQL. Para obter mais informações, consulte [Política de chaves para uma chave gerenciada pelo cliente](data-encryption.md#key-policy-customer-managed-key).
   + Selecione **Habilitar proteção contra exclusão** para impedir que o cluster de banco de dados seja excluído. Por padrão, a proteção contra exclusão fica selecionada.
   + Selecione **Política baseada em recursos (avançada)** para especificar políticas de controle de acesso para esse cluster.

1. Selecione **Criar cluster**.

1. O console faz com que você retorne para a página **Clusters**. Banner de notificação indicando que o cluster está sendo criado. Selecione o **ID do cluster** para abrir a visualização dos detalhes do cluster.

## Etapa 2: conectar-se a um cluster do Aurora DSQL
<a name="connect-dsql-cluster"></a>

O Aurora DSQL comporta várias maneiras de se conectar ao seu cluster, incluindo o Editor de consultas do DSQL, AWS CloudShell, o cliente psql local e outras ferramentas compatíveis com o PostgreSQL. Nesta etapa, você se conecta usando o [Editor de consultas do Aurora DSQL](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/getting-started-query-editor.html), que oferece uma maneira rápida de começar a interagir com seu novo cluster.

**Como se conectar usando o Editor de consultas**

1. No console do Aurora DSQL ([https://console.aws.amazon.com/dsql](https://console.aws.amazon.com/dsql)), abra a página **Clusters** e confirme se a criação do cluster foi concluída e se seu status é Ativo.

1. Escolha seu cluster na lista ou o **ID do cluster** para abrir a página de detalhes do cluster.

1. Escolha **Conectar com o Editor de consultas**.

1. Escolha Conectar como **administrador** para o cluster que acabou de ser criado.
   + Você também pode se conectar com um perfil personalizado. Consulte [Usar perfis de banco de dados e autenticação do IAM](using-database-and-iam-roles.md).

## Etapa 3: executar exemplos de comando SQL no Aurora DSQL
<a name="getting-started-sql"></a>

Teste o cluster do Aurora DSQL executando instruções SQL. Depois de abrir o cluster no Editor de consultas, selecione e execute cada exemplo de consulta passo a passo.

**Executar exemplos de comando SQL no Aurora DSQL**

1. Crie um esquema chamado `test`.

   ```
   CREATE SCHEMA IF NOT EXISTS test;
   ```

1. Crie uma tabela hello\$1world que use um UUID gerado automaticamente como chave primária.

   ```
   CREATE TABLE IF NOT EXISTS test.hello_world (  
       id UUID PRIMARY KEY DEFAULT gen_random_uuid(),  
       message VARCHAR(255) NOT NULL,  
       created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP  
   );
   ```

1. Insira uma linha de exemplo.

   ```
   INSERT INTO test.hello_world (message)  
   VALUES ('Hello, World!!');
   ```

1. Leia os valores inseridos.

   ```
   SELECT * FROM test.hello_world;
   ```

1. Limpar opcionalmente

   ```
   DROP TABLE test.hello_world;
   DROP SCHEMA test;
   ```

## Etapa 4 (opcional): criar um cluster multirregional
<a name="getting-started-multi-region"></a>

Ao criar um cluster multirregional, você deve especificar as seguintes regiões:

**Região remota**  
Essa é a região na qual você cria um segundo cluster. Você cria um segundo cluster nessa região e o conecta ao cluster inicial. O Aurora DSQL replica todas as gravações no cluster inicial para o cluster remoto. Você pode ler e gravar em qualquer cluster.

**Região testemunha**  
Essa região recebe todos os dados gravados no cluster multirregional. Entretanto, as regiões testemunha não hospedam endpoints de clientes e não oferecem acesso aos dados do usuário. Uma janela limitada de logs de transações criptografados é mantida nas regiões testemunha. Isso facilita a recuperação e permite um quórum transacional caso uma região fique indisponível.

Use o procedimento a seguir para criar um cluster inicial, criar um segundo cluster em uma região diferente e, depois, conectar os dois clusters para criar um cluster multirregional. Demonstra também a replicação de gravação entre regiões e leituras consistentes de ambos os endpoints regionais.

**Como criar um cluster multirregional**

1. Faça login no [console do Aurora DSQL](https://console.aws.amazon.com/dsql).

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

1. Escolha **Criar cluster** e **Multirregião**.

1. (Opcional) Altere o valor da tag **nome** padrão.

1. (Opcional) Adicione **tags** adicionais para esse cluster.

1. Em **Configurações multirregionais**, escolha as seguintes opções para o cluster inicial:
   + Em **Região testemunha**, escolha uma região. No momento, somente regiões baseadas nos EUA são aceitas para regiões testemunha em clusters multirregionais.
   + (Opcional) Em **ARN do cluster da região remota**, insira um ARN para um cluster existente em outra região. Se não houver nenhum cluster para servir como segundo cluster no cluster multirregional, conclua a configuração depois de criar o cluster inicial.

1. (Opcional) Em **Configurações de cluster**, selecione qualquer uma das seguintes opções para o cluster inicial:
   + Selecione **Configurações de criptografia personalizadas (avançado)** para escolher ou criar uma AWS KMS key. Ao usar uma chave gerenciada pelo cliente, garanta que a política de chave conceda as permissões necessárias ao Aurora DSQL. Para obter mais informações, consulte [Política de chaves para uma chave gerenciada pelo cliente](data-encryption.md#key-policy-customer-managed-key).
   + Selecione **Habilitar proteção contra exclusão** para impedir que o cluster de banco de dados seja excluído. Por padrão, a proteção contra exclusão fica selecionada.
   + Selecione **Política baseada em recursos (avançada)** para especificar políticas de controle de acesso para esse cluster.

1. EEscolha **Criar cluster** para criar o cluster inicial. Se você não inseriu um ARN na etapa anterior, o console mostrará a notificação **Configuração do cluster pendente**.

1. Na notificação **Configuração do cluster pendente**, escolha **Concluir configuração do cluster multirregional**. Essa ação inicia a criação de um segundo cluster em outra região.

1. Escolha uma das seguintes opções para o segundo cluster:
   + **Adicionar ARN do cluster da região remota**: escolha essa opção se houver um cluster e você quiser que ele seja o segundo no cluster multirregional.
   + **Criar cluster em outra região**: escolha essa opção para criar um segundo cluster. Em **Região remota**, escolha a região para esse segundo cluster.

1. Escolha **Criar cluster na *your-second-region***, em que *your-second-region* é o local do segundo cluster. O console abre na segunda região.

1. (Opcional) Escolha as configurações de cluster para o segundo cluster. Por exemplo, você pode escolher uma AWS KMS key. Ao usar uma chave gerenciada pelo cliente, garanta que a política de chave conceda as permissões necessárias ao Aurora DSQL. Para obter mais informações, consulte [Política de chaves para uma chave gerenciada pelo cliente](data-encryption.md#key-policy-customer-managed-key).

1. Escolha **Criar cluster** para criar o segundo cluster.

1. Escolha **Emparelhar na *initial-cluster-region***, em que *initial-cluster-region* é a região que hospeda o primeiro cluster que você criou.

1. Quando solicitado, selecione **Sim** para confirmar. Essa etapa conclui a criação do cluster multirregional.

**Como se conectar e usar o cluster**

1. Abra o console do Aurora DSQL e escolha a região para o segundo cluster.

1. Escolha **Clusters**.

1. Selecione a linha para o segundo cluster no cluster multirregional.

1. Escolha **Conectar com o Editor de consultas**.

1. Escolha **Conectar-se como administrador**.

1. Crie um esquema de exemplo e uma tabela e insira dados seguindo as etapas em [Etapa 3: executar exemplos de comando SQL no Aurora DSQL](#getting-started-sql).

**Como consultar dados no segundo cluster na região que hospeda o cluster inicial**

1. No console do Aurora DSQL, escolha a região do cluster inicial.

1. Escolha **Clusters**.

1. Selecione a linha para o segundo cluster no cluster multirregional.

1. Escolha **Conectar com o Editor de consultas**.

1. Escolha **Conectar-se como administrador**.

1. Consulte os dados que você inseriu no segundo cluster.  
**Example**  

   ```
   SELECT * FROM test.hello_world;
   ```

## Solução de problemas
<a name="getting-started-sql-troubleshooting"></a>

Consulte a seção [Solução de problemas](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/troubleshooting.html) da documentação do Aurora DSQL.