比較関数のリファレンス

比較関数のリファレンス

プレビュー版 - Firestore in Native mode (with Pipeline Operations) for Enterprise Edition

この機能は、 サービス固有の規約の対象となります。 お客様は この機能 の個人データを Cloud のデータ処理に関する追加条項に記載されているとおりに処理できます。ただし、Google Cloud へのアクセスに関する契約に記載されている義務と制限事項が適用されます。 一般提供前の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

比較関数

名前	説明
EQUAL	等価比較
GREATER_THAN	より大きい比較
GREATER_THAN_OR_EQUAL	以上比較
LESS_THAN	より小さい比較
LESS_THAN_OR_EQUAL	以下比較
NOT_EQUAL	不等比較

EQUAL

構文:

equal(x: ANY, y: ANY) -> BOOLEAN

例:

x	y	equal(x, y)
1L	1L	TRUE
1.0	1L	TRUE
-1.0	1L	FALSE
NaN	NaN	TRUE
NULL	NULL	TRUE
NULL	ABSENT	FALSE

説明:

x と y が等しい場合は TRUE、それ以外の場合は FALSE を返します。

Node.js

const result = await db.pipeline()
  .collection("books")
  .select(field("rating").equal(5).as("hasPerfe
ctRating"))
  .execute();test.firestore.js

ウェブ

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").equal(5).as(&qu
ot;hasPerfectRati
ng"))
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").equal(5).as("hasPerfe
ctRating")])
  .e
xecute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("books")
    .select(field("rating").equal(5).alias("hasPerfec
tRating")
)
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").equal(5).alias("hasPerfect
Rating"))
 
   .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("rating").equal(5).as_("hasPerfectR
ating"))
    .exe
cute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(equal(field("rating"), 5).as("hasPerfectRating"))
    
    .execute()
      
  .get();PipelineSnippets.java

GREATER_THAN

構文:

greater_than(x: ANY, y: ANY) -> BOOLEAN

説明:

x が y よりも大きい場合は TRUE、それ以外の場合は FALSE を返します。

x と y が比較できない場合は、FALSE を返します。

例:

x	y	greater_than(x, y)
1L	0.0	TRUE
1L	1L	FALSE
1L	2L	FALSE
"foo"	0L	FALSE
0L	"foo"	FALSE
NaN	0L	FALSE
0L	NaN	FALSE
NULL	NULL	FALSE

Node.js

const result = await db.pipeline()
  .collection("books")
  .select(field("rating").greaterThan(4).as("hasHi
ghRating"))
  .execute();test.firestore.js

ウェブ

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").greaterThan(4).as(
"hasHighRati
ng"))
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").greaterThan(4).as("hasHi
ghRating")])
  .e
xecute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("books")
    .select(field("rating").greaterThan(4).alias("hasHig
hRating")
)
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").greaterThan(4).alias("hasHigh
Rating"))
 
   .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("rating").greater_than(4).as_("hasHighR
ating"))
    .exe
cute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(greaterThan(field("rating"), 4).as("hasHighRating"))
    
    .execute()
      
  .get();PipelineSnippets.java

GREATER_THAN_OR_EQUAL

構文:

greater_than_or_equal(x: ANY, y: ANY) -> BOOLEAN

説明:

x が y 以上の場合は TRUE、それ以外の場合は FALSE を返します。

x と y が比較できない場合は、FALSE を返します。

例:

x	y	greater_than_or_equal(x, y)
1L	0.0	TRUE
1L	1L	TRUE
1L	2L	FALSE
"foo"	0L	FALSE
0L	"foo"	FALSE
NaN	0L	FALSE
0L	NaN	FALSE
NULL	NULL	TRUE

Node.js

const result = await db.pipeline()
  .collection("books")
  .select(field("published").greaterThanOrEqual(1900).as("publishedIn20t
hCentury"))
  .execute();test.firestore.js

ウェブ

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("published").greaterThanOrEqual(1900).as("pub
lishedIn20thCentu
ry"))
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("books")
  .select([Field("published").greaterThanOrEqual(1900).as("publishedIn20t
hCentury")])
  .e
xecute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("books")
    .select(field("published").greaterThanOrEqual(1900).alias("publishedIn20th
Century")
)
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("published").greaterThanOrEqual(1900).alias("publishedIn20thC
entury"))
 
   .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(
        Field.of("published")
        .greater_than_or_equal(1900)
        .as_("publishedIn20thCentury
")
    )
    .exe
cute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(greaterThanOrEqual(field("published"), 1900).as("publishedIn20thCentury"))
    
    .execute()
      
  .get();PipelineSnippets.java

LESS_THAN

構文:

less_than(x: ANY, y: ANY) -> BOOLEAN

説明:

x が y よりも小さい場合は TRUE、それ以外の場合は FALSE を返します。

x と y が比較できない場合は、FALSE を返します。

例:

x	y	less_than(x, y)
1L	0.0	FALSE
1L	1L	FALSE
1L	2L	TRUE
"foo"	0L	FALSE
0L	"foo"	FALSE
NaN	0L	FALSE
0L	NaN	FALSE
NULL	NULL	FALSE

Node.js

const result = await db.pipeline()
  .collection("books")
  .select(field("published").lessThan(1923).as("isPublicDomain
Probably"))
  .execute();test.firestore.js

ウェブ

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("published").lessThan(1923).as("isP
ublicDomainProbab
ly"))
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("books")
  .select([Field("published").lessThan(1923).as("isPublicDomain
Probably")])
  .e
xecute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("books")
    .select(field("published").lessThan(1923).alias("isPublicDomainP
robably")
)
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("published").lessThan(1923).alias("isPublicDomainPr
obably"))
 
   .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("published").less_than(1923).as_("isPublicDomainPro
bably"))
    .exe
cute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(lessThan(field("published"), 1923).as("isPublicDomainProbably"))
    
    .execute()
      
  .get();PipelineSnippets.java

LESS_THAN_OR_EQUAL

構文:

less_than_or_equal(x: ANY, y: ANY) -> BOOLEAN

説明:

x が y 以下の場合は TRUE、それ以外の場合は FALSE を返します。

x と y が比較できない場合は、FALSE を返します。

例:

x	y	less_than(x, y)
1L	0.0	FALSE
1L	1L	TRUE
1L	2L	TRUE
"foo"	0L	FALSE
0L	"foo"	FALSE
NaN	0L	FALSE
0L	NaN	FALSE
NULL	NULL	TRUE

Node.js

const result = await db.pipeline()
  .collection("books")
  .select(field("rating").lessThanOrEqual(2).as("hasB
adRating"))
  .execute();test.firestore.js

ウェブ

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("rating").lessThanOrEqual(2).as
("hasBadRati
ng"))
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("books")
  .select([Field("rating").lessThanOrEqual(2).as("hasB
adRating")])
  .e
xecute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("books")
    .select(field("rating").lessThanOrEqual(2).alias("hasBa
dRating")
)
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("rating").lessThanOrEqual(2).alias("hasBad
Rating"))
 
   .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("rating").less_than_or_equal(2).as_("hasBadR
ating"))
    .exe
cute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(lessThanOrEqual(field("rating"), 2).as("hasBadRating"))
    
    .execute()
      
  .get();PipelineSnippets.java

NOT_EQUAL

構文:

not_equal(x: ANY, y: ANY) -> BOOLEAN

説明:

x が y と等しくない場合は TRUE、それ以外の場合は FALSE を返します。

例:

x	y	not_equal(x, y)
1L	1L	FALSE
1.0	1L	FALSE
-1.0	1L	TRUE
NaN	0L	TRUE
NaN	NaN	FALSE
NULL	NULL	FALSE
NULL	ABSENT	TRUE

Node.js

const result = await db.pipeline()
  .collection("books")
  .select(field("title").notEqual("1984"
).as("not198
4"))
  .execute();test.firestore.js

ウェブ

const result = await execute(db.pipeline()
  .collection("books")
  .select(field("title").notEqual("
;1984").as(&
quot;not1984"))
);test.firestore.js

Swift

let result = try await db.pipeline()
  .collection("books")
  .select([Field("title").notEqual("1984"
).as("not1984&quo
t;)])
  .execute()PipelineSnippets.swift

Kotlin
Android

val result = db.pipeline()
    .collection("books")
    .select(field("title").notEqual("1984").al
ias("not1
984"))
    .execute()DocSnippets.kt

Java
Android

Task<Pipeline.Snapshot> result = db.pipeline()
    .collection("books")
    .select(field("title").notEqual("1984").ali
as("not1984
"))
    .execute();DocSnippets.java

Python

from google.cloud.firestore_v1.pipeline_expressions import Field

result = (
    client.pipeline()
    .collection("books")
    .select(Field.of("title").not_equal("1984").as
_("not1984")
)
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot result =
    firestore
        .pipeline()
        .collection("books")
        .select(notEqual(field("title"), "1984").as("not1984&qu
ot;))
        .execut
e()
        .get();PipelineSnippets.java

次のステップ

• パイプライン クエリの概要をご覧ください。