Conecta-seEntrar na plataforma

Amazon DynamoDB

Consultar, inserir, varrer, atualizar e excluir itens em tabelas do Amazon DynamoDB.

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

O que faz

Integra o Amazon DynamoDB aos fluxos. Permite ler, gravar, consultar, varrer, atualizar e excluir itens, além de inspecionar o esquema das tabelas do DynamoDB.

Quando usar: Use quando o seu fluxo precisar consultar, inserir, varrer, atualizar e excluir itens em tabelas do Amazon DynamoDB.

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 DynamoDB 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
Ler itemLê item com o bloco Amazon DynamoDB.
Gravar itemGrava item com o bloco Amazon DynamoDB.
ConsultarConsulta com o bloco Amazon DynamoDB.
Varrer tabelaVarre tabela com o bloco Amazon DynamoDB.
Atualizar itemAtualiza item com o bloco Amazon DynamoDB.
Excluir itemExclui item com o bloco Amazon DynamoDB.
Inspecionar esquemaInspeciona esquema com o bloco Amazon DynamoDB.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Ler item · Gravar item · Consultar · Varrer tabela · Atualizar item · Excluir item · Inspecionar esquema
    Padrão:
    Ler item

  • Região da AWS

    Obrigatório

    Região da AWS onde está a tabela do DynamoDB (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

  • Nome da tabela

    Obrigatório conforme a operação

    Define o nome ou título usado para identificar o recurso.

    Quando aparece:
    Quando o campo “Operação” for diferente de “Inspecionar esquema”
    Exemplo:
    Exemplo de atendimento

  • Nome da tabela (opcional)

    Deixe vazio para listar todas as tabelas.

    Aparece em:
    Inspecionar esquema
    Exemplo:
    Exemplo de atendimento

  • Chave (JSON)

    Obrigatório conforme a operação

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

    Aparece em:
    Ler item
    Exemplo:
    { "chave": "valor" }

  • Chave (JSON)

    Obrigatório conforme a operação

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Atualizar item
    Exemplo:
    2026-09-15

  • Chave (JSON)

    Obrigatório conforme a operação

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

    Aparece em:
    Excluir item
    Exemplo:
    { "chave": "valor" }

  • Leitura consistente

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Ler item
    Opções:
    Consistência eventual · Consistência forte
    Padrão:
    Consistência eventual

  • Item (JSON)

    Obrigatório conforme a operação

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

    Aparece em:
    Gravar item
    Exemplo:
    { "chave": "valor" }

  • Expressão de condição da chave

    Obrigatório conforme a operação

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Consultar
    Exemplo:
    status = 'ativo'

  • Expressão de atualização

    Obrigatório conforme a operação

    SET #name = :name.

    Aparece em:
    Atualizar item
    Exemplo:
    2026-09-15

  • Expressão de filtro

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Consultar
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Expressão de filtro

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Varrer tabela
    Exemplo:
    status = 'ativo'

  • Expressão de projeção

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Varrer tabela
    Exemplo:
    status = 'ativo'

  • Nomes de atributos da expressão (JSON)

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Consultar
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Nomes de atributos da expressão (JSON)

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Varrer tabela
    Exemplo:
    status = 'ativo'

  • Nomes de atributos da expressão (JSON)

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Atualizar item
    Exemplo:
    2026-09-15

  • Nomes de atributos da expressão (JSON)

    Em campos adicionais

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Gravar item
    Exemplo:
    status = 'ativo'

  • Nomes de atributos da expressão (JSON)

    Em campos adicionais

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Excluir item
    Exemplo:
    status = 'ativo'

  • Valores de atributos da expressão (JSON)

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Consultar
    Exemplo:
    150.00

  • Valores de atributos da expressão (JSON)

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Varrer tabela
    Exemplo:
    150.00

  • Valores de atributos da expressão (JSON)

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Atualizar item
    Exemplo:
    2026-09-15

  • Valores de atributos da expressão (JSON)

    Em campos adicionais

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Gravar item
    Exemplo:
    150.00

  • Valores de atributos da expressão (JSON)

    Em campos adicionais

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Excluir item
    Exemplo:
    150.00

  • Nome do índice

    Em campos adicionais

    Define o nome ou título usado para identificar o recurso.

    Aparece em:
    Consultar
    Exemplo:
    Exemplo de atendimento

  • Limite

    Em campos adicionais

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Consultar
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Limite

    Em campos adicionais

    Define um valor numérico, quantidade ou limite da operação.

    Aparece em:
    Varrer tabela
    Exemplo:
    10

  • Expressão de condição

    Em campos adicionais

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Gravar item
    Exemplo:
    status = 'ativo'

  • Expressão de condição

    Em campos adicionais

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Atualizar item
    Exemplo:
    2026-09-15

  • Expressão de condição

    Em campos adicionais

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Excluir item
    Exemplo:
    status = 'ativo'

  • Chave de início da página (JSON)

    Em campos adicionais

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Consultar
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Chave de início da página (JSON)

    Em campos adicionais

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

    Aparece em:
    Varrer tabela
    Exemplo:
    { "chave": "valor" }

  • Ordem

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Consultar
    Opções:
    Crescente (padrão) · Decrescente
    Padrão:
    Crescente (padrão)

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 <amazondynamodb.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
<amazondynamodb.message>stringMensagem de sucesso ou de erro que descreve o resultado da operação.
<amazondynamodb.item>jsonItem retornado pela leitura ou pela atualização.
<amazondynamodb.items>arrayLista de itens retornados pela consulta ou pela varredura.
<amazondynamodb.count>numberNúmero de itens retornados.
<amazondynamodb.lastEvaluatedKey>jsonToken de paginação da consulta/varredura — passe como exclusiveStartKey para obter a próxima página.
<amazondynamodb.tables>arrayLista com os nomes das tabelas, retornada ao inspecionar o esquema.
<amazondynamodb.tableDetails>jsonEsquema detalhado de uma tabela específica, retornado ao inspecionar o esquema.

Exemplo de uso

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

InícioAmazon DynamoDBpróxima etapa
Operação
Ler item
Região da AWS
us-east-1
Nome da tabela
Exemplo de atendimento
Chave (JSON)
{ "chave": "valor" }

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 <amazondynamodb.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