Trang này được dịch bởi Cloud Translation API.

Tạo và đăng ký giản đồ

Giản đồ Google Cloud Search là một cấu trúc JSON xác định các đối tượng, thuộc tính và tuỳ chọn dùng để lập chỉ mục và truy vấn dữ liệu của bạn. Trình kết nối nội dung sẽ đọc dữ liệu trong kho lưu trữ và dựa trên giản đồ bạn đã đăng ký, cấu trúc và lập chỉ mục dữ liệu đó.

Bạn có thể tạo giản đồ bằng cách cung cấp đối tượng giản đồ JSON cho API rồi đăng ký đối tượng đó. Bạn phải đăng ký một đối tượng giản đồ cho mỗi kho lưu trữ thì mới có thể lập chỉ mục dữ liệu.

Tài liệu này trình bày các thông tin cơ bản về việc tạo giản đồ. Để biết thông tin về cách tinh chỉnh giản đồ nhằm cải thiện trải nghiệm tìm kiếm, hãy tham khảo bài viết Cải thiện chất lượng tìm kiếm.

Tạo giản đồ

Dưới đây là danh sách các bước dùng để tạo giản đồ Tìm kiếm trên đám mây:

Xác định hành vi dự kiến của người dùng
Khởi chạy nguồn dữ liệu
Tạo giản đồ
Hoàn tất giản đồ mẫu
Đăng ký giản đồ của bạn
Lập chỉ mục dữ liệu
Kiểm tra giản đồ
Điều chỉnh giản đồ

Xác định hành vi dự kiến của người dùng

Việc dự đoán các loại truy vấn mà người dùng thực hiện sẽ giúp bạn định hướng chiến lược tạo giản đồ.

Ví dụ: khi đưa ra truy vấn đối với cơ sở dữ liệu phim, bạn có thể dự đoán người dùng sẽ đưa ra truy vấn như "Hãy cho tôi xem tất cả phim có sự tham gia của Robert Redford". Do đó, giản đồ của bạn phải hỗ trợ các kết quả truy vấn dựa trên "tất cả các phim có một diễn viên cụ thể".

Để xác định giản đồ phản ánh các mẫu hành vi của người dùng, hãy cân nhắc thực hiện các nhiệm vụ sau:

Đánh giá một tập hợp đa dạng các cụm từ tìm kiếm mong muốn của nhiều người dùng.
Xác định các đối tượng có thể được sử dụng trong truy vấn. Đối tượng là các tập hợp dữ liệu liên quan theo logic, chẳng hạn như một bộ phim trong cơ sở dữ liệu phim.
Xác định các thuộc tính và giá trị tạo nên đối tượng và có thể được sử dụng trong truy vấn. Thuộc tính là các thuộc tính có thể lập chỉ mục của đối tượng; các thuộc tính này có thể bao gồm các giá trị gốc hoặc các đối tượng khác. Ví dụ: một đối tượng phim có thể có các thuộc tính như tên phim và ngày phát hành làm giá trị gốc. Đối tượng phim cũng có thể chứa các đối tượng khác, chẳng hạn như diễn viên, có các thuộc tính riêng, chẳng hạn như tên hoặc vai diễn.
Xác định ví dụ về giá trị hợp lệ cho các thuộc tính. Giá trị là dữ liệu thực tế được lập chỉ mục cho một tài sản. Ví dụ: tiêu đề của một bộ phim trong cơ sở dữ liệu của bạn có thể là "Raiders of the Lost Ark".
Xác định các tuỳ chọn sắp xếp và xếp hạng mà người dùng mong muốn. Ví dụ: Khi truy vấn phim, người dùng có thể muốn sắp xếp theo thứ tự thời gian và xếp hạng theo xếp hạng khán giả và không cần sắp xếp theo thứ tự bảng chữ cái của tiêu đề.
(không bắt buộc) Cân nhắc xem một trong các thuộc tính của bạn có thể hiện ngữ cảnh cụ thể hơn mà có thể thực thi hoạt động tìm kiếm hay không, chẳng hạn như bộ phận hoặc vai trò công việc của người dùng, để có thể cung cấp các đề xuất tự động hoàn thành dựa trên ngữ cảnh. Ví dụ: đối với những người tìm kiếm cơ sở dữ liệu phim, người dùng có thể chỉ quan tâm đến một thể loại phim nhất định. Người dùng sẽ xác định thể loại họ muốn tìm kiếm, có thể là một phần trong hồ sơ người dùng. Sau đó, khi người dùng bắt đầu nhập cụm từ tìm kiếm về phim, chỉ những bộ phim thuộc thể loại mà họ ưu tiên, chẳng hạn như "phim hành động", mới được đề xuất trong phần nội dung đề xuất tự động hoàn thành.
Tạo danh sách các đối tượng, thuộc tính và giá trị mẫu này có thể được sử dụng trong các lượt tìm kiếm. (Để biết thông tin chi tiết về cách sử dụng danh sách này, hãy xem phần Xác định các tuỳ chọn toán tử.)

