Conceitos básicos do Aurora DSQL

Escolha Nova conexão de banco de dados.

Na janela Nova conexão de banco de dados, escolha PostgreSQL.

Na guia Configurações de conexão/Principal, escolha Conectar por: host e insira as informações a seguir.

1. Host: use o endpoint do cluster.

   Banco de dados: insira postgres.

   Autenticação: escolha Database Native.

   Nome de usuário: insira admin.

   Senha: gere um token de autenticação. Copie o token gerado e use-o como senha.

Ignore quaisquer avisos e cole o token de autenticação no campo Senha do DBeaver.

Para começar a executar instruções SQL, você deve conectar-se ao cluster.

Escolha Nova fonte de dados e selecione PostgreSQL.

Na guia Fontes de Dados/Geral, insira as seguintes informações:

1. Host: use o endpoint do cluster.

   Porta: o Aurora DSQL usa o padrão do PostgreSQL: 5432.

   Banco de dados: o Aurora DSQL usa o padrão do PostgreSQL: postgres.

   Autenticação: escolha User & Password .

   Nome de usuário: insira admin.

   Senha: gere um token e cole-o neste campo.

   URL: não modifique este campo. Ele será preenchido automaticamente com base nos outros campos.

Senha: forneça-a gerando um token de autenticação. Copie a saída resultante do gerador de token e cole-a no campo de senha.

Para começar a executar instruções SQL, você deve conectar-se ao cluster.

Faça login no AWS Management Console e abra o console do Aurora DSQL em https://console.aws.amazon.com/dsql.

Escolha Criar cluster e Região única.

(Opcional) Em Configurações de cluster, selecione qualquer uma das seguintes opções:

(Opcional) Em Tags, escolha ou insira uma tag para o cluster.

Selecione Criar cluster.

Selecione o cluster de banco de dados do Aurora MySQL ao qual você deseja se conectar.

Selecione Conectar.

Em Endpoint (host), copie o endpoint.

A opção Conectar-se como administrado deve estar selecionada na seção Token de autenticação (senha).

Gere o token de autenticação. O token é válido por 15 minutos.

Na linha de comando, use o comando a seguir para iniciar o psql e se conectar ao cluster. Substitua your_cluster_endpoint pelo endpoint do cluster que você copiou anteriormente.

PGSSLMODE=require \
  psql --dbname postgres \
  --username admin \
  --host your_cluster_endpoint

Quando for solicitada uma senha, insira o token de autenticação que você copiou anteriormente. Se você tentar se reconectar usando um token expirado, a solicitação de conexão será negada. Para obter mais informações, consulte Gerar um token de autenticação no Amazon Aurora DSQL.

Pressione Enter. Você verá um prompt do PostgreSQL.

postgres=>

Se você receber um erro de acesso negado, confirme se sua identidade do IAM tenha a permissão dsql:DbConnectAdmin. Se você tiver a permissão e continuar recebendo erros de negação de acesso, consulte Solucionar problemas do IAM e Como solucionar erros de acesso negado ou operação não autorizada em uma política do IAM?.

Crie um esquema chamado example.

CREATE SCHEMA example;

Crie uma tabela de faturas que use um UUID gerado automaticamente como chave primária.

CREATE TABLE example.invoice(
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(), 
    created timestamp, 
    purchaser int, 
    amount float);

Crie um índice secundário que use a tabela vazia.

CREATE INDEX ASYNC invoice_created_idx on example.invoice(created);

Crie uma tabela de departamentos.

CREATE TABLE example.department(id INT PRIMARY KEY UNIQUE, name text, email text);

Use o comando psql \include para carregar o arquivo chamado department-insert-multirow.sql que você baixou do repositório aws-samples/aurora-dsql-samples no GitHub. Substitua my-path pelo caminho para sua cópia local.

\include my-path/department-insert-multirow.sql

Use o comando psql \copy para carregar o arquivo chamado invoice.csv que você baixou do repositório aws-samples/aurora-dsql-samples no GitHub. Substitua my-path pelo caminho para sua cópia local.

\copy example.invoice(created, purchaser, amount) from my-path/invoice.csv csv

Consulte os departamentos e classifique-os pelo total de vendas.

SELECT name, sum(amount) AS sum_amount
FROM example.department LEFT JOIN example.invoice ON department.id=invoice.purchaser
GROUP BY name
HAVING sum(amount) > 0
ORDER BY sum_amount DESC;

O exemplo de saída a seguir mostra que o Departamento Três tem o maior volume de vendas.

           name           |     sum_amount     
--------------------------+--------------------
 Example Department Three |  54061.67752854594
 Example Department Seven |  53869.65965365204
 Example Department Eight |  52199.73742066634
 Example Department One   | 52034.078869900826
 Example Department Six   |  50886.15556256385
 Example Department Two   |  50589.98422247931
 Example Department Five  | 49549.852635496005
 Example Department Four  |  49266.15578027619
(8 rows)

Faça login no AWS Management Console e abra o console do Aurora DSQL em https://console.aws.amazon.com/dsql.

No painel de navegação, escolha Clusters.

Escolha Criar cluster e Multirregião.

(Opcional) Em Configurações de cluster, selecione qualquer uma das seguintes opções para o cluster inicial:

Em Configurações multirregionais, escolha as seguintes opções para o cluster inicial:

(Opcional) Escolha tags para o cluster inicial.

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.

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.

Escolha uma das seguintes opções para o segundo cluster:

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

(Opcional) Escolha as configurações de cluster para o segundo cluster. Por exemplo, você pode escolher uma AWS KMS key.

Escolha Criar cluster para criar o segundo cluster.

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

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

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

Escolha Clusters.

Selecione a linha para o segundo cluster no cluster multirregional.

Em Ações, escolha Abrir no CloudShell.

Escolha Conectar-se como administrador.

Escolha Inicie o CloudShell.

Escolha Executar.

Crie um esquema de exemplo seguindo as etapas em Etapa 3: executar exemplos de comando SQL no Aurora DSQL.

Exemplos de transação

CREATE SCHEMA example;
CREATE TABLE example.invoice(id UUID PRIMARY KEY DEFAULT gen_random_uuid(), created timestamp, purchaser int, amount float);
CREATE INDEX ASYNC invoice_created_idx on example.invoice(created);
CREATE TABLE example.department(id INT PRIMARY KEY UNIQUE, name text, email text);

Use comandos copy e include do psql para carregar dados de amostra. Para obter mais informações, consulte Etapa 3: executar exemplos de comando SQL no Aurora DSQL.

\copy example.invoice(created, purchaser, amount) from samples/invoice.csv csv
\include samples/department-insert-multirow.sql

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

Escolha Clusters.

Selecione a linha para o segundo cluster no cluster multirregional.

Em Ações, escolha Abrir no CloudShell.

Escolha Conectar-se como administrador.

Escolha Inicie o CloudShell.

Escolha Executar.

Consulte os dados que você inseriu no segundo cluster.

SELECT name, sum(amount) AS sum_amount
FROM example.department 
LEFT JOIN example.invoice ON department.id=invoice.purchaser 
GROUP BY name 
HAVING sum(amount) > 0
ORDER BY sum_amount DESC;