お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

ZCQLコンソール

ZCQLコンソールは、必要なZCQLクエリを実行し、Data Storeに格納されたデータに対してデータ操作を行い、必要なZCQLクエリをCatalystコンソールに直接保存できる直感的なツールです。

機能ハイライト

catalyst_zcql_console_first_view

ZCQLコンソールは以下の機能を提供します:

  • クエリを入力すると、関連性のある意味のあるコード補完候補が提供され、クエリを簡単かつ迅速に作成できます。
  • コンソールで任意のクエリを実行し、完全な出力を直接表示できます。
  • コピーボタンを使用してクエリをコピーし、コードに簡単に適用できます。
  • 必要なZCQLクエリを保存し、必要に応じて再利用できます。
  • ZCQL Explorerを使用して、必要な保存済みクエリを簡単に検索して再利用し、プロジェクトで作成されたすべてのテーブルのカラム情報を表示し、Historyセクションから以前に実行されたクエリを再利用することもできます。
注意:
  • デフォルトでは、1つのCatalystプロジェクトに50個のZCQLクエリのみ保存できます。より多くの要件がある場合は、Catalystサポートチームに連絡してこのしきい値を増やすことができます。

  • HistoryセクションのZCQL Explorerには、最新の100件のZCQLクエリのみが記録されます。ただし、Historyにクエリが保持される期間に制限はありません。

ZCQLコンソールへのアクセス

ZCQLコンソールにアクセスするには:

  1. CloudScaleサービスSTORAGEセクションの下にあるData Storeコンポーネントに移動します。 catalyst_zcql_console_datastore_page
注意: ZCQLコンソールにアクセスするには、Data Storeテーブルを作成する必要があります。
  1. ZCQL Consoleタブをクリックします。 catalyst_zcql_console_view_tab_highlight

このコンソールにクエリを入力し、必要な操作を実行できます。

ZCQL Explorer

ZCQL Explorerは、ZCQLコンソールの展開可能かつ折りたたみ可能な機能です。以下のセクションが含まれています:

  • Schema: Schemaには、テーブルに存在するカラムのリスト、カラムの値が必須かどうか、これらのカラムに格納されるデータのデータ型など、テーブルに関する情報が含まれています。 catalyst_zcql_console_zcql_explorer_schema

  • Saved Queries: このセクションには、Save Queryボタンを使用して保存したすべてのクエリのリストが表示されます。名前で必要なクエリを検索して再利用できます。 catalyst_zcql_console_console_explorer_saved_queries

注意: デフォルトでは、1つのCatalystプロジェクトに50個のZCQLクエリのみ保存できます。より多くの要件がある場合は、Catalystサポートチームに連絡してこのしきい値を増やすことができます。
  • History: Historyセクションには、コンソールで実行された最新100件のクエリの完全なリストが表示されます。 catalyst_zcql_console_zcql_explorer_history_section
    Historyセクションからクエリを保存する場合は、必要なクエリの横にある保存アイコンをクリックし、このセクションに記載されている手順に従ってください。
注意: Historyセクションには最新の100件のZCQLクエリのみが保持されます。ただし、Historyにクエリが保存される期間に制限はありません。

ZCQLクエリの実行

ZCQLコンソールでZCQLクエリを実行するには:

  1. コンソールにZCQLクエリを入力します。 catalyst_zcql_console_enterquery

  2. Execute Queryボタンをクリックします。 catalyst_zcql_query_query_executed

コンソールで直接出力を表示できます。

クエリが実行され、ZCQL ExplorerHistoryセクションに記録されます。

デフォルトでは、Table Viewで出力が表示されます。Viewドロップダウンをクリックし、JSON Viewオプションを選択することで、JSONとして出力を表示するオプションもあります。

catalyst_zcql_console_json_output_view

このJSONをコピーして必要に応じて使用するオプションもあります。

ZCQLクエリの保存

ZCQLコンソールでは、必要なクエリを実行して保存できます。クエリを保存すると、各セッションで手動入力する代わりに、必要な時にいつでも簡単に取得して使用できます。

注意: デフォルトでは、1つのCatalystプロジェクトに50個のZCQLクエリのみ保存できます。より多くの要件がある場合は、Catalystサポートチームに連絡してこのしきい値を増やすことができます。

ZCQLクエリを保存するには:

  1. 必要なクエリを入力し、Save Queryボタンをクリックします。 catalyst_zcql_console_enter_query_save_hihlit

  2. ポップアップでQuery Previewセクションを確認し、クエリを参照するためのQuery Nameを入力してSaveをクリックします。 catalyst_zcql_console_save_query_pop

クエリが保存されます。

ZCQL ExplorerセクションのSaved Queriesタブからクエリを表示および管理できます。

catalyst_zcql_console_query_saved_show

Consoleボタンをクリックして、クエリをコンソールに出力できます。

catalyst_zcql_console_console_button_click_hihlit

このクエリをさらに編集して必要に応じて実行したり、上記の手順を繰り返して別のクエリ名で保存したりすることもできます。

保存済みクエリの削除

保存済みクエリを削除するには:

  1. ZCQL ExplorerSaved Queriesセクションで、必要なクエリの横にある削除アイコンをクリックします。 catalyst_zcql_console_query_del_icon

  2. 確認ポップアップでYes, Proceedをクリックして、必要なクエリを削除します。 catalyst_zcql_console_delete_prompt

クエリが削除されます。

ファンクションコードでのZCQL V2の使用

ファンクションでZCQL V2コードを使用するには、以下の方法で環境変数を設定する必要があります:

  1. Serverless > Functionsに移動します。 catalyst_zcql_v2_func_list
  2. ZCQL V2コードを含むファンクションをクリックします。
  3. Configurationタブをクリックし、Environmental Variablesの下にあるCreate Variableをクリックします。 zcql_v2_create_env_variable
  4. それぞれのフィールドに以下の値を入力します:
    Key: ZOHO_CATALYST_ZCQL_PARSER
    Development Value: V2 catalyst_zcql_parser_env_setting
  5. Saveをクリックします。 catalyst_zcql_env_variable_set

ファンクションコードでZCQL V2を使用できるようになります。

注意:
  • コード内で環境変数を参照する必要はありません。コンソールで設定すれば、ファンクションコードでZCQL V2を使用できます。

  • 2024年12月1日より、すべてのOrg開発環境にある現在のすべてのプロジェクトは、自動的にZCQL V2 Parserにマッピングされます。

  • 2025年4月1日より、開発環境ZCQL V2 ParserにすでにマッピングされているすべてのOrgのすべてのプロジェクトは、プロジェクトの本番環境が有効化された場合、本番環境で自動的にZCQL V2 Parserにマッピングされます。

最終更新日 2026-02-23 18:09:41 +0530 IST