Khởi chạy nguồn dữ liệu

Nguồn dữ liệu đại diện cho dữ liệu từ một kho lưu trữ đã được lập chỉ mục và lưu trữ trong Google Cloud. Để biết hướng dẫn khởi chạy nguồn dữ liệu, hãy tham khảo bài viết Quản lý nguồn dữ liệu của bên thứ ba.

Kết quả tìm kiếm của người dùng được trả về từ nguồn dữ liệu. Khi người dùng nhấp vào một kết quả tìm kiếm, Cloud Search sẽ chuyển hướng người dùng đến mục thực tế bằng cách sử dụng URL được cung cấp trong yêu cầu lập chỉ mục.

Xác định đối tượng

Đơn vị dữ liệu cơ bản trong giản đồ là đối tượng, còn được gọi là "đối tượng giản đồ", là một cấu trúc logic của dữ liệu. Trong cơ sở dữ liệu về phim, một cấu trúc logic của dữ liệu là "phim". Một đối tượng khác có thể là "người" để đại diện cho dàn diễn viên và đoàn làm phim tham gia vào bộ phim.

Mỗi đối tượng trong giản đồ có một loạt các thuộc tính hoặc thuộc tính mô tả đối tượng đó, chẳng hạn như tiêu đề và thời lượng của một bộ phim, hoặc tên và ngày sinh của một người. Thuộc tính của một đối tượng có thể bao gồm giá trị gốc hoặc các đối tượng khác.

Hình 1 cho thấy các đối tượng phim và người cũng như các thuộc tính liên quan.

Vẽ các kết nối giản đồ giữa các thực thể — **Hình 1.** Giản đồ mẫu hiển thị hai đối tượng và một đối tượng phụ.

Giản đồ Cloud Search về cơ bản là một danh sách các câu lệnh định nghĩa đối tượng được xác định trong thẻ objectDefinitions. Đoạn mã giản đồ sau đây cho thấy các câu lệnh objectDefinitions cho đối tượng giản đồ phim và người.

{
  "objectDefinitions": [
    {
      "name": "movie",
      ...
    },
    {
      "name": "person",
      ...
    }
  ]
}

Khi xác định một đối tượng giản đồ, bạn sẽ cung cấp một name cho đối tượng đó. Đối tượng này phải là duy nhất trong số tất cả các đối tượng khác trong giản đồ. Thông thường, bạn sẽ sử dụng giá trị name mô tả đối tượng, chẳng hạn như movie cho đối tượng phim. Dịch vụ giản đồ sử dụng trường name làm giá trị nhận dạng khoá cho các đối tượng có thể lập chỉ mục. Để biết thêm thông tin về trường name, hãy tham khảo phần Định nghĩa đối tượng.

Xác định thuộc tính đối tượng

Như đã chỉ định trong tài liệu tham khảo cho ObjectDefinition, tên đối tượng theo sau là một tập hợp options và danh sách propertyDefinitions. options có thể bao gồm freshnessOptions và displayOptions. freshnessOptions được dùng để điều chỉnh thứ hạng tìm kiếm dựa trên độ mới của một mặt hàng. displayOptions được dùng để xác định xem các nhãn và thuộc tính cụ thể có xuất hiện trong kết quả tìm kiếm cho một đối tượng hay không.

Phần propertyDefinitions là nơi bạn xác định các thuộc tính cho một đối tượng, chẳng hạn như tên phim và ngày phát hành.

Đoạn mã sau đây cho thấy đối tượng movie có hai thuộc tính: movieTitle và releaseDate.

