--- title: "ZCQLコンソール" url: https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/zcql-console/ description: "ZCQLは、使い慣れたクエリ言語をモデルにしたCatalyst独自のクエリ言語であり、アプリのデータベースを効率的にクエリするために使用できます。" last_updated: 2026-08-17T12:16:04Z service: Cloud Scale type: general --- # ZCQLコンソール **ZCQLコンソール**は、必要なZCQLクエリを実行し、[Data Store](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/introduction/)に格納されたデータに対してデータ操作を行い、必要なZCQLクエリをCatalystコンソールに直接保存できる直感的なツールです。 ### 機能ハイライト ![catalyst_zcql_console_first_view](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_first_view.webp) *ZCQLコンソール*は以下の機能を提供します： * クエリを入力すると、関連性のある意味のあるコード補完候補が提供され、クエリを簡単かつ迅速に作成できます。 * コンソールで任意のクエリを実行し、完全な出力を直接表示できます。 * *コピーボタン*を使用してクエリをコピーし、コードに簡単に適用できます。 * 必要なZCQLクエリを保存し、必要に応じて再利用できます。 * **ZCQL Explorer**を使用して、必要な保存済みクエリを簡単に検索して再利用し、プロジェクトで作成されたすべてのテーブルのカラム情報を表示し、*History*セクションから以前に実行されたクエリを再利用することもできます。 > **注意:** * デフォルトでは、1つのCatalystプロジェクトに**50個のZCQLクエリ**のみ保存できます。より多くの要件がある場合は、[Catalystサポートチーム](mailto:support@zohocatalyst.com)に連絡してこのしきい値を増やすことができます。 * *History*セクションの**ZCQL Explorer**には、最新の**100件のZCQLクエリ**のみが記録されます。ただし、*History*にクエリが保持される期間に制限はありません。 ### ZCQLコンソールへのアクセス ZCQLコンソールにアクセスするには： 1. [CloudScaleサービス](https://docs.catalyst.zoho.com/ja/cloud-scale/)の*STORAGE*セクションの下にある**Data Store**コンポーネントに移動します。 ![catalyst_zcql_console_datastore_page](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_datastore_page.webp) > **注意:** **ZCQLコンソール**にアクセスするには、**Data Store**に[テーブルを作成](https://docs.catalyst.zoho.com/ja/cloud-scale/help/data-store/tables/#create-a-new-table)する必要があります。 2. **ZCQL Console**タブをクリックします。 ![catalyst_zcql_console_view_tab_highlight](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_view_tab_highlight.webp) このコンソールにクエリを入力し、必要な操作を実行できます。 ### ZCQL Explorer *ZCQL Explorer*は、ZCQLコンソールの展開可能かつ折りたたみ可能な機能です。以下のセクションが含まれています： * **Schema**: Schemaには、テーブルに存在するカラムのリスト、カラムの値が必須かどうか、これらのカラムに格納されるデータのデータ型など、テーブルに関する情報が含まれています。 ![catalyst_zcql_console_zcql_explorer_schema](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_zcql_explorer_schema.webp) * **Saved Queries**: このセクションには、**Save Query**ボタンを使用して保存したすべてのクエリのリストが表示されます。名前で必要なクエリを検索して再利用できます。 ![catalyst_zcql_console_console_explorer_saved_queries](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_console_explorer_saved_queries.webp) > **注意:** デフォルトでは、1つのCatalystプロジェクトに**50個のZCQLクエリ**のみ保存できます。より多くの要件がある場合は、[Catalystサポートチーム](mailto:support@zohocatalyst.com)に連絡してこのしきい値を増やすことができます。 * **History**: *History*セクションには、コンソールで実行された**最新100件のクエリ**の完全なリストが表示されます。 ![catalyst_zcql_console_zcql_explorer_history_section](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_zcql_explorer_history_section.webp) *History*セクションからクエリを保存する場合は、必要なクエリの横にある**保存アイコン**をクリックし、この[セクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/zcql/zcql-console/#SaveaZCQLQuery)に記載されている手順に従ってください。 > **注意**: *History*セクションには最新の**100件のZCQLクエリ**のみが保持されます。ただし、*History*にクエリが保存される期間に制限はありません。 ### ZCQLクエリの実行 ZCQLコンソールでZCQLクエリを実行するには： 1. コンソールにZCQLクエリを入力します。 ![catalyst_zcql_console_enterquery](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_enterquery.webp) 2. **Execute Query**ボタンをクリックします。 ![catalyst_zcql_query_query_executed](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_query_query_executed.webp) コンソールで直接出力を表示できます。 クエリが実行され、**ZCQL Explorer**の*History*セクションに記録されます。 デフォルトでは、*Table View*で出力が表示されます。**View**ドロップダウンをクリックし、**JSON View**オプションを選択することで、JSONとして出力を表示するオプションもあります。 ![catalyst_zcql_console_json_output_view](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_json_output_view.webp) このJSONをコピーして必要に応じて使用するオプションもあります。 ### ZCQLクエリの保存 ZCQLコンソールでは、必要なクエリを実行して保存できます。クエリを保存すると、各セッションで手動入力する代わりに、必要な時にいつでも簡単に取得して使用できます。 > **注意:** デフォルトでは、1つのCatalystプロジェクトに**50個のZCQLクエリ**のみ保存できます。より多くの要件がある場合は、[Catalystサポートチーム](mailto:support@zohocatalyst.com)に連絡してこのしきい値を増やすことができます。 ZCQLクエリを保存するには： 1. 必要なクエリを入力し、**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. ポップアップで*Query Preview*セクションを確認し、クエリを参照するための**Query Name**を入力して**Save**をクリックします。 ![catalyst_zcql_console_save_query_pop](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_save_query_pop.webp) クエリが保存されます。 *ZCQL Explorer*セクションの**Saved Queries**タブからクエリを表示および管理できます。 ![catalyst_zcql_console_query_saved_show](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_query_saved_show.webp) *Console*ボタンをクリックして、クエリをコンソールに出力できます。 ![catalyst_zcql_console_console_button_click_hihlit](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_console_button_click_hihlit.webp) このクエリをさらに編集して必要に応じて実行したり、上記の手順を繰り返して別のクエリ名で保存したりすることもできます。 ### 保存済みクエリの削除 保存済みクエリを削除するには： 1. *ZCQL Explorer*の**Saved Queries**セクションで、必要なクエリの横にある**削除アイコン**をクリックします。 ![catalyst_zcql_console_query_del_icon](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_query_del_icon.webp) 2. 確認ポップアップで**Yes, Proceed**をクリックして、必要なクエリを削除します。 ![catalyst_zcql_console_delete_prompt](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_console_delete_prompt.webp) クエリが削除されます。 ### ファンクションコードでのZCQL V2の使用 ファンクションで**ZCQL V2**コードを使用するには、以下の方法で環境変数を設定する必要があります： 1. *Serverless* > **Functions**に移動します。 ![catalyst_zcql_v2_func_list](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_v2_func_list.webp) 2. ZCQL V2コードを含むファンクションをクリックします。 3. **Configuration**タブをクリックし、*Environmental Variables*の下にある**Create Variable**をクリックします。 ![zcql_v2_create_env_variable](https://catalyst-docs-development.zohostratus.in/images/help/zcql/zcql_v2_create_env_variable.webp) 4. それぞれのフィールドに以下の値を入力します： **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. **Save**をクリックします。 ![catalyst_zcql_env_variable_set](https://catalyst-docs-development.zohostratus.in/images/help/zcql/catalyst_zcql_env_variable_set.webp) ファンクションコードでZCQL V2を使用できるようになります。 > **注意:** * コード内で環境変数を参照する必要はありません。コンソールで設定すれば、ファンクションコードで**ZCQL V2**を使用できます。 * **2024年12月1日**より、すべての[Org](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-organizations/)の[開発環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)にある現在のすべてのプロジェクトは、自動的に**ZCQL V2 Parser**にマッピングされます。 * **2025年4月1日**より、*開発環境*で**ZCQL V2 Parser**にすでにマッピングされているすべての*Org*のすべてのプロジェクトは、プロジェクトの本番環境が有効化された場合、[本番環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/production-environment/)で自動的に**ZCQL V2 Parser**にマッピングされます。