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á.
# Entidades e ações de dados: configure o modelo de dados do seu aplicativo
**As entidades** são tabelas de dados no App Studio. As entidades interagem diretamente com as tabelas nas fontes de dados. As entidades incluem campos para descrever os dados neles contidos, consultas para localizar e retornar dados e mapeamento para conectar os campos da entidade às colunas de uma fonte de dados.
**Topics**
+ [Melhores práticas ao projetar modelos de dados](data-model-best-practices.md)
+ [Criação de uma entidade em um aplicativo do App Studio](data-entities-create.md)
+ [Configurando ou editando uma entidade em um aplicativo do App Studio](data-entities-edit.md)
+ [Excluindo uma entidade](data-entities-delete.md)
+ [Entidades de dados gerenciadas no AWS App Studio](managed-data-entities.md)
# Melhores práticas ao projetar modelos de dados
Use as práticas recomendadas a seguir para criar um modelo de dados relacional robusto, escalável e seguro AWS para uso em seu aplicativo do App Studio que atenda aos requisitos do seu aplicativo e garanta a confiabilidade e o desempenho de longo prazo de sua infraestrutura de dados.
+ **Escolha o serviço de AWS dados certo:** dependendo de suas necessidades, escolha o serviço de AWS dados apropriado. Por exemplo, para um aplicativo de processamento de transações on-line (OLTP), você pode considerar um banco de dados (DB) como o Amazon Aurora, que é um serviço de banco de dados nativo da nuvem, relacional e totalmente gerenciado que oferece suporte a vários mecanismos de banco de dados, como MySQL e PostgreSQL. Para ver uma lista completa das versões do Aurora suportadas pelo App Studio, consulte. [Conecte-se ao Amazon Aurora](connectors-aurora.md) Por outro lado, para casos de uso de processamento analítico on-line (OLAP), considere usar o Amazon Redshift, que é um data warehouse na nuvem que permite executar consultas complexas em conjuntos de dados muito grandes. Essas consultas geralmente podem levar tempo (vários segundos) para serem concluídas, tornando o Amazon Redshift menos adequado para aplicativos OLTP que exigem acesso a dados de baixa latência.
+ **Design para escalabilidade:** planeje seu modelo de dados pensando no crescimento e na escalabilidade futuros. Considere fatores como volume de dados esperado, padrões de acesso e requisitos de desempenho ao escolher um serviço de dados adequado e tipo e configuração de instância de banco de dados (como capacidade provisionada).
+ Para obter mais informações sobre escalabilidade com o Aurora sem servidor, [consulte Desempenho e escalabilidade do Aurora Serverless V2.](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.setting-capacity.html)
+ **Normalize seus dados:** siga os princípios da normalização do banco de dados para minimizar a redundância dos dados e melhorar a integridade dos dados. Isso inclui criar tabelas apropriadas, definir chaves primárias e estrangeiras e estabelecer relacionamentos entre entidades. No App Studio, ao consultar dados de uma entidade, você pode recuperar dados relacionados de outra entidade especificando uma `join` cláusula na consulta.
+ **Implemente a indexação apropriada:** identifique as consultas e os padrões de acesso mais importantes e crie índices apropriados para otimizar o desempenho.
+ **Aproveite AWS os recursos dos serviços de dados:** aproveite os recursos oferecidos pelo serviço de AWS dados que você escolher, como backups automatizados, implantações Multi-AZ e atualizações automáticas de software.
+ **Proteja seus dados:** implemente medidas de segurança robustas, como políticas IAM (AWS Identity and Access Management), criação de usuários de banco de dados com permissões restritas a tabelas e esquemas e aplique criptografia em repouso e em trânsito.
+ **Monitore e otimize o desempenho:** monitore continuamente o desempenho do seu banco de dados e faça ajustes conforme necessário, como escalar recursos, otimizar consultas ou ajustar as configurações do banco de dados.
+ **Automatize o gerenciamento do banco de dados:** utilize AWS serviços como o Aurora Autoscaling, o Performance Insights for Aurora e o AWS Database Migration Service para automatizar as tarefas de gerenciamento do banco de dados e reduzir a sobrecarga operacional.
+ **Implemente estratégias de recuperação de desastres e backup:** garanta que você tenha um plano de backup e recuperação bem definido, aproveitando recursos como backups automatizados do Aurora, point-in-time recuperação e configurações de réplica entre regiões.
+ **Siga as AWS melhores práticas e a documentação:** fique up-to-date com as AWS melhores práticas, diretrizes e documentação mais recentes do serviço de dados escolhido para garantir que seu modelo de dados e sua implementação estejam alinhados às AWS recomendações.
Para obter orientações mais detalhadas de cada serviço de AWS dados, consulte os tópicos a seguir:
+ [Melhores práticas com o Amazon Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.BestPractices.html)
+ [Melhores práticas com o Amazon Aurora MySQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.BestPractices.html)
+ [Ajuste de desempenho de consultas do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/c-optimizing-query-performance.html)
+ [Melhores práticas para consultar e escanear dados no Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-query-scan.html)
# Criação de uma entidade em um aplicativo do App Studio
Há quatro métodos para criar uma entidade em um aplicativo do App Studio. A lista a seguir contém cada método, seus benefícios e um link para as instruções de uso desse método para criar e depois configurar a entidade.
+ [Criação de uma entidade a partir de uma fonte de dados existente](#data-entities-create-existing-data-source): crie automaticamente uma entidade e seus campos a partir de uma tabela de fonte de dados existente e mapeie os campos para as colunas da tabela de fonte de dados. Essa opção é preferível se você tiver uma fonte de dados existente que queira usar no seu aplicativo do App Studio.
+ [Criação de uma entidade com uma fonte de dados gerenciada do App Studio](#data-entities-create-managed-data-source): crie uma entidade e uma tabela do DynamoDB que o App Studio gerencie para você. A tabela do DynamoDB é atualizada automaticamente à medida que você atualiza sua entidade. Com essa opção, você não precisa criar, gerenciar ou conectar manualmente uma fonte de dados de terceiros nem designar o mapeamento dos campos da entidade para as colunas da tabela. Toda a modelagem e configuração de dados do seu aplicativo são feitas no App Studio. Essa opção é preferível se você não quiser gerenciar suas próprias fontes de dados e uma tabela do DynamoDB. Sua funcionalidade é suficiente para seu aplicativo.
+ [Criando uma entidade vazia](#data-entities-create-empty): Crie uma entidade vazia inteiramente do zero. Essa opção é preferível se você não tiver nenhuma fonte de dados ou conectores existentes criados por um administrador e quiser projetar com flexibilidade o modelo de dados do seu aplicativo sem ser limitado por fontes de dados externas. Você pode conectar a entidade a uma fonte de dados após a criação.
+ [Criação de uma entidade com IA](#data-entities-create-with-ai): gere uma entidade, campos, ações de dados e dados de amostra com base no nome da entidade especificada. Essa opção é preferível se você tiver uma ideia do modelo de dados do seu aplicativo, mas quiser ajuda para traduzi-lo em uma entidade.
## Criação de uma entidade a partir de uma fonte de dados existente
Use uma tabela de uma fonte de dados para criar automaticamente uma entidade e seus campos e mapear os campos da entidade para as colunas da tabela. Essa opção é preferível se você tiver uma fonte de dados existente que queira usar no seu aplicativo do App Studio.
1. Se necessário, navegue até seu aplicativo.
1. Escolha a guia **Dados** na parte superior da tela.
1. Se não houver entidades em seu aplicativo, escolha **\$1 Criar entidade**. Caso contrário, no menu **Entidades** do lado esquerdo, escolha **\$1** Adicionar.
1. Selecione **Usar uma tabela de uma fonte de dados existente**.
1. Em **Conector**, selecione o conector que contém a tabela que você deseja usar para criar sua entidade.
1. Em **Tabela**, escolha a tabela que você deseja usar para criar sua entidade.
1. Marque a caixa de seleção **Criar ações de dados** para criar ações de dados.
1. Escolha **Create entity (Criar entidade)**. Sua entidade agora está criada e você pode vê-la no painel **Entidades** à esquerda.
1. Configure sua nova entidade seguindo os procedimentos em[Configurando ou editando uma entidade em um aplicativo do App Studio](data-entities-edit.md). Observe que, como sua entidade foi criada com uma fonte de dados existente, algumas propriedades ou recursos já foram criados, como campos, a fonte de dados conectada e o mapeamento de campos. Além disso, sua entidade conterá ações de dados se você marcar a caixa de seleção **Criar ações de dados** durante a criação.
## Criação de uma entidade com uma fonte de dados gerenciada do App Studio
Crie uma entidade gerenciada e uma tabela correspondente do DynamoDB gerenciada pelo App Studio. Embora a tabela do DynamoDB exista na conta AWS associada, quando são feitas alterações na entidade no aplicativo App Studio, a tabela do DynamoDB é atualizada automaticamente. Com essa opção, você não precisa criar, gerenciar ou conectar manualmente uma fonte de dados de terceiros nem designar o mapeamento dos campos da entidade para as colunas da tabela. Essa opção é preferível se você não quiser gerenciar suas próprias fontes de dados e uma tabela do DynamoDB. Sua funcionalidade é suficiente para seu aplicativo. Para obter mais informações sobre entidades gerenciadas, consulte[Entidades de dados gerenciadas no AWS App Studio](managed-data-entities.md).
Você pode usar as mesmas entidades gerenciadas em vários aplicativos. Para instruções, consulte [Criação de uma entidade a partir de uma fonte de dados existente](#data-entities-create-existing-data-source).
1. Se necessário, navegue até seu aplicativo.
1. Escolha a guia **Dados** na parte superior da tela.
1. Se não houver entidades em seu aplicativo, escolha **\$1 Criar entidade**. Caso contrário, no menu **Entidades** do lado esquerdo, escolha **\$1** Adicionar.
1. Selecione **Criar entidade gerenciada do App Studio**.
1. Em **Nome da entidade**, forneça um nome para sua entidade.
1. Em **Chave primária**, forneça um nome para a chave primária da sua entidade. A chave primária é o identificador exclusivo da entidade e não pode ser alterada após a criação da entidade.
1. Em **Tipo de dados de chave primária**, selecione o tipo de dados da chave primária da sua entidade. O tipo de dados não pode ser alterado após a criação da entidade.
1. Escolha **Create entity (Criar entidade)**. Sua entidade agora está criada e você pode vê-la no painel **Entidades** à esquerda.
1. Configure sua nova entidade seguindo os procedimentos em[Configurando ou editando uma entidade em um aplicativo do App Studio](data-entities-edit.md). Observe que, como sua entidade foi criada com dados gerenciados, algumas propriedades ou recursos já foram criados, como o campo da chave primária e a fonte de dados conectada.
## Criando uma entidade vazia
Crie uma entidade vazia inteiramente do zero. Essa opção é preferível se você não tiver nenhuma fonte de dados ou conectores existentes criados por um administrador. Criar uma entidade vazia oferece flexibilidade, pois você pode projetar sua entidade dentro do aplicativo do App Studio sem ser limitado por fontes de dados externas. Depois de criar o modelo de dados do seu aplicativo e configurar a entidade adequadamente, você ainda poderá conectá-la a uma fonte de dados externa posteriormente.
1. Se necessário, navegue até seu aplicativo.
1. Escolha a guia **Dados** na parte superior da tela.
1. Se não houver entidades em seu aplicativo, escolha **\$1 Criar entidade**. Caso contrário, no menu **Entidades** do lado esquerdo, escolha **\$1** Adicionar.
1. Selecione **Criar uma entidade**.
1. Escolha **Create entity (Criar entidade)**. Sua entidade agora está criada e você pode vê-la no painel **Entidades** à esquerda.
1. Configure sua nova entidade seguindo os procedimentos em[Configurando ou editando uma entidade em um aplicativo do App Studio](data-entities-edit.md).
## Criação de uma entidade com IA
Gere uma entidade, campos, ações de dados e dados de amostra com base no nome da entidade especificada. Essa opção é preferível se você tiver uma ideia do modelo de dados do seu aplicativo, mas quiser ajuda para traduzi-lo em uma entidade.
1. Se necessário, navegue até seu aplicativo.
1. Escolha a guia **Dados** na parte superior da tela.
1. Se não houver entidades em seu aplicativo, escolha **\$1 Criar entidade**. Caso contrário, no menu **Entidades** do lado esquerdo, escolha **\$1** Adicionar.
1. Selecione **Criar uma entidade com IA**.
1. Em **Nome da entidade**, forneça um nome para sua entidade. Esse nome é usado para gerar os campos, ações de dados e dados de amostra da sua entidade.
1. Marque a caixa de seleção **Criar ações de dados** para criar ações de dados.
1. Escolha **Gerar uma entidade**. Sua entidade agora está criada e você pode vê-la no painel **Entidades** à esquerda.
1. Configure sua nova entidade seguindo os procedimentos em[Configurando ou editando uma entidade em um aplicativo do App Studio](data-entities-edit.md). Observe que, como sua entidade foi criada com IA, ela já conterá campos gerados. Além disso, sua entidade conterá ações de dados se você marcar a caixa de seleção **Criar ações de dados** durante a criação.
# Configurando ou editando uma entidade em um aplicativo do App Studio
Use os tópicos a seguir para configurar uma entidade em um aplicativo do App Studio.
**Topics**
+ [Editando o nome da entidade](data-entities-edit-name.md)
+ [Adicionar, editar ou excluir campos de entidade](data-entities-edit-fields.md)
+ [Criando, editando ou excluindo ações de dados](data-entities-edit-data-actions.md)
+ [Adicionar ou excluir dados de amostra](data-entities-edit-sample-data.md)
+ [Adicionar ou editar campos conectados da fonte de dados e do mapa](data-entities-edit-connection.md)
# Editando o nome da entidade
1. Se necessário, navegue até a entidade que você deseja editar.
1. Na guia **Configuração**, em **Nome da entidade**, atualize o nome da entidade e escolha fora da caixa de texto para salvar suas alterações.
# Adicionar, editar ou excluir campos de entidade
**dica**
Você pode pressionar CTRL\$1Z para desfazer a alteração mais recente em sua entidade.
1. Se necessário, navegue até a entidade que você deseja editar.
1. Na guia **Configuração**, em **Campos**, você visualiza uma tabela dos campos da sua entidade. Os campos de entidade têm as seguintes colunas:
+ **Nome de exibição:** o nome de exibição é semelhante a um cabeçalho de tabela ou campo de formulário e pode ser visualizado pelos usuários do aplicativo. Ele pode conter espaços e caracteres especiais, mas deve ser exclusivo dentro de uma entidade.
+ **Nome do sistema:** o nome do sistema é um identificador exclusivo usado no código para referenciar um campo. Ao mapear para uma coluna em uma tabela do Amazon Redshift, ela deve corresponder ao nome da coluna da tabela do Amazon Redshift.
+ **Tipo de dados:** o tipo de dados que será armazenado nesse campo, como `Integer``Boolean`, ou`String`.
1. Para adicionar campos:
1. Para usar a IA para gerar campos com base no nome da entidade e na fonte de dados conectada, escolha **Gerar mais campos**.
1. Para adicionar um único campo, escolha **\$1 Adicionar campo**.
1. Para editar um campo:
1. Para editar o nome de exibição, insira o valor desejado na caixa de texto **Nome de exibição**. Se o nome do sistema do campo não tiver sido editado, ele será atualizado para o novo valor do nome de exibição.
1. Para editar o nome do sistema, insira o valor desejado na caixa de texto **Nome do sistema**.
1. Para editar o tipo de dados, escolha o menu suspenso **Tipo de dados** e selecione o tipo desejado na lista.
1. Para editar as propriedades do campo, escolha o ícone de engrenagem do campo. A lista a seguir detalha as propriedades do campo:
+ **Obrigatório**: ative essa opção se o campo for exigido pela sua fonte de dados.
+ **Chave primária**: ative essa opção se o campo estiver mapeado para uma chave primária na sua fonte de dados.
+ **Exclusivo**: ative essa opção se o valor desse campo precisar ser exclusivo.
+ **Usar fonte de dados padrão**: ative essa opção se o valor do campo for fornecido pela fonte de dados, como o uso de incremento automático ou um carimbo de data e hora do evento.
+ **Opções de tipo de dados**: campos de determinados tipos de dados podem ser configurados com opções de tipo de dados, como valores mínimos ou máximos.
1. Para excluir um campo, escolha o ícone da lixeira do campo que você deseja excluir.
# 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\$1Z 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 **\$1 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 **\$1 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.
| | =, \$1=, <, >, <=, >= | 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.
# Adicionar ou excluir dados de amostra
Você pode adicionar dados de amostra às entidades em um aplicativo do App Studio. Como os aplicativos não se comunicam com serviços externos até serem publicados, os dados de amostra podem ser usados para testar seu aplicativo e sua entidade em ambientes de pré-visualização.
1. Se necessário, navegue até a entidade que você deseja editar.
1. Escolha a guia **Dados de amostra**.
1. Para gerar dados de amostra, escolha **Gerar mais dados de amostra**.
1. Para excluir dados de amostra, marque as caixas de seleção dos dados que você deseja excluir e pressione a tecla Delete ou Backspace. Escolha **Salvar** para salvar as alterações.
# Adicionar ou editar campos conectados da fonte de dados e do mapa
**dica**
Você pode pressionar CTRL\$1Z para desfazer a alteração mais recente em sua entidade.
1. Se necessário, navegue até a entidade que você deseja editar.
1. Escolha a guia **Conexão** para visualizar ou gerenciar a conexão entre a entidade e uma tabela de fonte de dados na qual os dados são armazenados quando seu aplicativo é publicado. Depois que uma tabela de fonte de dados estiver conectada, você poderá mapear os campos da entidade para as colunas da tabela.
1. Em **Conector**, escolha o conector que contém uma conexão com a tabela da fonte de dados desejada. Para obter mais informações sobre conectores, consulte[Conecte o App Studio a outros serviços com conectores](connectors.md).
1. Em **Tabela**, escolha a tabela que você deseja usar como fonte de dados para a entidade.
1. A tabela mostra os campos da entidade e a coluna da fonte de dados para a qual eles são mapeados. Escolha **Mapa automático para mapear** automaticamente os campos da entidade com as colunas da fonte de dados. Você também pode mapear campos manualmente na tabela escolhendo a coluna da fonte de dados na lista suspensa para cada campo da entidade.
# Excluindo uma entidade
Use o procedimento a seguir para excluir uma entidade de um aplicativo do App Studio.
**nota**
A exclusão de uma entidade de um aplicativo do App Studio não exclui a tabela da fonte de dados conectada, incluindo a tabela correspondente de entidades gerenciadas do DynamoDB. As tabelas da fonte de dados permanecerão na AWS conta associada e precisarão ser excluídas do serviço correspondente, se desejado.
**Para excluir uma entidade**
1. Se necessário, navegue até seu aplicativo.
1. Escolha a guia **Dados**.
1. **No menu **Entidades** à esquerda, escolha o menu de elipses ao lado da entidade que você deseja excluir e escolha Excluir.**
1. Revise as informações na caixa de diálogo, insira **confirm** e escolha **Excluir** para excluir a entidade.
# Entidades de dados gerenciadas no AWS App Studio
Normalmente, você configura uma entidade no App Studio com uma conexão com uma tabela de banco de dados externa e precisa criar e mapear cada campo de entidade com uma coluna na tabela do banco de dados conectado. Quando você faz uma alteração no modelo de dados, a tabela do banco de dados externo e a entidade devem ser atualizadas e os campos alterados devem ser remapeados. Embora esse método seja flexível e permita o uso de diferentes tipos de fontes de dados, ele exige um planejamento mais antecipado e uma manutenção contínua.
Uma *entidade gerenciada* é um tipo de entidade para a qual o App Studio gerencia todo o processo de armazenamento e configuração de dados para você. Quando você cria uma entidade gerenciada, uma tabela correspondente do DynamoDB é criada na conta associada. AWS Isso garante o gerenciamento seguro e transparente dos dados internos AWS. Com uma entidade gerenciada, você configura o esquema da entidade no App Studio, e a tabela correspondente do DynamoDB também é atualizada automaticamente.
## Usando entidades gerenciadas em vários aplicativos
Depois de criar uma entidade gerenciada em um aplicativo do App Studio, essa entidade pode ser usada em outros aplicativos do App Studio. Isso é útil para configurar o armazenamento de dados para aplicativos com modelos e esquemas de dados idênticos, fornecendo um único recurso subjacente para manutenção.
Ao usar uma entidade gerenciada em vários aplicativos, todas as atualizações de esquema na tabela correspondente do DynamoDB devem ser feitas usando o aplicativo original no qual a entidade gerenciada foi criada. Qualquer alteração de esquema feita na entidade em outros aplicativos não atualizará a tabela correspondente do DynamoDB.
## Limitações da entidade gerenciada
**Restrições de atualização da chave primária**: você não pode alterar o nome ou o tipo da chave primária da entidade após sua criação, pois essa é uma alteração destrutiva no DynamoDB e resultaria na perda dos dados existentes.
**Renomear colunas**: ao renomear uma coluna no DynamoDB, você realmente cria uma nova coluna enquanto a coluna original permanece com os dados originais. Os dados originais não são copiados automaticamente para a nova coluna nem excluídos da coluna original. Você pode renomear os campos da entidade gerenciada, conhecidos como *nome do sistema*, mas perderá o acesso à coluna original e seus dados. Não há restrições em renomear o nome de exibição.
**Alteração do tipo de dados**: embora o DynamoDB permita flexibilidade para modificar os tipos de dados da coluna após a criação da tabela, essas alterações podem afetar gravemente os dados existentes, bem como a lógica e a precisão da consulta. As mudanças no tipo de dados exigem a transformação de todos os dados existentes para que estejam em conformidade com o novo formato, que é complexo para tabelas grandes e ativas. Além disso, as ações de dados podem retornar resultados inesperados até que a migração dos dados seja concluída. Você pode alternar os tipos de dados dos campos, mas os dados existentes não serão migrados para o novo tipo de dados.
**Coluna de classificação**: o DynamoDB permite a recuperação de dados classificados por meio de chaves de classificação. As chaves de classificação devem ser definidas como parte das chaves primárias compostas junto com a chave de partição. As limitações incluem chave de classificação obrigatória, classificação confinada em uma partição e nenhuma classificação global entre partições. É necessária uma modelagem cuidadosa dos dados das chaves de classificação para evitar partições ativas. Não daremos suporte ao marco Sorting for Preview.
**Junções**: não há suporte para junções no DynamoDB. As tabelas são desnormalizadas por design para evitar operações de junção caras. Para modelar one-to-many relacionamentos, a tabela secundária contém um atributo que faz referência à chave primária da tabela principal. As consultas de dados de várias tabelas envolvem a pesquisa de itens da tabela principal para recuperar detalhes. Não daremos suporte a junções nativas para entidades gerenciadas como parte do marco do Preview. Como solução alternativa, apresentaremos uma etapa de automação que pode realizar uma mesclagem de dados de duas entidades. Isso será muito semelhante a uma pesquisa de um nível. Não daremos suporte ao marco Sorting for Preview.
**Env Stage**: permitiremos que a publicação seja testada, mas usaremos o mesmo armazenamento gerenciado em ambos os ambientes