{
  "objectDefinitions": [
    {
      "name": "movie",
      "propertyDefinitions": [
        {
          "name": "movieTitle",
          "isReturnable": true,
          "isWildcardSearchable": true,
          "textPropertyOptions": {
            "retrievalImportance": { "importance": "HIGHEST" },
            "operatorOptions": {
              "operatorName": "title"
            }
          },
          "displayOptions": {
            "displayLabel": "Title"
          }
        },
        {
          "name": "releaseDate",
          "isReturnable": true,
          "isSortable": true,
          "datePropertyOptions": {
            "operatorOptions": {
              "operatorName": "released",
              "lessThanOperatorName": "releasedbefore",
              "greaterThanOperatorName": "releasedafter"
            }
          },
          "displayOptions": {
            "displayLabel": "Release date"
          }
      ...
      ]
    }
  ]
}

PropertyDefinition bao gồm các mục sau:

chuỗi name.
Danh sách các tuỳ chọn không phân biệt loại, chẳng hạn như isReturnable trong đoạn mã trước.
Một loại và các tuỳ chọn dành riêng cho loại đó, chẳng hạn như textPropertyOptions và retrievalImportance trong đoạn mã trước.
operatorOptions mô tả cách thuộc tính được sử dụng làm toán tử tìm kiếm.
Một hoặc nhiều displayOptions, chẳng hạn như displayLabel trong đoạn mã trước.

name của một thuộc tính phải là duy nhất trong đối tượng chứa, nhưng bạn có thể sử dụng cùng một tên trong các đối tượng và đối tượng con khác. Trong Hình 1, tên và ngày phát hành của phim đã được xác định hai lần: một lần trong đối tượng movie và một lần nữa trong đối tượng phụ filmography của đối tượng person. Giản đồ này sử dụng lại trường movieTitle để có thể hỗ trợ hai loại hành vi tìm kiếm:

Hiện kết quả phim khi người dùng tìm tên một bộ phim.
Hiển thị kết quả về người khi người dùng tìm kiếm tiêu đề của một bộ phim mà một diễn viên đã tham gia.

Tương tự, giản đồ sử dụng lại trường releaseDate vì trường này có cùng ý nghĩa với hai trường movieTitle.

Trong quá trình phát triển giản đồ của riêng bạn, hãy cân nhắc cách kho lưu trữ của bạn có thể có các trường liên quan chứa dữ liệu mà bạn muốn khai báo nhiều lần trong giản đồ.

Thêm các tuỳ chọn không phân biệt loại

PropertyDefinition liệt kê các tuỳ chọn chức năng tìm kiếm chung phổ biến cho tất cả các tài sản, bất kể loại dữ liệu.

isReturnable – Cho biết liệu thuộc tính có xác định dữ liệu cần được trả về trong kết quả tìm kiếm thông qua Query API hay không. Tất cả thuộc tính phim mẫu đều có thể trả về. Bạn có thể sử dụng các thuộc tính không thể trả về để tìm kiếm hoặc xếp hạng kết quả mà không cần trả về cho người dùng.
isRepeatable – Cho biết thuộc tính có được phép sử dụng nhiều giá trị hay không. Ví dụ: một bộ phim chỉ có một ngày phát hành nhưng có thể có nhiều diễn viên.
isSortable – Cho biết rằng thuộc tính này có thể được dùng để sắp xếp. Điều này không đúng với các thuộc tính có thể lặp lại. Ví dụ: kết quả phim có thể được sắp xếp theo ngày phát hành hoặc xếp hạng đối tượng.
isFacetable – Cho biết thuộc tính này có thể được dùng để tạo phương diện. Phương diện được dùng để tinh chỉnh kết quả tìm kiếm, trong đó người dùng sẽ thấy kết quả ban đầu, sau đó thêm tiêu chí hoặc phương diện để tinh chỉnh thêm các kết quả đó. Không thể đặt giá trị true cho tuỳ chọn này đối với các thuộc tính có loại là đối tượng và isReturnable phải là true để đặt tuỳ chọn này. Cuối cùng, tuỳ chọn này chỉ được hỗ trợ cho các thuộc tính enum, boolean và văn bản. Ví dụ: trong giản đồ mẫu, chúng ta có thể tạo mặt bảng genre, actorName, userRating và mpaaRating để cho phép sử dụng các mặt bảng này nhằm tinh chỉnh kết quả tìm kiếm theo cách tương tác.
isWildcardSearchable cho biết người dùng có thể tìm kiếm bằng ký tự đại diện cho tài sản này. Tuỳ chọn này chỉ có trên các tài sản văn bản. Cách hoạt động của tính năng tìm kiếm ký tự đại diện trên trường văn bản phụ thuộc vào giá trị được đặt trong trường exactMatchWithOperator. Nếu bạn đặt exactMatchWithOperator thành true, giá trị văn bản sẽ được mã hoá thành một giá trị nguyên tử và tìm kiếm ký tự đại diện sẽ được thực hiện dựa trên giá trị đó. Ví dụ: nếu giá trị văn bản là science-fiction, thì truy vấn ký tự đại diện science-* sẽ khớp với giá trị đó. Nếu bạn đặt exactMatchWithOperator thành false, giá trị văn bản sẽ được mã hoá và tìm kiếm ký tự đại diện sẽ được thực hiện đối với từng mã thông báo. Ví dụ: nếu giá trị văn bản là "khoa học viễn tưởng", thì truy vấn ký tự đại diện sci* hoặc fi* sẽ khớp với mục này, nhưng science-* thì không.

Các tham số chức năng tìm kiếm chung này đều là giá trị boolean; tất cả đều có giá trị mặc định là false và phải được đặt thành true để sử dụng.

Bảng sau đây cho thấy các tham số boolean được đặt thành true cho tất cả các thuộc tính của đối tượng movie:

Thuộc tính	`isReturnable`	`isRepeatable`	`isSortable`	`isFacetable`	`isWildcardSearchable`
`movieTitle`	đúng				đúng
`releaseDate`	đúng		đúng
`genre`	đúng	đúng		đúng
`duration`	đúng
`actorName`	đúng	đúng		đúng	đúng
`userRating`	đúng		đúng
`mpaaRating`	đúng			đúng

Cả genre và actorName đều có isRepeatable được đặt thành true vì một bộ phim có thể thuộc nhiều thể loại và thường có nhiều diễn viên. Bạn không thể sắp xếp một thuộc tính nếu thuộc tính đó có thể lặp lại hoặc nằm trong một đối tượng phụ có thể lặp lại.

Xác định loại

Phần tham chiếu PropertyDefinition liệt kê một số xxPropertyOptions trong đó xx là một loại cụ thể, chẳng hạn như boolean. Để đặt loại dữ liệu của thuộc tính, bạn phải xác định đối tượng loại dữ liệu thích hợp. Việc xác định đối tượng loại dữ liệu cho một thuộc tính sẽ thiết lập loại dữ liệu của thuộc tính đó. Ví dụ: việc xác định textPropertyOptions cho thuộc tính movieTitle cho biết rằng tên phim thuộc loại văn bản. Đoạn mã sau đây cho thấy thuộc tính movieTitle với textPropertyOptions đặt kiểu dữ liệu.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    ...
  },
  ...
},

