IS_NULL (Azure Cosmos DB)IS_NULL (Azure Cosmos DB)

適用対象: SQL API

指定した式の型が null であるかどうかを示すブール値を返します。Returns a Boolean value indicating if the type of the specified expression is null.

構文Syntax

IS_NULL(<expr>)  

引数Arguments

exprexpr
任意の式です。Is any expression.

戻り値の型Return types

ブール式を返します。Returns a Boolean expression.

Examples

次の例では、IS_NULL 関数を使用して、JSON ブール値のオブジェクト、数値、文字列、null 値、オブジェクト、配列、未定義の型をチェックします。The following example checks objects of JSON Boolean, number, string, null, object, array, and undefined types using the IS_NULL function.

SELECT   
    IS_NULL(true) AS isNull1,   
    IS_NULL(1) AS isNull2,  
    IS_NULL("value") AS isNull3,   
    IS_NULL(null) AS isNull4,  
    IS_NULL({prop: "value"}) AS isNull5,   
    IS_NULL([1, 2, 3]) AS isNull6,  
    IS_NULL({prop: "value"}.prop2) AS isNull7  

結果セットは次のようになります。Here is the result set.

[{"isNull1":false,"isNull2":false,"isNull3":false,"isNull4":true,"isNull5":false,"isNull6":false,"isNull7":false}]

解説Remarks

このシステム関数は、範囲インデックスの恩恵を受けます。This system function will benefit from a range index.

次のステップNext steps