--- title: "" url: https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/zcql-console/ last_updated: 2026-08-17T12:16:04Z --- ? --- title: "La consola de ZCQL" page_type: "home" service: "Cloud Scale" description: "ZCQL es el lenguaje de consulta propio de Catalyst, inspirado en lenguajes de consulta conocidos, que puedes utilizar para consultar la base de datos de tu aplicación de manera eficiente." tags : [ " " ] type: "general" parent_path : "/es/cloud-scale/help/" weight: 13 name: "ZCQL" --- # La consola de ZCQL La **consola de ZCQL** es una herramienta intuitiva que te permite ejecutar las consultas ZCQL que necesites, realizar operaciones de manipulación de datos almacenados en el [Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction/) y guardar las consultas ZCQL requeridas directamente en la consola de Catalyst. ### Características principales ![catalyst_zcql_console_first_view](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_first_view.webp) La *consola de ZCQL* te ofrece las siguientes funcionalidades: * Cuando escribes una consulta, se te proporciona una sugerencia de autocompletado relevante y significativa que te permite formar tus consultas de manera fácil y rápida. * Ejecuta cualquier consulta en la consola y visualiza directamente la salida completa. * Copia la consulta usando el *botón de copiar* y aplícala a tu código con facilidad. * Guarda cualquiera de tus consultas ZCQL requeridas y reutilízala cuando sea necesario. * Usando el **ZCQL Explorer**, puedes buscar y reutilizar fácilmente la consulta guardada que necesites, ver la información de columnas de todas las tablas creadas en el proyecto y también reutilizar consultas ejecutadas previamente desde la sección *History*. > **Nota:** * De forma predeterminada, solo se pueden guardar **50 consultas ZCQL** en un único proyecto de Catalyst. Si necesitas un límite mayor, puedes contactar al [equipo de soporte de Catalyst](mailto:support@zohocatalyst.com) para aumentar este umbral. * Solo las últimas **100 consultas ZCQL** se registrarán en la sección *History* del **ZCQL Explorer**. Sin embargo, no hay límite de tiempo sobre cuánto tiempo estará disponible la consulta en *History*. ### Acceder a la consola de ZCQL Para acceder a la consola de ZCQL: 1. Navega al componente **Data Store** presente en la sección *STORAGE* del [servicio CloudScale](https://docs.catalyst.zoho.com/es/cloud-scale/). ![catalyst_zcql_console_datastore_page](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_datastore_page.webp) > **Nota:** Necesitas [crear una tabla](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/tables/#create-a-new-table) en el **Data Store** para poder acceder a la **consola de ZCQL**. 2. Haz clic en la pestaña **ZCQL Console**. ![catalyst_zcql_console_view_tab_highlight](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_view_tab_highlight.webp) Puedes escribir tu consulta en esta consola y realizar las operaciones requeridas. ### El ZCQL Explorer El *ZCQL Explorer* es una funcionalidad expandible y contraíble de la consola de ZCQL. Contiene las siguientes secciones: * **Schema**: Schema contiene información sobre la tabla que incluye la lista de columnas presentes en la tabla, si el valor de las columnas es obligatorio y el tipo de dato que se almacenará en estas columnas. ![catalyst_zcql_console_zcql_explorer_schema](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_zcql_explorer_schema.webp) * **Saved Queries**: Esta sección contendrá una lista de todas las consultas que hayas guardado usando el botón **Save Query**. Puedes buscar la consulta que necesites por su nombre y reutilizarla. ![catalyst_zcql_console_console_explorer_saved_queries](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_console_explorer_saved_queries.webp) > **Nota:** De forma predeterminada, solo se pueden guardar **50 consultas ZCQL** en un único proyecto de Catalyst. Si necesitas un límite mayor, puedes contactar al [equipo de soporte de Catalyst](mailto:support@zohocatalyst.com) para aumentar este umbral. * **History**: La sección *History* contendrá la lista completa de las **últimas 100 consultas** que se han ejecutado en la consola. ![catalyst_zcql_console_zcql_explorer_history_section](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_zcql_explorer_history_section.webp) Si deseas guardar una consulta de la sección *History*, haz clic en el **ícono de guardar** junto a la consulta requerida y sigue los pasos indicados en esta [sección](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/zcql-console/#SaveaZCQLQuery). > **Nota**: Solo las últimas **100 consultas ZCQL** estarán presentes en la sección *History*. Sin embargo, no hay límite de tiempo sobre cuánto tiempo se puede almacenar la consulta en *History*. ### Ejecutar una consulta ZCQL Para ejecutar una consulta ZCQL en la consola de ZCQL: 1. Ingresa tu consulta ZCQL en la consola. ![catalyst_zcql_console_enterquery](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_enterquery.webp) 2. Haz clic en el botón **Execute Query**. ![catalyst_zcql_query_query_executed](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_query_query_executed.webp) Podrás visualizar la salida directamente en la consola. La consulta se ejecutará y se registrará en la sección *History* presente en el **ZCQL Explorer**. De forma predeterminada, verás la salida en *Table View*. También tienes la opción de ver la salida como JSON haciendo clic en el menú desplegable **View** y seleccionando la opción **JSON View**. ![catalyst_zcql_console_json_output_view](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_json_output_view.webp) También tienes la opción de copiar este JSON y usarlo según sea necesario. ### Guardar una consulta ZCQL En la consola de ZCQL, puedes ejecutar las consultas que necesites y guardarlas. Guardar tus consultas te permite recuperarlas fácilmente y usarlas cuando sea necesario en lugar de ingresarlas manualmente en cada sesión. > **Nota:** De forma predeterminada, solo se pueden guardar **50 consultas ZCQL** en un único proyecto de Catalyst. Si necesitas un límite mayor, puedes contactar al [equipo de soporte de Catalyst](mailto:support@zohocatalyst.com) para aumentar este umbral. Para guardar una consulta ZCQL: 1. Ingresa la consulta que necesites y haz clic en el botón **Save Query**. ![catalyst_zcql_console_enter_query_save_hihlit](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_enter_query_save_hihlit.webp) 2. En la ventana emergente, revisa la sección *Query Preview*, proporciona un **Query Name** para identificar tu consulta y haz clic en **Save**. ![catalyst_zcql_console_save_query_pop](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_save_query_pop.webp) Tu consulta se guardará. Puedes ver y gestionar tus consultas desde la sección *ZCQL Explorer*, en la pestaña **Saved Queries**. ![catalyst_zcql_console_query_saved_show](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_query_saved_show.webp) Puedes hacer clic en el botón *Console* para imprimir la consulta en tu consola. ![catalyst_zcql_console_console_button_click_hihlit](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_console_button_click_hihlit.webp) También puedes editar esta consulta y ejecutarla según sea necesario, o guardarla con un nombre de consulta diferente repitiendo los pasos mencionados anteriormente. ### Eliminar una consulta guardada Para eliminar una consulta guardada: 1. Haz clic en el **ícono de eliminar** presente junto a la consulta requerida en la sección **Saved Queries** del *ZCQL Explorer*. ![catalyst_zcql_console_query_del_icon](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_query_del_icon.webp) 2. Haz clic en **Yes, Proceed** en la ventana emergente de confirmación para eliminar la consulta requerida. ![catalyst_zcql_console_delete_prompt](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_delete_prompt.webp) La consulta se eliminará. ### Usar ZCQL V2 en código de Functions Para usar código de **ZCQL V2** en tu función, necesitarás configurar una variable de entorno de la siguiente manera: 1. Navega a *Serverless* > **Functions**. ![catalyst_zcql_v2_func_list](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_v2_func_list.webp) 2. Haz clic en la función que contiene tu código de ZCQL V2. 3. Haz clic en la pestaña **Configuration**, luego haz clic en **Create Variable** en *Environmental Variables*. ![zcql_v2_create_env_variable](https://catalyst-docs-development.zohostratus.in/images/help/zcql/zcql_v2_create_env_variable.webp) 4. Ingresa los siguientes valores en los campos correspondientes: **Key**: `ZOHO_CATALYST_ZCQL_PARSER` **Development Value**: `V2` ![catalyst_zcql_parser_env_setting](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_parser_env_setting.webp) 5. Haz clic en **Save**. ![catalyst_zcql_env_variable_set](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_env_variable_set.webp) Ahora podrás usar ZCQL V2 en el código de tu función. > **Nota:** * No necesitas referenciar la variable de entorno en ninguna parte de tu código. Una vez que la hayas configurado en la consola, puedes usar **ZCQL V2** en el código de tu función. * A partir del **1 de diciembre de 2024**, todos tus proyectos actuales en todas tus [organizaciones](https://docs.catalyst.zoho.com/es/getting-started/catalyst-organizations/) presentes en el [entorno de desarrollo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment/) se mapearán automáticamente al **ZCQL V2 Parser**. * A partir del **1 de abril de 2025**, todos los proyectos presentes en todas las *organizaciones* que ya hayan sido mapeados al **ZCQL V2 Parser** en el *entorno de desarrollo* se mapearán automáticamente al **ZCQL V2 Parser** en el [entorno de producción](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/production-environment/), si y cuando se habilite producción para el proyecto.