Một thuộc tính chỉ có thể có một loại dữ liệu được liên kết. Ví dụ: trong giản đồ phim của chúng tôi, releaseDate chỉ có thể là một ngày (ví dụ: 2016-01-13) hoặc một chuỗi (ví dụ: January 13, 2016), nhưng không phải cả hai.

Dưới đây là các đối tượng loại dữ liệu dùng để chỉ định loại dữ liệu cho các thuộc tính trong giản đồ phim mẫu:

Thuộc tính	Đối tượng loại dữ liệu
`movieTitle`	`textPropertyOptions`
`releaseDate`	`datePropertyOptions`
`genre`	`enumPropertyOptions`
`duration`	`textPropertyOptions`
`actorName`	`textPropertyOptions`
`userRating`	`integerPropertyOptions`
`mpaaRating`	`textPropertyOptions`

Loại dữ liệu mà bạn chọn cho tài sản phụ thuộc vào các trường hợp sử dụng dự kiến của bạn. Trong tình huống tưởng tượng của giản đồ phim này, người dùng sẽ muốn sắp xếp kết quả theo trình tự thời gian, vì vậy releaseDate là đối tượng ngày tháng. Ví dụ: nếu có trường hợp sử dụng dự kiến là so sánh các bản phát hành tháng 12 trong nhiều năm với các bản phát hành tháng 1, thì định dạng chuỗi có thể hữu ích.

Định cấu hình các tuỳ chọn theo từng loại

Phần tham khảo PropertyDefinition liên kết đến các tuỳ chọn cho từng loại. Hầu hết các tuỳ chọn dành riêng cho loại đều không bắt buộc, ngoại trừ danh sách possibleValues trong enumPropertyOptions. Ngoài ra, tuỳ chọn orderedRanking cho phép bạn xếp hạng các giá trị tương ứng với nhau. Đoạn mã sau đây cho thấy thuộc tính movieTitle với textPropertyOptions thiết lập loại dữ liệu và tuỳ chọn dành riêng cho loại retrievalImportance.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    ...
  },
  ...
}

Dưới đây là các tuỳ chọn bổ sung dành riêng cho từng loại được dùng trong giản đồ mẫu:

Thuộc tính	Loại	Tuỳ chọn dành riêng cho loại
`movieTitle`	`textPropertyOptions`	`retrievalImportance`
`releaseDate`	`datePropertyOptions`
`genre`	`enumPropertyOptions`
`duration`	`textPropertyOptions`
`actorName`	`textPropertyOptions`
`userRating`	`integerPropertyOptions`	`orderedRanking`, `maximumValue`
`mpaaRating`	`textPropertyOptions`

Xác định các tuỳ chọn toán tử

Ngoài các tuỳ chọn dành riêng cho từng loại, mỗi loại còn có một tập hợp các operatorOptions tuỳ chọn. Các tuỳ chọn này mô tả cách sử dụng thuộc tính làm toán tử tìm kiếm. Đoạn mã sau đây cho thấy thuộc tính movieTitle với textPropertyOptions đặt loại dữ liệu và với các tuỳ chọn dành riêng cho loại retrievalImportance và operatorOptions.

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
      "operatorName": "title"
    }
  },
  ...
}

Cảnh báo: Trừ phi bạn hoàn toàn chắc chắn rằng một cơ sở lưu trú nên được xếp hạng cao hơn các cơ sở lưu trú khác trong kết quả tìm kiếm, hãy đặt retrievalImportance thành DEFAULT. Bạn không thể thay đổi lựa chọn này sau khi đặt. Ví dụ: nếu một thuộc tính đại diện cho một tiêu đề, bạn nên đặt tầm quan trọng HIGHEST cho thuộc tính đó. Tuy nhiên, nếu một thuộc tính chứa số chi tiết tham chiếu đến các chi tiết khác nhưng không phải là chính chi tiết đó, hãy cân nhắc đánh dấu thuộc tính đó là có MỨC ĐỘ QUAN TRỌNG THẤP. Nếu bạn không chắc chắn về tầm quan trọng của thuộc tính, hãy sử dụng DEFAULT. Nếu bạn chắc chắn rằng không nên sử dụng văn bản để truy xuất, hãy sử dụng NONE. Để biết thêm thông tin, hãy tham khảo Mức độ quan trọng.

