Conecta-seEntrar na plataforma

Amazon RDS

Consultar e alterar bancos Amazon RDS compatíveis por meio da Data API.

Integrações e ferramentasBancos de dadosConexão: Credencial protegida

O que faz

Integre o Amazon RDS Aurora Serverless ao fluxo usando a Data API. Permite consultar, inserir, atualizar, excluir e executar SQL livre sem gerenciar conexões com o banco de dados.

Quando usar: Use quando o seu fluxo precisar consultar e alterar bancos Amazon RDS compatíveis por meio da Data API.

Exemplo de situação: Localizar um cadastro e aproveitar seus dados nas etapas seguintes.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione Amazon RDS ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Consulta (SELECT)Executa a operação “Consulta (SELECT)” com o bloco Amazon RDS.
Inserir dadosInsere dados com o bloco Amazon RDS.
Atualizar dadosAtualiza dados com o bloco Amazon RDS.
Excluir dadosExclui dados com o bloco Amazon RDS.
Executar SQL livreExecuta SQL livre com o bloco Amazon RDS.
Inspecionar esquemaInspeciona esquema com o bloco Amazon RDS.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Consulta (SELECT) · Inserir dados · Atualizar dados · Excluir dados · Executar SQL livre · Inspecionar esquema
    Padrão:
    Consulta (SELECT)

  • Região da AWS

    Obrigatório

    Região da AWS onde está o cluster do Amazon RDS (ex.: sa-east-1, São Paulo).

    Exemplo:
    us-east-1

  • ID da chave de acesso da AWS

    ObrigatórioDado protegido

    Informa o identificador exato do recurso na plataforma conectada.

    Padrão:
    Segredo protegido

  • Chave de acesso secreta da AWS

    ObrigatórioDado protegido

    Informe a sua chave de acesso secreta.

    Padrão:
    Segredo protegido

  • ARN do recurso

    Obrigatório

    ARN do cluster do Amazon RDS que será acessado, copiado da página do cluster no console da AWS (ex.: arn:aws:rds:sa-east-1:123456789012:cluster:meu-cluster).

    Exemplo:
    arn:aws:rds:us-east-1:123456789:cluster:my-cluster

  • ARN do segredo

    ObrigatórioDado protegido

    Informa uma credencial secreta. Guarde-a no cofre de credenciais e nunca a exponha em texto livre.

    Padrão:
    Segredo protegido

  • Nome do banco de dados

    Nome do banco de dados dentro do cluster do Amazon RDS (ex.: loja); é opcional.

    Exemplo:
    nome_do_banco

  • Nome da tabela

    Obrigatório conforme a operação

    Tabela do banco no Amazon RDS em que os dados serão inseridos, atualizados ou excluídos (ex.: pedidos).

    Aparece em:
    Inserir dados
    Exemplo:
    clientes

  • Consulta SQL

    Obrigatório conforme a operação

    Informa a consulta usada para localizar ou transformar dados.

    Aparece em:
    Consulta (SELECT)
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Dados (JSON)

    Obrigatório conforme a operação

    Informa dados estruturados ou código no formato exigido pelo campo.

    Aparece em:
    Inserir dados
    Exemplo:
    { "chave": "valor" }

  • Condições (JSON)

    Obrigatório conforme a operação

    Define as regras que determinam qual caminho será escolhido.

    Aparece em:
    Atualizar dados
    Exemplo:
    { "chave": "valor" }

  • Nome do esquema

    Esquema cujas tabelas e colunas serão inspecionadas: em PostgreSQL, normalmente public; em MySQL, o nome do banco de dados.

    Aparece em:
    Inspecionar esquema
    Exemplo:
    public (PostgreSQL) ou nome do banco (MySQL)

  • Mecanismo do banco de dados

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Inspecionar esquema
    Opções:
    Detectar automaticamente · Aurora PostgreSQL · Aurora MySQL
    Exemplo:
    Detectar automaticamente

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <amazonrds.message>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<amazonrds.message>stringMensagem de sucesso ou de erro que descreve o resultado da operação.
<amazonrds.rows>arrayLista das linhas retornadas pela consulta.
<amazonrds.rowCount>numberNúmero de linhas afetadas pela operação.
<amazonrds.engine>stringTipo de mecanismo detectado (na operação de inspeção).
<amazonrds.tables>arrayLista dos esquemas das tabelas, com colunas, chaves e índices (na operação de inspeção).
<amazonrds.schemas>arrayLista dos esquemas disponíveis no banco (na operação de inspeção).

Exemplo de uso

Objetivo: Localizar um cadastro e aproveitar seus dados nas etapas seguintes.

InícioAmazon RDSpróxima etapa
Operação
Consulta (SELECT)
Região da AWS
us-east-1
ARN do recurso
arn:aws:rds:us-east-1:123456789:cluster:my-cluster
Nome do banco de dados
nome_do_banco
Consulta SQL
SELECT * FROM clientes WHERE status = 'ativo'

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <amazonrds.message>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
Não foi possível conectar ao banco
Confira endereço, porta, nome do banco e usuário da conexão, e se o banco aceita conexões vindas da plataforma (firewall e lista de IPs liberados).
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados