Cloud Firestore Enterprise edition in Native mode is now available! Learn more.

ใช้การค้นหาข้อความ

ใช้ฟีเจอร์การค้นหาข้อความใน Cloud Firestore เพื่อค้นหาสตริงที่เฉพาะเจาะจง ภายในเอกสาร

ข้อกำหนดของแต่ละรุ่น

การค้นหาข้อความต้องใช้ฐานข้อมูล Firestore Enterprise Edition

ก่อนเริ่มต้น

หากต้องการค้นหาข้อความ คุณต้องสร้างดัชนีข้อความสำหรับฟิลด์ที่ต้องการค้นหาก่อน

เรียกใช้การค้นหาข้อความ

หากต้องการค้นหาข้อความ ให้ใช้นิพจน์ documentMatches ภายในพารามิเตอร์ query ของขั้นตอน search(...)

การดำเนินการจะค้นหาเฉพาะในช่องที่จัดทำดัชนีด้วยดัชนีข้อความ หากมีดัชนีหลายรายการ Cloud Firestore จะเลือกดัชนี รายการใดรายการหนึ่งเพื่อใช้ในการดำเนินการ

Web

const result = await execute(db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('waffles')
  }));test.firestore.js

iOS

let snapshot = try await db.pipeline().collection("restaurants")
  .search(query: DocumentMatches("waffles"))
  .execute()PipelineSnippets.swift

Kotlin

val pipeline = db.pipeline().collection("restaurants")
    .search(SearchStage.withQuery(documentMatches("waffles")))DocSnippets.kt

Java

Pipeline pipeline = db.pipeline().collection("restaurants")
        .search(SearchStage.withQuery(documentMatches("waffles")));DocSnippets.java

Node.js

await db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('waffles')
  })
  .execute();test.firestore.js

Python

from google.cloud.firestore_v1.pipeline_expressions import DocumentMatches

results = (
    client.pipeline()
    .collection("restaurants")
    .search(DocumentMatches("waffles"))
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot results1 =
    firestore.pipeline().collection("restaurants")
        .search(Search.withQuery(documentMatches("waffles")))
        .execute().get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("restaurants").
	Search(firestore.WithSearchQuery(firestore.DocumentMatches("waffles"))).
	Execute(ctx)pipeline_snippets_search.go

ค้นหาคำที่ตรงกันทุกประการ

หากต้องการค้นหาคำที่ตรงกันทุกประการ ให้ใส่คำนั้นไว้ในเครื่องหมายคำพูด (")

Web

const result = await execute(db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('"belgian waffles"')
  }));test.firestore.js

iOS

let snapshot = try await db.pipeline().collection("restaurants")
  .search(query: DocumentMatches("\"belgian waffles\""))
  .execute()PipelineSnippets.swift

Kotlin

val pipeline = db.pipeline().collection("restaurants")
    .search(SearchStage.withQuery(documentMatches("\"belgian waffles\"")))DocSnippets.kt

Java

Pipeline pipeline = db.pipeline().collection("restaurants")
        .search(SearchStage.withQuery(documentMatches("\"belgian waffles\"")));DocSnippets.java

Node.js

await db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('"belgian waffles"')
  })
  .execute();test.firestore.js

Python

from google.cloud.firestore_v1.pipeline_expressions import DocumentMatches

results = (
    client.pipeline()
    .collection("restaurants")
    .search(DocumentMatches('"belgian waffles"'))
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot results2 =
    firestore.pipeline().collection("restaurants")
        .search(Search.withQuery(documentMatches("\"belgian waffles\"")))
        .execute().get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("restaurants").
	Search(firestore.WithSearchQuery(firestore.DocumentMatches("\"belgian waffles\""))).
	Execute(ctx)pipeline_snippets_search.go

ค้นหาชุดคำ

หากต้องการค้นหาคำที่รวมกัน (ตรรกะ AND) ให้คั่นคำด้วย ช่องว่าง

Web

const result = await execute(db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('waffles eggs')
  }));test.firestore.js

iOS

let snapshot = try await db.pipeline().collection("restaurants")
  .search(query: DocumentMatches("waffles eggs"))
  .execute()PipelineSnippets.swift

Kotlin

val pipeline = db.pipeline().collection("restaurants")
    .search(SearchStage.withQuery(documentMatches("waffles eggs")))DocSnippets.kt

Java

Pipeline pipeline = db.pipeline().collection("restaurants")
        .search(SearchStage.withQuery(documentMatches("waffles eggs")));DocSnippets.java

Node.js

await db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('waffles eggs')
  })
  .execute();test.firestore.js

Python

from google.cloud.firestore_v1.pipeline_expressions import DocumentMatches

results = (
    client.pipeline()
    .collection("restaurants")
    .search(DocumentMatches("waffles eggs"))
    .execute()
)firestore_pipelines.py

Java

firestore.collection("restaurants").add(new HashMap<String, Object>() {{
  put("name", "Morning Diner");
  put("description", "Start your day with waffles and eggs.");
}});
Pipeline.Snapshot results3 =
    firestore.pipeline().collection("restaurants")
        .search(Search.withQuery(documentMatches("waffles eggs")))
        .execute().get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("restaurants").
	Search(firestore.WithSearchQuery(firestore.DocumentMatches("waffles eggs"))).
	Execute(ctx)pipeline_snippets_search.go

ยกเว้นคำ

หากต้องการยกเว้นคำ ให้ใส่เครื่องหมายขีดกลาง (-) นำหน้าคำนั้น

