Xem thông tin chi tiết về Knowledge Catalog

Bạn có thể tìm và quản lý tài nguyên Cloud Firestore bằng cách sử dụng Knowledge Catalog, một nền tảng để lưu trữ, quản lý và truy cập siêu dữ liệu của bạn. Bạn có thể sử dụng Knowledge Catalog để phân tích siêu dữ liệu Cloud Firestore và hỗ trợ các nhiệm vụ như:

  • Phân tích, bao gồm cả các phần phụ thuộc và mức độ phù hợp cho một trường hợp sử dụng
  • Quản lý thay đổi
  • Sự phát triển của giản đồ

Danh mục kiến thức được bật theo mặc định trên các cơ sở dữ liệu Cloud Firestore mới và hiện có, đồng thời tự động truy xuất siêu dữ liệu sau:

Tài nguyên Loại Trường
Cơ sở dữ liệu Mặt phẳng điều khiển
  • Edition
  • (Các) chế độ
  • Vị trí (bao gồm cả nhiều khu vực)
  • Mã dự án
  • Tên cơ sở dữ liệu
  • Thời gian tạo
Giản đồ cơ sở dữ liệu Mặt phẳng dữ liệu
  • Tên
  • Thu thập
  • Trường – (Các) loại dữ liệu
  • Giản đồ

Trước khi bắt đầu

Bật Knowledge Catalog API (dataplex.googleapis.com).
  • Trước khi có thể bật API, bạn cần có vai trò IAM Quản trị viên sử dụng dịch vụ roles/serviceusage.serviceUsageAdmin, trong đó có quyền serviceusage.services.enable. Tìm hiểu cách cấp vai trò.
  • Để bật một API, hãy xem phần Bật API.

Để sử dụng thông tin chi tiết của Knowledge Catalog với Cloud Firestore, trước tiên, bạn phải có cơ sở dữ liệu Cloud Firestore. Để biết thêm thông tin, hãy xem bài viết Tạo và quản lý cơ sở dữ liệu.

Các vai trò cần thiết để truy cập vào kết quả tìm kiếm

Để tìm và xem siêu dữ liệu Cloud Firestore trong Danh mục kiến thức, các chủ thể chính phải có quyền xem tài nguyên Cloud Firestore, bao gồm cả quyền dataplex.projects.search.

Để cấp các quyền này cho các đối tượng chính (chẳng hạn như người dùng, nhóm hoặc tài khoản dịch vụ), hãy chỉ định cho họ vai trò IAM Người xem Cloud Datastore (roles/datastore.viewer) trên dự án chứa tài nguyên Cloud Firestore.

Thao tác trong Knowledge Catalog Cloud Firestore tài nguyên Cần có vai trò hoặc quyền
Tìm kiếm tài nguyên Cloud Firestore Cơ sở dữ liệu datastore.databases.getMetadata
Giản đồ cơ sở dữ liệu datastore.schemas.get

Để biết thêm thông tin về cách cấp vai trò, hãy xem bài viết Quản lý quyền truy cập. Để biết thêm thông tin về các vai trò của Cloud Firestore IAM, hãy xem bài viết Cloud Firestore vai trò và quyền.

Các vai trò cần thiết để tìm kiếm mục nhập

Để tìm kiếm các mục nhập, bạn cần có ít nhất một trong các vai trò IAM sau đây trong dự án được dùng để tìm kiếm:

Các quyền đối với kết quả tìm kiếm được kiểm tra độc lập với dự án đã chọn. Để biết thêm thông tin, hãy xem bài viết Tìm kiếm tài sản dữ liệu bằng Knowledge Catalog.

Các loại khám phá siêu dữ liệu

