ZCQL V2の構文と例外

Catalystは、ZCQLクエリをより効果的に記述するための構文のアップグレードと機能強化をいくつか追加しました。これらの新しい構文アップグレードは、追加の機能を提供し、Data Storeでのデータ関連操作をより簡単に実行できるようにします。

ZCQLクエリを実行する際には、以下の例外と構文の注意点に留意する必要があります：

1. AVG () ZCQL関数は以下のデータ型に適用できます：

   • Date
   • DateTime
   • Boolean

2. ZCQL文で値を指定する場合は、値をシングルクォーテーションで囲んで指定してください。
   たとえば、従業員データベースから特定の名前を取得する場合、以下のようにコマンドを記述します：

SELECT Name FROM Employee_DB WHERE name = 'Amelia'

3. カラムがBooleanデータ型の場合：

   • 文字列値は許可されません。
   • Booleanデータ型は以下の値のみをサポートします：
     • FALSE
     • TRUE
     • NULL

4. Encryptedデータ型を使用している場合、そのカラムには以下のZCQL関数を使用できません：

   • AVG()
   • SUM()
   • MAX()
   • MIN()

5. Less Than、Greater Than、Less Than or Equal、Greater Than or Equalなどの比較演算子をEncrypted TextおよびBooleanデータ型で使用する場合、適切な例外が追加されています。これらの例外はEqualおよびNot Equal演算子には適用されません。

6. WHERE句文でサブクエリがサポートされるようになりました。詳細については、このヘルプドキュメントをご参照ください。

7. ORDER BY句でZCQL関数の使用がサポートされるようになりました。

8. ORDER BY句を使用するすべてのカラムで、ASCとDESCの機能を適用できるようになりました。個別のカラムに対してもASCとDESCを適用できます。

サンプルデータベース：
以下のデータベースを考えてみましょう - ZylkerEmployeeCompensation

テーブルをリストするには以下のコマンドを実行します

SELECT Salary, Reimbursement FROM ZylkerEmployeeCompensation ORDER BY Salary ASC, Reimbursement DESC

出力：

9. 以下のケースでは適切な例外がトリガーされます：

   • Integerデータ型で許可される最大/最小値を超えた場合。
   • VarCharデータ型で文字長が設定した値より長い場合。
   • BIGINTデータ型でサポート範囲を超える値の場合。

10. 1つのZCQL文に4つのJOIN句を記述できます。ただし、各JOIN句に対して1つのJOIN条件のみ記述できます。

11. ZCQLでテーブルエイリアス機能がサポートされるようになりました。AS ZCQLコマンドを使用してZCQLでエイリアス機能を呼び出すことができます。このコマンドを使用すると、テーブルを別の名前で参照できます。

サンプルデータベース：
以下のデータベースを考えてみましょう：

テーブル1: ZylkerEmployeeCompensation

テーブル2: ZylkerEmployeeRelation

テーブルをリストするには以下のコマンドを実行します

SELECT Managers.Name, Members.Name FROM ZylkerEmployeeCompensation AS Managers
INNER JOIN ZylkerEmployeeRelation AS asso ON Managers.ROWID = asso.Manager
INNER JOIN ZylkerEmployeeCompensation AS Members ON Members.ROWID = asso.Member

出力：

12. IS/IS NOT演算子を使用してNULL値があるかどうかを確認できます。IS/IS NOT演算子のサポートはNULL値に対してのみ利用可能です。

13. GROUP BYとBinaryof()文を記述する際は、以下のZCQLルールに留意する必要があります：

    • Binaryof()機能はGROUP BY文でのみ使用できます。
    • Binaryof()はVarCharまたはTextデータ型のカラムにのみ使用できます。
    • Binaryof()がGROUP BY文で使用される場合、返される値は大文字と小文字が区別されます。たとえば、Zylker_EMPというテーブルのNameというカラムに’AMELIA’、‘amelia’、‘Burrows’、‘burrows’の値があるとします。以下のコマンドを使用した場合：
      

Select Name from Zylker_EMP group by binaryof(Name)

結果は以下のいずれかになる可能性があります：

• AMELIA
• amelia
• burrows
• Burrows

14. カラム名に数値を含めることができるようになりました。クエリ内でそのようなカラム名をバッククォート（`）記号を使用して指定できます。

たとえば、Numbersというテーブルの01というカラムに対するSELECTクエリは以下のように記述できます：

SELECT `01` FROM Numbers

ZCQL例外一覧

以下は、一般的な例外とこれらの例外をトリガーする可能性のあるクエリ文の例のリストです。リストを確認し、ZCQL構文を厳密に遵守してこれらの例外のトリガーを回避してください。