Web

const result = await execute(db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('coffee -waffles')
  }));test.firestore.js

iOS

let snapshot = try await db.pipeline().collection("restaurants")
  .search(query: DocumentMatches("coffee -waffles"))
  .execute()PipelineSnippets.swift

Kotlin

val pipeline = db.pipeline().collection("restaurants")
    .search(SearchStage.withQuery(documentMatches("waffles eggs")))DocSnippets.kt

Java

Pipeline pipeline = db.pipeline().collection("restaurants")
        .search(SearchStage.withQuery(documentMatches("coffee -waffles")));DocSnippets.java

Node.js

await db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('-waffles')
  })
  .execute();test.firestore.js

Python

from google.cloud.firestore_v1.pipeline_expressions import DocumentMatches

results = (
    client.pipeline()
    .collection("restaurants")
    .search(DocumentMatches("-waffles"))
    .execute()
)firestore_pipelines.py

Java

firestore.collection("restaurants").add(new HashMap<String, Object>() {{
  put("name", "City Coffee");
  put("description", "Premium coffee and pastries.");
}});
Pipeline.Snapshot results4 =
    firestore.pipeline().collection("restaurants")
        .search(Search.withQuery(documentMatches("-waffles")))
        .execute().get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("restaurants").
	Search(firestore.WithSearchQuery(firestore.DocumentMatches("-waffles"))).
	Execute(ctx)pipeline_snippets_search.go

คุณยังยกเว้นวลีได้ด้วย เช่น pizza -"New York"

จัดเรียงผลลัพธ์

โดยค่าเริ่มต้น Cloud Firestore จะจัดเรียงผลลัพธ์ตามเวลาที่สร้างเอกสาร จากใหม่สุดไปเก่าสุด คุณสามารถจัดเรียงตามคะแนนการค้นหาแทนได้ แต่ต้องใช้การคำนวณเพิ่มเติมเพื่อคำนวณและเปรียบเทียบคะแนนที่แน่นอนของแต่ละเอกสาร

วิธีจัดเรียงผลลัพธ์ตามคะแนนการค้นหา

Web

const result = await execute(db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('waffles'),
    sort: score().descending()
  }));

iOS

let snapshot = try await db.pipeline().collection("restaurants")
  .search(
      query: DocumentMatches("waffles"),
      sort: [Score().descending()]
      )
  .execute()

Kotlin

val pipeline = db.pipeline().collection("restaurants")
    .search(SearchStage
              .withQuery(documentMatches("waffles"))
              .withSort(score().descending())
              )

Node.js

await db.pipeline().collection('restaurants')
  .search({
    query: documentMatches('waffles'),
    sort: score().descending()
  })
  .execute();

เพิ่มฟิลด์ลงในเอกสารที่ขั้นตอนการค้นหาแสดง

คุณใช้ addFields เพื่อเพิ่มฟิลด์ลงในเอกสารที่ขั้นตอนการค้นหาแสดงผลได้ นิพจน์ที่แสดงค่าซึ่งคำนวณโดยขั้นตอนการค้นหา เช่น score() สามารถใช้ภายใน addFields ในขั้นตอนการค้นหาเพื่อเขียน ค่าเหล่านั้นลงในเอกสารเอาต์พุต

ตัวอย่างต่อไปนี้จะเพิ่มฟิลด์คะแนนลงในเอกสารที่ส่งคืนโดย ขั้นตอนการค้นหา

Web

const result = await execute(db.pipeline().collection('restaurants')
  .search({
    query: 'menu:waffles',
    addFields: [
        score().as('score'),
    ]
  }));test.firestore.js

iOS

let snapshot = try await db.pipeline().collection("restaurants")
  .search(
    query: DocumentMatches("waffles"),
    addFields: [
      Score().as("score")
    ]
  )
  .execute()PipelineSnippets.swift

Kotlin

val pipeline = db.pipeline().collection("restaurants")
    .search(SearchStage.withQuery(documentMatches("waffles eggs")))DocSnippets.kt

Java

Pipeline pipeline = db.pipeline().collection("restaurants")
        .search(
                SearchStage.withQuery(documentMatches("menu:waffles"))
                        .withAddFields(score().alias("score")));DocSnippets.java

Node.js

await db.pipeline().collection('restaurants')
  .search({
    query: field('menu').matches('waffles'),
    addFields: [
        score().as('score'),
    ]
  }).execute();test.firestore.js

Python

from google.cloud.firestore_v1.pipeline_expressions import DocumentMatches, Score
from google.cloud.firestore_v1.pipeline_stages import SearchOptions

results = (
    client.pipeline()
    .collection("restaurants")
    .search(
        SearchOptions(
            query=DocumentMatches("menu:waffles"),
            add_fields=[Score().as_("score")],
        )
    )
    .execute()
)firestore_pipelines.py

Java

Pipeline.Snapshot results5 =
    firestore.pipeline().collection("restaurants")
        .search(Search.withQuery(field("menu").regexMatch("waffles"))
            .withAddFields(score().as("score")))
        .execute().get();PipelineSnippets.java

Go

snapshot := client.Pipeline().
	Collection("restaurants").
	Search(
		firestore.WithSearchQuery(firestore.FieldOf("menu").RegexMatch("waffles")),
		firestore.WithSearchAddFields(firestore.Score().As("score")),
	).
	Execute(ctx)pipeline_snippets_search.go