Mỗi operatorOptions đều có một operatorName, chẳng hạn như title cho movieTitle. Tên toán tử là toán tử tìm kiếm của thuộc tính. Toán tử tìm kiếm là tham số thực tế mà bạn muốn người dùng sử dụng khi thu hẹp phạm vi tìm kiếm. Ví dụ: để tìm kiếm phim dựa trên tên phim, người dùng sẽ nhập title:movieName, trong đó movieName là tên của một bộ phim.

Tên toán tử không nhất thiết phải giống với tên thuộc tính. Thay vào đó, bạn nên sử dụng tên toán tử phản ánh những từ phổ biến nhất mà người dùng trong tổ chức của bạn sử dụng. Ví dụ: nếu người dùng thích sử dụng cụm từ "tên" thay vì "tiêu đề" cho tiêu đề phim, thì bạn nên đặt tên toán tử thành "tên".

Bạn có thể sử dụng cùng một tên toán tử cho nhiều thuộc tính, miễn là tất cả thuộc tính đều phân giải đến cùng một loại. Khi sử dụng tên toán tử dùng chung trong một truy vấn, tất cả các thuộc tính sử dụng tên toán tử đó sẽ được truy xuất. Ví dụ: giả sử đối tượng phim có các thuộc tính plotSummary và plotSynopsis và mỗi thuộc tính này có operatorName là plot. Miễn là cả hai thuộc tính này đều là văn bản (textPropertyOptions), một truy vấn sử dụng toán tử tìm kiếm plot sẽ truy xuất cả hai.

Ngoài operatorName, các thuộc tính có thể sắp xếp có thể có trường lessThanOperatorName và greaterThanOperatorName trong operatorOptions. Người dùng có thể sử dụng các tuỳ chọn này để tạo truy vấn dựa trên thông tin so sánh với một giá trị đã gửi.

Cuối cùng, textOperatorOptions có một trường exactMatchWithOperator trong operatorOptions. Nếu bạn đặt exactMatchWithOperator thành true, thì chuỗi truy vấn phải khớp với toàn bộ giá trị thuộc tính chứ không chỉ khớp với văn bản. Giá trị văn bản được coi là một giá trị nguyên tử trong các lượt tìm kiếm bằng toán tử và khớp theo phương diện.

Ví dụ: hãy cân nhắc việc lập chỉ mục các đối tượng Sách hoặc Phim bằng các thuộc tính thể loại. Thể loại có thể bao gồm "Khoa học viễn tưởng", "Khoa học" và "Tiểu thuyết". Khi bạn bỏ qua hoặc đặt exactMatchWithOperator thành false, việc tìm kiếm một thể loại hoặc chọn thuộc tính "Khoa học" hoặc "Hư cấu" cũng sẽ trả về kết quả cho "Khoa học-Fiction" vì văn bản được mã hoá và các mã thông báo "Khoa học" và "Hư cấu" tồn tại trong "Khoa học-Fiction". Khi exactMatchWithOperator là true, văn bản sẽ được coi là một mã thông báo duy nhất, do đó, " Science" và "Fiction" đều không khớp với " Science-Fiction".

(Không bắt buộc) Thêm phần `displayOptions`

Có một phần displayOptions không bắt buộc ở cuối bất kỳ phần propertyDefinition nào. Phần này chứa một chuỗi displayLabel. displayLabel là một nhãn văn bản nên dùng, thân thiện với người dùng cho thuộc tính này. Nếu thuộc tính được định cấu hình để hiển thị bằng cách sử dụng ObjectDisplayOptions, thì nhãn này sẽ hiển thị trước thuộc tính. Nếu thuộc tính được định cấu hình để hiển thị và displayLabel không được xác định, thì chỉ giá trị thuộc tính mới được hiển thị.

Đoạn mã sau đây cho thấy thuộc tính movieTitle có displayLabel được đặt thành "Title".

{
  "name": "movieTitle",
  "isReturnable": true,
  "isWildcardSearchable": true,
  "textPropertyOptions": {
    "retrievalImportance": { "importance": "HIGHEST" },
    "operatorOptions": {
       "operatorName": "title"
    }
},
  "displayOptions": {
    "displayLabel": "Title"
  }
},

Sau đây là các giá trị displayLabel cho tất cả thuộc tính của đối tượng movie trong giản đồ mẫu:

Thuộc tính	`displayLabel`
`movieTitle`	`Title`
`releaseDate`	`Release date`
`genre`	`Genre`
`duration`	`Run length`
`actorName`	`Actor`
`userRating`	`Audience score`
`mpaaRating`	`MPAA rating`

(Không bắt buộc) Thêm phần `suggestionFilteringOperators[]`

Bất kỳ phần propertyDefinition nào cũng có một phần suggestionFilteringOperators[] (không bắt buộc). Sử dụng phần này để xác định một thuộc tính dùng để lọc các đề xuất tự động hoàn thành. Ví dụ: bạn có thể xác định toán tử của genre để lọc các đề xuất dựa trên thể loại phim mà người dùng ưu tiên. Sau đó, khi người dùng nhập cụm từ tìm kiếm, chỉ những bộ phim phù hợp với thể loại mà họ ưu tiên mới xuất hiện trong phần đề xuất tự động hoàn thành.