Tính năng khám phá siêu dữ liệu của Knowledge Catalog là một quy trình tự động quét các nguồn dữ liệu đã kết nối (như Cloud Firestore) để xác định các tài sản dữ liệu (như tập hợp và cơ sở dữ liệu) và trích xuất siêu dữ liệu kỹ thuật của các tài sản đó (như giản đồ, nội dung mô tả và vị trí) vào danh mục Knowledge Catalog. Quá trình này chạy định kỳ để đảm bảo danh mục luôn đồng bộ hoá với hệ thống nguồn.

Danh mục kiến thức hỗ trợ tìm kiếm theo từ khoá và tìm kiếm ngôn ngữ tự nhiên.

  • Tính năng tìm kiếm từ khoá giúp bạn tìm tài nguyên bằng cách sử dụng các từ khoá, bộ lọc cụ thể và cú pháp xác định. Ví dụ: bạn có thể nhập system=Firestore AND type=Database để xem tất cả cơ sở dữ liệu Cloud Firestore.
  • Tính năng Tìm kiếm bằng ngôn ngữ tự nhiên (Bản dùng thử) sử dụng AI để hiểu các cụm từ tìm kiếm theo ngữ nghĩa. Tính năng này giúp bạn tìm tài nguyên bằng ngôn ngữ hằng ngày, không cần cú pháp phức tạp. Ví dụ: bạn có thể nhập các cụm từ tìm kiếm như List all Firestore databases related to sales.

Để biết thêm thông tin, hãy xem bài viết Cú pháp tìm kiếm cho Danh mục kiến thức.

Ví dụ: Khám phá giản đồ nhóm bộ sưu tập Cloud Firestore

Để hiểu quy trình khám phá siêu dữ liệu, hãy xem xét một cơ sở dữ liệu Cloud Firestore có tên là user-firestore-database. Trong cơ sở dữ liệu này, bạn có một giản đồ nhóm tập hợp tên là user-schema.

Sau khi quá trình khám phá hoàn tất, bạn có thể tìm những tài sản này (user-firestore-database và user-schema) trên trang Danh mục kiến thức của Google Cloud Console hoặc bằng cách sử dụng Knowledge Catalog API. Sau đó, bạn có thể xem thông tin chi tiết về các thành phần và bổ sung thêm siêu dữ liệu về doanh nghiệp hoặc hoạt động.

Làm phong phú siêu dữ liệu bằng các khía cạnh

Loại khía cạnh là tài nguyên có thể sử dụng lại mà bạn có thể dùng làm mẫu cho các khía cạnh. Loại khía cạnh giúp bạn tránh trùng lặp công việc và khía cạnh không hoàn chỉnh. Bạn có thể sử dụng Danh mục kiến thức để tạo các loại khía cạnh mà bạn cần.

Sau khi tạo các loại khía cạnh tuỳ chỉnh, bạn có thể đính kèm các khía cạnh vào tài nguyên Cloud Firestore của mình. Việc đính kèm các khía cạnh vào tài nguyên cho phép bạn làm những việc sau:

  • Thêm siêu dữ liệu doanh nghiệp vào thành phần
  • Tìm kiếm tài sản theo siêu dữ liệu doanh nghiệp và siêu dữ liệu tuỳ chỉnh khác

Để tìm hiểu thêm về cách tạo loại khía cạnh và đính kèm khía cạnh vào Cloud Firestore, hãy xem bài viết Quản lý khía cạnh và làm phong phú siêu dữ liệu.

Tìm kiếm Cloud Firestore thành phần

Sử dụng trang tìm kiếm Danh mục kiến thức trong Google Cloud Console để tìm kiếm các thành phần trong Cloud Firestore.

  1. Chuyển đến trang Tìm kiếm của Knowledge Catalog.

    Chuyển đến Google Tìm kiếm

  2. Trong bảng điều khiển Filters (Bộ lọc), hãy nhấp vào Systems (Hệ thống), rồi chọn Firestore.

  3. Không bắt buộc. Trong Bí danh loại, bạn có thể lọc kết quả tìm kiếm theo một loại thành phần Cloud Firestore cụ thể bằng cách chọn một hoặc nhiều bí danh loại sau đây:

    • Cơ sở dữ liệu
    • Giản đồ cơ sở dữ liệu
    • Khác

