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á.
# Criando, editando ou excluindo ações de dados
As ações de dados são usadas em aplicativos para executar ações nos dados de uma entidade, como buscar todos os registros ou buscar um registro por ID. As ações de dados podem ser usadas para localizar e retornar dados que correspondam às condições especificadas para serem visualizados em componentes como tabelas ou visualizações de detalhes.
**Contents**
+ [Criação de ações de dados](#data-entities-data-action-add)
+ [Editando ou configurando ações de dados](#data-entities-data-action-edit)
+ [Operadores e exemplos de condições de ação de dados](#data-entities-data-action-operators)
+ [Suporte ao operador de condições por banco de dados](#data-entities-data-action-operators-support)
+ [Exemplos de condições de ação de dados](#data-entities-data-action-operators-examples)
+ [Excluindo ações de dados](#data-entities-data-action-delete)
## Criação de ações de dados
**dica**
Você pode pressionar CTRL\+Z para desfazer a alteração mais recente em sua entidade.
1. Se necessário, navegue até a entidade para a qual você deseja criar ações de dados.
1. Escolha a guia **Ações de dados**.
1. Há dois métodos para criar ações de dados:
+ (Recomendado) Para usar a IA para gerar ações de dados para você, com base no nome da entidade, nos campos e na fonte de dados conectada, escolha **Gerar ações de dados**. As seguintes ações serão geradas:
1. `getAll`: recupera todos os registros de uma entidade. Essa ação é útil quando você precisa exibir uma lista de registros ou realizar operações em vários registros ao mesmo tempo.
1. `getByID`: recupera um único registro de uma entidade com base em seu identificador exclusivo (ID ou chave primária). Essa ação é útil quando você precisa exibir ou executar operações em um registro específico.
+ Para adicionar uma única ação de dados, escolha **\+ Adicionar ação de dados**.
1. Para visualizar ou configurar a nova ação de dados, consulte a seção a seguir,[Editando ou configurando ações de dados](#data-entities-data-action-edit).
## Editando ou configurando ações de dados
1. Se necessário, navegue até a entidade para a qual você deseja criar ações de dados.
1. Escolha a guia **Ações de dados**.
1. Em **Campos**, configure os campos a serem retornados pela consulta. Por padrão, todos os campos configurados na entidade são selecionados.
Você também pode adicionar **junções** à ação de dados executando as seguintes etapas:
1. Escolha **\+ Adicionar união** para abrir uma caixa de diálogo.
1. Em **Entidade relacionada**, selecione a entidade que você deseja unir à entidade atual.
1. Em **Alias**, opcionalmente, insira um nome de alias temporário para a entidade relacionada.
1. Em **Tipo de união**, selecione o tipo de união desejado.
1. Defina a cláusula de junção selecionando os campos de cada entidade.
1. Escolha **Adicionar** para criar a união.
Depois de criada, a união será exibida na seção **Junções**, disponibilizando campos adicionais no menu **suspenso Campos a serem retornados**. Você pode adicionar várias uniões, incluindo uniões encadeadas entre entidades. Você também pode filtrar e classificar por campos de entidades unidas.
Para excluir uma união, escolha o ícone da lixeira ao lado dela. Isso removerá todos os campos dessa junção e quebrará todas as junções ou restrições dependentes usando esses campos.
1. Em **Condições**, adicione, edite ou remova regras que filtram a saída da consulta. Você pode organizar as regras em grupos e agrupar várias regras com `AND` ou `OR` declarações. Para obter mais informações sobre os operadores que você pode usar, consulte[Operadores e exemplos de condições de ação de dados](#data-entities-data-action-operators).
1. Em **Classificação**, configure como os resultados da consulta são classificados escolhendo um atributo e escolhendo a ordem crescente ou decrescente. Você pode remover a configuração de classificação escolhendo o ícone de lixeira ao lado da regra de classificação.
1. Em **Transformar resultados**, você pode inserir resultados personalizados JavaScript para modificar ou formatar os resultados antes que eles sejam exibidos ou enviados para as automações.
1. Em **Visualização de saída**, visualize uma tabela de visualização da saída da consulta com base nos campos, filtros, classificação e. JavaScript
## Operadores e exemplos de condições de ação de dados
Você pode usar operadores de condição para comparar um valor de expressão configurado com uma coluna de entidade para retornar um subconjunto de objetos do banco de dados. Os operadores que você pode usar dependem do tipo de dados da coluna e do tipo de banco de dados ao qual a entidade está conectada, como Amazon Redshift, Amazon Aurora ou Amazon DynamoDB.
Os seguintes operadores de condição podem ser usados com todos os serviços de banco de dados:
+ `=`e`!=`: Disponível para todos os tipos de dados (exceto colunas de chave primária).
+ `<=`,`>=`,`<`, e`>=`: Disponível somente para colunas numéricas.
+ `IS NULL`e`IS NOT NULL`: Usado para combinar colunas que têm valores nulos ou vazios. Os valores nulos geralmente são interpretados de forma diferente em cada banco de dados. No entanto, no App Studio, o `NULL` operador corresponde e retorna registros que têm valores nulos na tabela do banco de dados conectado.
Os operadores de condição a seguir só podem ser usados em entidades conectadas a serviços de banco de dados que os suportam:
+ `LIKE`e `NOT LIKE` (Redshift, Aurora): usado para realizar consultas baseadas em padrões no banco de dados conectado. O `LIKE` operador oferece flexibilidade na funcionalidade de pesquisa porque encontra e retorna registros que se encaixam nos padrões especificados. Você define os padrões usando caracteres curinga que correspondem a qualquer caractere ou sequência de caracteres dentro do padrão. Cada sistema de gerenciamento de banco de dados tem um conjunto exclusivo de caracteres curinga, mas os dois mais populares são `%` representar qualquer número de caracteres (incluindo 0) e `_` representar um único caractere.
+ `Contains`e `Not Contains` (DynamoDB): usado para realizar uma pesquisa com distinção entre maiúsculas e minúsculas para determinar se o texto fornecido é encontrado nos valores da coluna.
+ `Starts With`e `Not Starts With` (DynamoDB): usado para realizar uma pesquisa com distinção entre maiúsculas e minúsculas para determinar se o texto fornecido é encontrado no início dos valores da coluna.
### Suporte ao operador de condições por banco de dados
A tabela a seguir mostra quais operadores de condição de ação de dados são compatíveis com cada banco de dados que pode se conectar ao App Studio.
| | =, \!=, <, >, <=, >= | COMO, NÃO COMO | Contém, não contém | Começa com, não começa com | É NULO, NÃO É NULO |
| --- | --- | --- | --- | --- | --- |
| **DynamoDB** | Sim | Não | Sim | Sim | Sim |
| **Aurora** | Sim | Sim | Não | Não | Sim |
| **Redshift** | Sim | Sim | Não | Não | Sim |
### Exemplos de condições de ação de dados
Considere a tabela de banco de dados a seguir, que inclui vários itens com `name``city`, e `hireDate` campos.
| name | cidade | Data de contratação |
| --- | --- | --- |
| Adão | Seattle | 2025-03-01 |
| Adrienne | Boston | 2025-03-05 |
| Bob | Albuquerque | 2025-03-06 |
| Carlos | Chicago | 2025-03-10 |
| Caroline | NULL | 2025-03-12 |
| Rita | Miami | 2025-03-15 |
Agora, considere criar ações de dados no App Studio que retornem o `name` campo para itens que correspondam às condições especificadas. A lista a seguir contém exemplos de condições e os valores que a tabela retorna para cada uma.
**nota**
Os exemplos são formatados como exemplos de SQL. Eles podem não aparecer como no App Studio, mas são usados para ilustrar o comportamento dos operadores.
+ `WHERE name LIKE 'Adam'`: Devoluções`Adam`.
+ `WHERE name LIKE 'A%'`: Devoluções `Adam` `Adrienne` e.
+ `WHERE name NOT LIKE 'B_B'`: Retorna `Adam` `Adrienne``Carlos`,`Caroline`,, `Rita` e.
+ `WHERE contains(name, 'ita')`: Devoluções`Rita`.
+ `WHERE begins_with(name, 'Car')`: Devoluções `Carlos` `Caroline` e.
+ `WHERE city IS NULL`: Devoluções`Caroline`.
+ `WHERE hireDate < "2025-03-06"`: Devoluções `Adam` `Adrienne` e.
+ `WHERE hireDate >= DateTime.now().toISODate()`: Observe que `DateTime.now().toISODate()` retorna a data atual. Em um cenário em que a data atual é 2025-03-10, a expressão retorna`Carlos`, e. `Caroline` `Rita`
**dica**
Para obter mais informações sobre como comparar datas e horas em expressões, consulte[Data e hora](expressions.md#expressions-date-time).
## Excluindo ações de dados
Use o procedimento a seguir para excluir ações de dados de uma entidade do App Studio.
1. Se necessário, navegue até a entidade da qual você deseja excluir ações de dados.
1. Escolha a guia **Ações de dados**.
1. **Para cada ação de dados que você deseja excluir, escolha o menu suspenso ao lado de **Editar** e escolha Excluir.**
1. Escolha **Confirmar** na caixa de diálogo.