Đăng ký giản đồ

Để dữ liệu có cấu trúc được trả về từ các truy vấn trên Cloud Search, bạn phải đăng ký schema của mình với dịch vụ schema của Cloud Search. Để đăng ký một giản đồ, bạn phải có mã nguồn dữ liệu mà bạn đã nhận được trong bước Khởi chạy một nguồn dữ liệu.

Sử dụng mã nguồn dữ liệu, đưa ra yêu cầu UpdateSchema để đăng ký giản đồ của bạn.

Như đã nêu chi tiết trên trang tham khảo UpdateSchema, hãy đưa ra yêu cầu HTTP sau đây để đăng ký giản đồ:

PUT https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/schema

Nội dung yêu cầu của bạn phải có các thông tin sau:

{
  "validateOnly": // true or false,
  "schema": {
    // ... Your complete schema object ...
  }
}

Sử dụng tuỳ chọn validateOnly để kiểm tra tính hợp lệ của giản đồ mà không cần đăng ký.

Lập chỉ mục dữ liệu

Sau khi bạn đăng ký giản đồ, hãy điền nguồn dữ liệu bằng các lệnh gọi Index (Chỉ mục). Việc lập chỉ mục thường được thực hiện trong trình kết nối nội dung.

Khi sử dụng giản đồ phim, yêu cầu lập chỉ mục API REST cho một bộ phim sẽ có dạng như sau:

{
  "name": "datasource/<data_source_id>/items/titanic",
  "acl": {
    "readers": [
      {
        "gsuitePrincipal": {
          "gsuiteDomain": true
        }
      }
    ]
  },
  "metadata": {
    "title": "Titanic",
    "sourceRepositoryUrl": "http://www.imdb.com/title/tt2234155/?ref_=nv_sr_1",
    "objectType": "movie"
  },
  "structuredData": {
    "object": {
      "properties": [
        {
          "name": "movieTitle",
          "textValues": {
            "values": [
              "Titanic"
            ]
          }
        },
        {
          "name": "releaseDate",
          "dateValues": {
            "values": [
              {
                "year": 1997,
                "month": 12,
                "day": 19
              }
            ]
          }
        },
        {
          "name": "actorName",
          "textValues": {
            "values": [
              "Leonardo DiCaprio",
              "Kate Winslet",
              "Billy Zane"
            ]
          }
        },
        {
          "name": "genre",
          "enumValues": {
            "values": [
              "Drama",
              "Action"
            ]
          }
        },
        {
          "name": "userRating",
          "integerValues": {
            "values": [
              8
            ]
          }
        },
        {
          "name": "mpaaRating",
          "textValues": {
            "values": [
              "PG-13"
            ]
          }
        },
        {
          "name": "duration",
          "textValues": {
            "values": [
              "3 h 14 min"
            ]
          }
        }
      ]
    }
  },
  "content": {
    "inlineContent": "A seventeen-year-old aristocrat falls in love with a kind but poor artist aboard the luxurious, ill-fated R.M.S. Titanic.",
    "contentFormat": "TEXT"
  },
  "version": "01",
  "itemType": "CONTENT_ITEM"
}

Lưu ý cách giá trị của movie trong trường objectType khớp với tên định nghĩa đối tượng trong giản đồ. Bằng cách so khớp hai giá trị này, Cloud Search sẽ biết đối tượng giản đồ nào cần sử dụng trong quá trình lập chỉ mục.

Ngoài ra, hãy lưu ý cách lập chỉ mục thuộc tính giản đồ releaseDate sử dụng các thuộc tính phụ của year, month và day mà thuộc tính này kế thừa vì thuộc tính này được xác định là loại dữ liệu date thông qua việc sử dụng datePropertyOptions để xác định thuộc tính này. Tuy nhiên, vì year, month và day không được xác định trong giản đồ, nên bạn không thể truy vấn trên một trong các thuộc tính đó (ví dụ: year).

Ngoài ra, hãy lưu ý cách lập chỉ mục thuộc tính lặp lại actorName bằng cách sử dụng danh sách giá trị.

Xác định các vấn đề tiềm ẩn khi lập chỉ mục

Hai vấn đề thường gặp nhất liên quan đến giản đồ và việc lập chỉ mục là:

Yêu cầu lập chỉ mục của bạn chứa một đối tượng giản đồ hoặc tên thuộc tính chưa được đăng ký với dịch vụ giản đồ. Vấn đề này khiến thuộc tính hoặc đối tượng bị bỏ qua.
Yêu cầu lập chỉ mục của bạn có thuộc tính có giá trị loại khác với loại đã đăng ký trong giản đồ. Vấn đề này khiến Cloud Search trả về lỗi tại thời điểm lập chỉ mục.

