> For the complete documentation index, see [llms.txt](https://appsmithcns-organization.gitbook.io/pageplug-wen-dang/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://appsmithcns-organization.gitbook.io/pageplug-wen-dang/lian-jie-dao-shu-ju-yuan/zhi-xing-cha-xun.md).

# 执行查询

> 从第三方服务获取/更新数据的 API、数据库查询和集成在 **Appsmith** 中统称为**查询**

你可以使用Appsmith查询编辑器为每种数据源类型创建查询，以获取和更新数据源的数据。本文假设你已经连接到一个数据库或API\
连接到数据库\
连接到 API

## 设置查询

转到需要运行此查询的页面。

1. 转到**数据源 → +** 。
2. 选择已连接的数据源，然后单击 +New Query。
3. 请注意，查询是使用默认名称创建的。建议您重命名它以提高可读性和访问性。
4. 以对您的数据库类型有效的语法编写您的查询
5. 可以使用 REST

> 查询是自动保存的，因此您永远不会丢失您的工作。只有在您部署后，这些更改才会反映在您发布的应用程序中。

> 只能从它所属的页面访问查询及其结果。要在另一个页面上使用查询，请单击查询名称旁边的上下文菜单并克隆它。

### 命名查询

查询必须有一个唯一的名称作为标识符。它用于访问查询结果。从这个意义上说，名称就像编程语言中的变量。您可以使用查询名称访问查询的各种属性及其数据。

> 请注意，JavaScript 关键词 和 [窗口对象方法和属性](https://www.w3schools.com/jsref/obj_window.asp) 作为查询名称无效。

### 运行查询

单击“运行”按钮或单击`cmd + enter`以执行查询。如果查询执行成功，屏幕右上角会弹出一条成功消息以及查询下方的结果。

所有查询结果都存储在查询对象的数据属性中。此对象是不可变的，无法更改。可以使用 javascript 访问它们

```
{{ Query1.data }}
```

**获取数据行的数据库查询**，返回一个对象数组，其中每个对象是一行，对象中的每个键是一列。

所有**API 查询**都返回端点的确切 API 响应

## 在应用程序中使用查询

成功运行查询后，您可以在应用程序中使用它

* 显示数据
* 捕获数据