Bạn có thể sử dụng trường tìm kiếm trong Danh mục kiến thức để thực hiện các cụm từ tìm kiếm. Ví dụ: bạn có thể nhập system=Firestore AND type=Database để xem tất cả cơ sở dữ liệu Cloud Firestore.

Để biết thêm thông tin, hãy xem bài viết Cú pháp tìm kiếm cho Danh mục kiến thức.

Để xem tất cả thành phần Cloud Firestore, hãy nhập system=Firestore. Bạn có thể nhập các từ khoá cụ thể. Ví dụ: để xem tất cả cơ sở dữ liệu Cloud Firestore, hãy làm như sau:

system=Firestore AND type=Database

Bạn cũng có thể sử dụng dấu ngoặc đơn và các toán tử logic AND và OR cho các biểu thức phức tạp. Để tìm hiểu thêm về các biểu thức mà bạn có thể sử dụng trong trường tìm kiếm, hãy xem bài viết Cú pháp tìm kiếm cho Danh mục kiến thức.

Bạn có thể nhập trực tiếp cụm từ tìm kiếm cho các thành phần Cloud Firestore cụ thể vào trường tìm kiếm. Định dạng của chuỗi truy vấn như sau:

type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

Thay thế nội dung sau:

  • QUERY_STRING: sử dụng danh sách sau để xác định chuỗi truy vấn dựa trên loại tài sản Cloud Firestore mà bạn muốn truy vấn:

    • firestore-database
    • firestore-schema

Ví dụ về một truy vấn có thể có dạng như sau:

type="projects/1234567890/locations/global/entryTypes/firestore-schema"

Tìm kiếm theo loại khía cạnh

Knowledge Catalog bao gồm một vài loại khía cạnh tích hợp sẵn mà bạn có thể sử dụng để thực hiện tìm kiếm.

Để tìm kiếm theo loại khía cạnh, hãy làm theo các bước sau:

  1. Trong bảng điều khiển Khía cạnh, hãy nhấp vào trình đơn Thêm loại khía cạnh khác.
  2. Nhập Firestore, sau đó chọn một hoặc nhiều loại khía cạnh sau đây để giới hạn kết quả tìm kiếm theo loại đó.
    • Cơ sở dữ liệu Cloud Firestore
    • Lược đồ Cloud Firestore
  3. Nhấp vào OK.
  4. Trong bảng kết quả, hãy nhấp vào tên của tài sản để xem siêu dữ liệu của tài sản đó.
  5. Không bắt buộc: Cải thiện hoặc xem các thành phần. Bạn có thể làm theo một trong những cách sau:
    • Để thêm nội dung mô tả dạng văn bản đa dạng thức cho thành phần, trong phần Tổng quan, hãy nhấp vào Thêm .
    • Để đính kèm một khía cạnh vào tài sản, trong mục Khía cạnh, hãy nhấp vào Thêm .
    • Để xem cơ sở dữ liệu thành viên cho một thực thể, hãy nhấp vào thẻ Entry List (Danh sách mục nhập), rồi nhấp vào Show all children entries in search (Hiện tất cả mục nhập con trong kết quả tìm kiếm).
    • Trong phần Thông tin chi tiết về mục nhập, hãy xem toàn bộ thông tin chi tiết về thành phần. Nhấp vào tên mục để xem chi tiết các mục khác.

Tìm kiếm ngôn ngữ tự nhiên trong Cloud Firestore

Tính năng Tìm kiếm bằng ngôn ngữ tự nhiên (Bản dùng thử) sử dụng AI để hiểu các cụm từ tìm kiếm theo ngữ nghĩa. Tính năng này giúp bạn tìm tài nguyên bằng ngôn ngữ hằng ngày, không cần cú pháp phức tạp. Ví dụ: bạn có thể nhập các cụm từ tìm kiếm như List all Firestore collections related to sales.