Kiểm thử giản đồ bằng một số loại truy vấn

Trước khi đăng ký giản đồ cho một kho dữ liệu sản xuất lớn, hãy cân nhắc thử nghiệm với một kho dữ liệu thử nghiệm nhỏ hơn. Việc kiểm thử bằng một kho lưu trữ kiểm thử nhỏ hơn cho phép bạn nhanh chóng điều chỉnh giản đồ và xoá dữ liệu đã lập chỉ mục mà không ảnh hưởng đến chỉ mục lớn hơn hoặc chỉ mục sản xuất hiện có. Đối với kho lưu trữ dữ liệu thử nghiệm, hãy tạo một ACL chỉ cho phép người dùng thử nghiệm để người dùng khác không thấy dữ liệu này trong kết quả Tìm kiếm.

Để tạo giao diện tìm kiếm nhằm xác thực cụm từ tìm kiếm, hãy tham khảo Giao diện tìm kiếm

Phần này chứa một số truy vấn mẫu mà bạn có thể sử dụng để kiểm thử giản đồ phim.

Thử nghiệm bằng truy vấn chung

Truy vấn chung trả về tất cả các mục trong nguồn dữ liệu chứa một chuỗi cụ thể. Khi sử dụng giao diện tìm kiếm, bạn có thể chạy truy vấn chung trên nguồn dữ liệu phim bằng cách nhập từ "titanic" rồi nhấn phím Return. Tất cả các bộ phim có từ "titanic" sẽ được trả về trong kết quả tìm kiếm.

Kiểm thử với toán tử

Việc thêm một toán tử vào truy vấn sẽ giới hạn kết quả ở những mục khớp với giá trị toán tử đó. Ví dụ: bạn có thể muốn sử dụng toán tử actor để tìm tất cả các bộ phim có sự tham gia của một diễn viên cụ thể. Khi sử dụng giao diện tìm kiếm, bạn có thể thực hiện truy vấn toán tử này chỉ bằng cách nhập cặp toán tử=giá trị, chẳng hạn như "diễn viên:Zane" rồi nhấn phím Enter. Tất cả phim có Zane đóng vai trò là diễn viên phải được trả về trong kết quả tìm kiếm.

Điều chỉnh giản đồ của bạn

Sau khi giản đồ và dữ liệu của bạn được sử dụng, hãy tiếp tục theo dõi những gì hoạt động và không hoạt động đối với người dùng. Bạn nên cân nhắc điều chỉnh giản đồ trong các trường hợp sau:

Lập chỉ mục một trường chưa được lập chỉ mục trước đó. Ví dụ: người dùng có thể tìm kiếm phim nhiều lần dựa trên tên đạo diễn, vì vậy, bạn có thể điều chỉnh giản đồ để hỗ trợ tên đạo diễn với tư cách là một toán tử.
Thay đổi tên toán tử tìm kiếm dựa trên ý kiến phản hồi của người dùng. Tên toán tử phải thân thiện với người dùng. Nếu người dùng liên tục "nhớ" tên toán tử không chính xác, bạn nên cân nhắc thay đổi tên đó.

Lập chỉ mục lại sau khi thay đổi giản đồ

Việc thay đổi bất kỳ giá trị nào sau đây trong giản đồ không yêu cầu bạn phải lập chỉ mục lại dữ liệu. Bạn chỉ cần gửi yêu cầu UpdateSchema mới và chỉ mục của bạn sẽ tiếp tục hoạt động:

Tên nhà mạng.
Giá trị tối thiểu và tối đa là số nguyên.
Thứ hạng theo thứ tự số nguyên và enum.
Tùy chọn về độ mới.
Tùy chọn hiển thị.

Đối với những thay đổi sau, dữ liệu đã được lập chỉ mục trước đó sẽ tiếp tục hoạt động theo giản đồ đã đăng ký trước đó. Tuy nhiên, bạn phải lập chỉ mục lại các mục nhập hiện có để xem các thay đổi dựa trên giản đồ đã cập nhật nếu giản đồ đó có các thay đổi sau:

Thêm hoặc xoá một thuộc tính hoặc đối tượng mới
Thay đổi isReturnable, isFacetable hoặc isSortable từ false thành true.

Bạn chỉ nên đặt isFacetable hoặc isSortable thành true chỉ nếu có trường hợp sử dụng và nhu cầu rõ ràng.

Cuối cùng, khi cập nhật giản đồ bằng cách đánh dấu một thuộc tính là isSuggestable, bạn phải lập chỉ mục lại dữ liệu của mình. Điều này khiến việc sử dụng tính năng tự động hoàn thành đối với thuộc tính đó bị chậm trễ.

Các thay đổi về thuộc tính không được phép

Bạn không được phép thực hiện một số thay đổi đối với giản đồ, ngay cả khi lập chỉ mục lại dữ liệu, vì các thay đổi này sẽ làm hỏng chỉ mục hoặc dẫn đến kết quả tìm kiếm kém chất lượng hoặc không nhất quán. Các thay đổi này bao gồm:

