---
title: "Ejecutar consulta ZCQL"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/zcql/execute-zcql-query/
description: "Esta API te permite ejecutar una consulta ZCQL para obtener, insertar, actualizar o eliminar datos de las tablas en el Data Store."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

# ZCQL

[ZCQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/introduction/) es el lenguaje de consulta propio de Catalyst que te permite realizar operaciones de obtención, inserción, actualización y eliminación de datos en las tablas del [Catalyst Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction/).

Puedes ejecutar una variedad de consultas DML usando ZCQL para obtener o manipular datos, y usar varias cláusulas y sentencias como las cláusulas SQL Join, sentencias Groupby y OrderBy, y funciones SQL integradas.

# Ejecutar una consulta ZCQL

### Descripción

Esta API te permite ejecutar una consulta ZCQL para obtener, insertar, actualizar o eliminar datos de las tablas en el Data Store. Puedes ejecutar esta API pasando una consulta ZCQL en la solicitud JSON, como se muestra en las solicitudes de ejemplo.

> **Nota:** El formato de solicitud de la API es el mismo para todas las operaciones de ejecución de consultas ZCQL.

### Detalles de la solicitud

#### URL de solicitud

`POST` {api-domain}/baas/v1/project/{project_id}/query

- **api-domain** (URL): El dominio específico del DC para acceder a Catalyst API

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**Content-Type:** application/json

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Scope

ZohoCatalyst.zcql.CREATE

> **Nota:** Esta operación también puede ejecutarse con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la [sección de Prerrequisitos de la API de Catalyst](https://docs.catalyst.zoho.com/es/api/introduction/overview-and-prerequisites/#prerequisites) para más detalles.

#### Propiedades JSON de la solicitud

- **query** (string, mandatory):  La consulta ZCQL a ejecutar   

### Detalles de la respuesta

Operaciones de obtención de datos: La API devuelve los registros que se obtuvieron como resultado de la ejecución de la consulta como respuesta.

Operaciones de inserción y actualización de datos: La API devuelve los registros que fueron insertados o actualizados a través de la consulta como respuesta.

Operaciones de eliminación de datos: La API devuelve la cantidad de filas eliminadas.

**Sample Request: Data Retrieval**

```bash
curl -X POST \
  https://api.catalyst.zoho.com/baas/v1/project/4000000006007/query \
  -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
  -H "Content-Type: application/json" \
  -d '{
	"query":"SELECT EmpID, EmpName, Department, Address from EmpDetails ORDER BY EmpID ASC LIMIT 1000,5"
       }'

```

**Sample Response: Data Retrieval**

```json

    {
    "status": "success",
    "data": [
        {
            "EmpDetails": {
                "CREATORID": "3376000000002003",
                "MODIFIEDTIME": "2023-06-05 15:09:33:881",
                "CREATEDTIME": "2023-06-05 15:09:33:881",
                "ROWID": "3376000001924975",
                "EmpID": "1001",
                "EmpName": "Allison Powell",
                "Department":"Marketing",
                "Address": "13, Winter Avenue, Philadelphia, PY"
            }
        },
        {
            "EmpDetails": {
                "CREATORID": "3376000000002003",
                "MODIFIEDTIME": "2023-06-05 15:09:33:881",
                "CREATEDTIME": "2023-06-05 15:09:33:881",
                "ROWID": "3376000001927682",
                "EmpID": "1002",
                "EmpName": "James Cortez",
                "Department":"HR",
                "Address": "25, Blossom Street, Austin, TX"
            }
        },
        {
            "EmpDetails": {
                "CREATORID": "3376000000002003",
                "MODIFIEDTIME": "2023-06-02 21:04:11:111",
                "CREATEDTIME": "2023-06-02 15:05:21:001",
                "ROWID": "3376000001224112",
                "EmpID": "1003",
                "EmpName": "Han Chan",
                "Department":"Sales",
                "Address": "112, St.Patrick's Road, Louisville, KY"
            }
        },
        {
            "EmpDetails": {
                "CREATORID": "337600000003111",
                "MODIFIEDTIME": "2023-06-02 21:04:11:111",
                "CREATEDTIME": "2023-06-02 15:05:21:001",
                "ROWID": "3376000001242012",
                "EmpID": "1004",
                "EmpName": "Rubella Miguel",
                "Department":"Accounts",
                "Address": "333, Marine Bay, Salt Lake City, UT"
            }
        },
        {
            "EmpDetails": {
                "CREATORID": "3376000000115254",
                "MODIFIEDTIME": "2023-04-12 21:04:10:521",
                "CREATEDTIME": "2023-06-11 15:05:02:541",
                "ROWID": "3376000001241341",
                "EmpID": "1005",
                "EmpName": "Ronwick Boseman",
                "Department":"Support",
                "Address": "61, Gringott's Avenue, Herfordshire, CO"
            }
        }
    ]
}
```

**Sample Request: Data Insertion**

```bash
curl -X POST \
  https://api.catalyst.zoho.com/baas/v1/project/4000000006007/query \
  -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57 \
  -H "Content-Type: application/json" \
  -d '{
	"query":"INSERT INTO EmpDetails VALUES (1007,'Randy Marsh','Sales','42, Tenth Street, Jacksonville, FL', '14 MAR 2017')"
       }'

```

**Sample Response: Data Insertion**

```json

    {
    "status": "success",
    "data": [
      {
        "EmpDetails": {
          "CREATORID": "3813000000002003",
          "EmpID": "1007",
          "EmpName": "Randy Marsh",
          "Department":"Sales",
          "Address": "42, Tenth Street, Jacksonville, FL",
          "DOJ": "14 MAR 2017",
          "MODIFIEDTIME": "2021-08-04 09:10:14:752",
          "CREATEDTIME": "2021-08-04 09:10:14:752",
          "ROWID": "3813000000214001"
        }
      }
    ]
}
```

**Sample Request: Data Updating**

```bash
curl -X POST \
  https://api.catalyst.zoho.com/baas/v1/project/4000000006007/query \
  -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57 \
  -H "Content-Type: application/json" \
  -d '{
	"query":"UPDATE EmpDetails SET Department='Operations' WHERE EmpID=1007"
       }'

```

**Sample Response: Data Updating**

```json

    {
    "status": "success",
    "data": [
      {
        "EmpDetails": {
          "CREATORID": "3813000000002003",
          "EmpID": "1007",
          "EmpName": "Randy Marsh",
          "Department":"Operations",
          "Address": "42, Tenth Street, Jacksonville, FL",
          "DOJ": "14 MAR 2017",
          "MODIFIEDTIME": "2021-08-04 09:11:54:318",
          "CREATEDTIME": "2021-08-04 09:10:14:752",
          "ROWID": "3813000000214001"
        }
      }
    ]
}
```

**Sample Request: Data Deletion**

```bash
curl -X POST \
  https://api.catalyst.zoho.com/baas/v1/project/4000000006007/query \
  -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57 \
  -H "Content-Type: application/json" \
  -d '{
	"query":"DELETE FROM EmpDetails WHERE EmpID=1007"
       }'

```

**Sample Response: Data Deletion**

```json

    {
    "status": "success",
    "data": [
      {
        "EmpDetails": {
          "DELETED_ROWS_COUNT": 1
        }
      }
    ]
  }
```

### SDK Documentation

[Execute ZCQL Query- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/zcql/execute-zcql-query)</br></br>
[Execute ZCQL Query- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/zcql/execute-zcql-query)</br></br>
[Execute ZCQL Query- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/zcql/execute-zcql-query)</br></br>
[Execute ZCQL Query- Web SDK](https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/zcql/execute-zcql-query)