Để biết thêm thông tin, hãy xem bài viết Cú pháp tìm kiếm cho Danh mục kiến thức.

Tìm kiếm cú pháp trong Cloud Firestore

Tính năng tìm kiếm từ khoá giúp bạn tìm tài nguyên bằng cách sử dụng các từ khoá, bộ lọc cụ thể và cú pháp xác định. Ví dụ: bạn có thể nhập system=Firestore AND type=Database để xem tất cả cơ sở dữ liệu Cloud Firestore.

Để biết thêm thông tin, hãy xem bài viết Cú pháp tìm kiếm cho Danh mục kiến thức.

Ví dụ về quy trình công việc: Xem chi tiết từ cơ sở dữ liệu đến giản đồ

Để xem chi tiết từ cơ sở dữ liệu đến giản đồ, hãy làm theo các bước sau:

  1. Chuyển đến trang Tìm kiếm của Knowledge Catalog.

    Chuyển đến Google Tìm kiếm

  2. Trong Filters panel (Bảng điều khiển bộ lọc), hãy chọn Systems (Hệ thống) rồi chọn Firestore. Ngoài ra, hãy nhập system=Firestore vào trường tìm kiếm.

  3. Chọn một cơ sở dữ liệu.

  4. Trên trang Chi tiết về Firestore, hãy nhấp vào thẻ Danh sách mục nhập, sau đó nhấp vào Hiện tất cả mục nhập con trong kết quả tìm kiếm.

  5. Trên trang Chi tiết cơ sở dữ liệu Firestore, hãy nhấp vào thẻ Danh sách mục nhập, sau đó nhấp vào Hiện tất cả mục nhập con trong kết quả tìm kiếm. Knowledge Catalog (Danh mục kiến thức) cho thấy các nhóm tập hợp trong cơ sở dữ liệu.

  6. Chọn tên nhóm tập hợp, sau đó trên trang Chi tiết nhóm tập hợp, hãy nhấp vào Giản đồ để xem giản đồ.

  7. Không bắt buộc: Để thêm một loại khía cạnh vào cơ sở dữ liệu, hãy nhấp vào nút Thêm khía cạnh.

Giá

Bạn không phải trả phí khi lưu trữ siêu dữ liệu kỹ thuật của Cloud Firestore trong Knowledge Catalog. Mức giá tiêu chuẩn của Danh mục kiến thức áp dụng cho các lệnh gọi API và việc bổ sung siêu dữ liệu doanh nghiệp. Để biết thêm thông tin, hãy xem trang giá của Knowledge Catalog.

Hạn chế

  • Kết quả truy vấn sẽ bị cắt bớt sau khi 10.000 nhóm tập hợp được nhập.
  • Trong quá trình nhập hàng loạt, có thể mất đến 48 giờ thì nội dung cập nhật cho cơ sở dữ liệu của bạn mới được phản ánh trong Danh mục kiến thức.
  • Trong quá trình nhập trực tiếp, có thể mất đến 5 phút thì nội dung cập nhật cho cơ sở dữ liệu của bạn mới được phản ánh trong Danh mục kiến thức.
  • Nhóm bộ sưu tập không được cập nhật trong quá trình nhập trực tiếp.
  • Giản đồ nhóm tập hợp được cập nhật trong quá trình nhập trực tiếp, tuy nhiên, bản cập nhật này chỉ bao gồm 100 trường gốc cấp cao nhất đầu tiên theo thứ tự bảng chữ cái. Thông tin còn lại về giản đồ sẽ được cập nhật trong vòng từ 24 đến 48 giờ sau khi nhập dữ liệu trực tiếp.
  • Quá trình giải nén có thể mất vài phút.

Bước tiếp theo