创建、编辑或删除数据操作

在应用程序中，数据操作用于对实体的数据运行操作，例如获取所有记录或按 ID 获取记录。数据操作可用于查找和返回与指定条件相匹配的数据，以便在表格或详细视图等组件中查看。

创建数据操作

提示

您可以按 Ctrl+Z 撤消最近对实体所做的更改。

如有必要，导航到要为其创建数据操作的实体。
选择 “数据操作” 选项卡。
有两种创建数据操作的方法：
- （推荐）要使用 AI 根据您的实体名称、字段和关联的数据源为您生成数据操作，请选择生成数据操作。将生成以下操作：
  1. getAll: 检索实体中的所有记录。当您需要显示记录列表或同时对多条记录执行操作时，此操作很有用。
  2. getByID: 根据其唯一标识符（ID 或主键）从实体检索单条记录。当您需要显示特定记录或对特定记录执行操作时，此操作很有用。
- 要添加单个数据操作，请选择 + 添加数据操作。
要查看或配置新的数据操作，请参阅下一节编辑或配置数据操作。

编辑或配置数据操作

如有必要，导航到要为其创建数据操作的实体。
选择 “数据操作” 选项卡。
在字段中配置要由查询返回的字段。默认情况下，实体中的所有已配置字段都处于选中状态。

您还可以通过执行以下步骤将联接添加到数据操作中：
1. 选择 + 添加联接打开一个对话框。
2. 在相关实体中，选择要与当前实体连接的实体。
3. 在别名中，可以选择输入相关实体的临时别名。
4. 在联接类型中，选择所需的联接类型。
5. 通过从每个实体中选择字段来定义连接子句。
6. 选择 “添加” 以创建联接。
创建后，联接将显示在 “联接” 部分中，从而在 “要返回的字段” 下拉列表中提供其他字段。您可以添加多个联接，包括跨实体的链式联接。您还可以按联接实体的字段进行筛选和排序。

要删除联接，请选择其旁边的垃圾桶图标。这将从该连接中移除所有字段，并使用这些字段打破所有依赖连接或约束。
在条件中，添加、编辑或删除筛选查询输出的规则。您可以将规则分组，也可以使用AND或OR语句将多个规则链接在一起。有关您可以使用的运算符的更多信息，请参阅数据操作条件运算符和示例。
在排序中，通过选择属性并选择升序或降序来配置查询结果的排序方式。您可以通过选择排序规则旁边的垃圾桶图标来移除分类配置。
在转换结果中，您可以输入自定义 JavaScript 以在显示结果或将其发送到自动化之前修改或格式化结果。
在输出预览中，根据配置的字段、筛选器、排序和查看查询输出的预览表 JavaScript。

数据操作条件运算符和示例

您可以使用条件运算符将配置的表达式值与实体列进行比较，以返回数据库对象的子集。您可以使用的运算符取决于列的数据类型以及该实体连接的数据库的类型，例如亚马逊 Redshift、亚马逊 Aurora 或 Amazon DynamoDB。

以下条件运算符可用于所有数据库服务：

=和!=：适用于所有数据类型（不包括主键列）。
<=、>=<、和>=：仅适用于数字列。
IS NULL和IS NOT NULL：用于匹配具有空值或空值的列。空值在每个数据库中的解释通常有所不同，但是在App Studio中，NULL运算符匹配并返回连接的数据库表中具有空值的记录。

以下条件运算符只能在连接到支持它们的数据库服务的实体中使用：

LIKE和NOT LIKE（Redshift、Aurora）：用于在连接的数据库中执行基于模式的查询。该LIKE运算符为搜索功能提供了灵活性，因为它可以查找并返回符合指定模式的记录。您可以使用与模式中的任何字符或字符序列相匹配的通配符来定义模式。每个数据库管理系统都有一组唯一的通配符，但最常用的两种是%表示任意数量的字符（包括 0）和_表示单个字符。
Contains和 Not Contains (DynamoDB)：用于执行区分大小写的搜索以确定是否在列值中找到给定文本。
Starts With和 Not Starts With (DynamoDB)：用于执行区分大小写的搜索以确定是否在列值的开头找到给定文本。

数据库支持条件运算符

下表显示了每个可以连接到 App Studio 的数据库支持哪些数据操作条件运算符。

	=, !=, <, >, <=, >=	喜欢，不喜欢	包含，不包含	从 “开始”，不是 “从” 开始	为空，不为空
DynamoDB	是	否	是	是	是
Aurora	支持	是	否	否	是
Redshift	支持	是	否	否	是

数据操作条件示例

以以下数据库表为例，其中包含多个带有namecity、和hireDate字段的项目。

name	city	HireDate
亚当	Seattle	2025-03-01
艾德丽安	Boston	2025-03-05
Bob	阿尔伯克基	2025-03-06
Carlos	芝加哥	2025-03-10
卡罗琳	NULL	2025-03-12
丽塔	迈阿密	2025-03-15

现在，考虑在 App Studio 中创建数据操作，为符合指定条件的项目返回name字段。以下列表包含条件示例以及表格为每个条件返回的值。

注意

这些示例的格式为 SQL 示例，它们可能不像在 App Studio 中那样出现，但用于说明运算符的行为。

WHERE name LIKE 'Adam': 退货Adam。
WHERE name LIKE 'A%': 退货Adam和Adrienne.
WHERE name NOT LIKE 'B_B': 返回AdamAdrienne、Carlos、Caroline、和Rita。
WHERE contains(name, 'ita'): 退货Rita。
WHERE begins_with(name, 'Car'): 退货Carlos和Caroline.
WHERE city IS NULL: 退货Caroline。
WHERE hireDate < "2025-03-06": 退货Adam和Adrienne.
WHERE hireDate >= DateTime.now().toISODate()：请注意，它DateTime.now().toISODate()返回当前日期。在当前日期为 2025-03-10 的场景中，表达式返回Carlos、Caroline和。Rita

提示

有关比较表达式中的日期和时间的更多信息，请参阅日期和时间。

删除数据操作

使用以下步骤从 App Studio 实体中删除数据操作。

如有必要，导航到要删除其数据操作的实体。
选择 “数据操作” 选项卡。
对于要删除的每个数据操作，选择 “编辑” 旁边的下拉菜单，然后选择 “删除” 。
在对话框中选择 “确认”。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

添加、编辑或删除实体字段

添加或删除示例数据