Loại dữ liệu thuộc tính.
Tên tài sản.
Chế độ cài đặt exactMatchWithOperator.
Chế độ cài đặt retrievalImportance.

Tuy nhiên, có một cách để khắc phục hạn chế này.

Thực hiện thay đổi phức tạp đối với giản đồ

Để tránh những thay đổi có thể tạo ra kết quả tìm kiếm kém hoặc chỉ mục tìm kiếm bị hỏng, Cloud Search ngăn một số loại thay đổi trong các yêu cầu UpdateSchema sau khi kho lưu trữ được lập chỉ mục. Ví dụ: bạn không thể thay đổi loại dữ liệu hoặc tên của một thuộc tính sau khi đã đặt. Bạn không thể thực hiện những thay đổi này thông qua một yêu cầu UpdateSchema đơn giản, ngay cả khi bạn lập chỉ mục lại dữ liệu.

Trong trường hợp phải thực hiện một thay đổi không được phép đối với giản đồ, bạn thường có thể thực hiện một loạt thay đổi được phép để đạt được hiệu quả tương tự. Nhìn chung, quá trình này bao gồm việc di chuyển các thuộc tính được lập chỉ mục trước tiên từ định nghĩa đối tượng cũ sang định nghĩa đối tượng mới hơn, sau đó gửi yêu cầu lập chỉ mục chỉ sử dụng thuộc tính mới hơn.

Các bước sau đây cho biết cách thay đổi loại dữ liệu hoặc tên của một thuộc tính:

Thêm một thuộc tính mới vào phần định nghĩa đối tượng trong giản đồ. Sử dụng tên khác với tài sản bạn muốn thay đổi.
Đưa ra yêu cầu UpdateSchema với định nghĩa mới. Hãy nhớ gửi toàn bộ giản đồ, bao gồm cả tài sản mới và cũ, trong yêu cầu.
Điền lại chỉ mục từ kho lưu trữ dữ liệu. Để bổ sung chỉ mục, hãy gửi tất cả yêu cầu lập chỉ mục bằng tài sản mới, nhưng không phải tài sản cũ, vì việc này sẽ dẫn đến việc tính trùng lặp các cụm từ tìm kiếm khớp.
1. Trong quá trình lập chỉ mục thay thế, hãy kiểm tra tài sản mới và đặt mặc định về tài sản cũ để tránh hành vi không nhất quán.
2. Sau khi quá trình chèn lấp hoàn tất, hãy chạy truy vấn kiểm tra để xác minh.
Xoá thuộc tính cũ. Hãy gửi một yêu cầu UpdateSchema khác mà không dùng tên thuộc tính cũ và ngừng sử dụng tên thuộc tính cũ trong các yêu cầu lập chỉ mục trong tương lai.
Di chuyển mọi hoạt động sử dụng tài sản cũ sang tài sản mới. Ví dụ: nếu thay đổi tên thuộc tính từ nhà sáng tạo thành tác giả, bạn phải cập nhật mã truy vấn để sử dụng tác giả ở nơi trước đó mã truy vấn tham chiếu đến nhà sáng tạo.

Cloud Search lưu giữ bản ghi của mọi tài sản hoặc đối tượng đã xoá trong 30 ngày để ngăn chặn mọi trường hợp sử dụng lại có thể gây ra kết quả lập chỉ mục không mong muốn. Trong vòng 30 ngày đó, bạn nên di chuyển khỏi mọi hoạt động sử dụng đối tượng hoặc thuộc tính đã xoá, bao gồm cả việc loại bỏ chúng khỏi các yêu cầu lập chỉ mục trong tương lai. Điều này đảm bảo rằng nếu sau này bạn quyết định khôi phục thuộc tính hoặc đối tượng đó, bạn có thể thực hiện việc này theo cách duy trì tính chính xác của chỉ mục.

Biết giới hạn về kích thước

Cloud Search đặt ra giới hạn về kích thước của các đối tượng dữ liệu có cấu trúc và giản đồ. Các giới hạn này là:

Số lượng đối tượng cấp cao nhất tối đa là 10 đối tượng.
Chiều sâu tối đa của hệ phân cấp dữ liệu có cấu trúc là 10 cấp.
Tổng số trường trong một đối tượng bị giới hạn ở mức 1000, bao gồm số lượng trường gốc cộng với tổng số trường trong mỗi đối tượng lồng nhau.

Các bước tiếp theo

Dưới đây là một vài bước tiếp theo bạn có thể thực hiện:

Tạo một giao diện tìm kiếm để kiểm thử giản đồ.
Điều chỉnh giản đồ để cải thiện chất lượng tìm kiếm.
Xây dựng cấu trúc giản đồ để diễn giải truy vấn tối ưu.
Tìm hiểu cách tận dụng giản đồ _dictionaryEntry để xác định từ đồng nghĩa cho các thuật ngữ thường dùng trong công ty của bạn. Để sử dụng giản đồ _dictionaryEntry, hãy tham khảo phần Xác định từ đồng nghĩa.
Tạo trình kết nối.