Wyświetlanie statystyk Knowledge Catalog

Możesz wyszukiwać zasoby Cloud Firestore i zarządzać nimi za pomocą Knowledge Catalog, czyli platformy do przechowywania metadanych, zarządzania nimi i uzyskiwania do nich dostępu. Możesz używać Knowledge Catalog do analizowania metadanych Cloud Firestore i wykonywania zadań takich jak:

• analizę, w tym zależności i przydatność w danym przypadku użycia;
• Zarządzanie zmianą
• Ewolucja schematu

Usługa Knowledge Catalog jest domyślnie włączona w nowych i istniejących bazach danych Cloud Firestore i automatycznie pobiera te metadane:

Zanim zaczniesz

• Zanim włączysz interfejsy API, musisz mieć rolę uprawnień administratora wykorzystania usług roles/serviceusage.serviceUsageAdmin, która zawiera uprawnienie serviceusage.services.enable. Dowiedz się, jak przypisywać role
• Aby dowiedzieć się, jak włączyć interfejs API, przeczytaj artykuł o włączaniu interfejsów API.

Aby korzystać ze statystyk Knowledge Catalog w Cloud Firestore, musisz najpierw mieć bazę danych Cloud Firestore. Więcej informacji znajdziesz w artykule o tworzeniu baz danych i zarządzaniu nimi.

Role wymagane do uzyskania dostępu do wyników wyszukiwania

Aby wyszukiwać i wyświetlać metadane Cloud Firestore w Knowledge Catalog, podmioty zabezpieczeń muszą mieć uprawnienia do wyświetlania zasobów Cloud Firestore, w tym uprawnienie dataplex.projects.search.

Aby przyznać te uprawnienia podmiotom zabezpieczeń, takim jak użytkownicy, grupy lub konta usługi, przypisz im rolę uprawnień Wyświetlający Cloud Datastore (roles/datastore.viewer) w projekcie zawierającym zasoby Cloud Firestore.

Więcej informacji o przyznawaniu ról znajdziesz w artykule Zarządzanie dostępem. Więcej informacji o rolach uprawnień Cloud Firestore znajdziesz w artykule o rolach i uprawnieniach Cloud Firestore.

Wymagane role do wyszukiwania wpisów

Aby wyszukiwać wpisy, potrzebujesz co najmniej 1 z tych ról uprawnień w projekcie, który jest używany do wyszukiwania:

• Administrator katalogu Dataplex (roles/dataplex.catalogAdmin)
• Edytujący katalog Dataplex (roles/dataplex.catalogEditor)
• Wyświetlający katalog Dataplex (roles/dataplex.catalogViewer)

Uprawnienia do wyników wyszukiwania są sprawdzane niezależnie od wybranego projektu. Więcej informacji znajdziesz w artykule Wyszukiwanie zasobów danych za pomocą usługi Knowledge Catalog.

Rodzaje wykrywania metadanych

Wykrywanie metadanych w Knowledge Catalog to zautomatyzowany proces, który skanuje połączone źródła danych, takie jak Cloud Firestore, aby identyfikować zasoby danych (np. kolekcje i bazy danych) i wyodrębniać ich metadane techniczne, takie jak schematy, opisy i lokalizacje, do katalogu Knowledge Catalog. Ten proces jest uruchamiany okresowo, aby katalog był zsynchronizowany z systemami źródłowymi.

Wyszukiwanie słów kluczowych i wyszukiwanie w języku naturalnym

Knowledge Catalog obsługuje wyszukiwanie słów kluczowych i wyszukiwanie w języku naturalnym.

• Wyszukiwanie słów kluczowych umożliwia znajdowanie zasobów za pomocą określonych słów kluczowych, filtrów i zdefiniowanej składni. Możesz na przykład wpisać system=Firestore AND type=Database, aby wyświetlić wszystkie bazy danych Cloud Firestore.
• Wyszukiwanie w języku naturalnym (wersja testowa) wykorzystuje AI do rozumienia zapytań semantycznych. Umożliwia znajdowanie zasobów za pomocą naturalnego języka, co eliminuje potrzebę stosowania złożonej składni. Możesz na przykład wpisać zapytania takie jak List all Firestore databases related to sales.

Więcej informacji znajdziesz w artykule na temat składni wyszukiwania w usłudze Knowledge Catalog.

Przykład: wykrywanie schematu grupy kolekcji Cloud Firestore

Aby zrozumieć proces wykrywania metadanych, rozważ bazę danych Cloud Firestore o nazwie user-firestore-database. W tej bazie danych masz schemat grupy kolekcji o nazwie user-schema.

Po zakończeniu wykrywania możesz wyszukać te zasoby (user-firestore-database i user-schema) na stronie Knowledge Catalog w konsoli Google Cloud lub za pomocą interfejsu Knowledge Catalog API. Następnie możesz wyświetlić szczegóły zasobów i wzbogacić je o dodatkowe metadane biznesowe lub operacyjne.

Wzbogacanie metadanych za pomocą aspektów

Typy aspektów to zasoby wielokrotnego użytku, których możesz używać jako szablonów aspektów. Typy aspektów pomagają uniknąć powielania pracy i niekompletnych aspektów. Za pomocą Knowledge Catalog możesz tworzyć potrzebne typy aspektów.

Po utworzeniu niestandardowych typów aspektów możesz dołączyć aspekty do zasobów Cloud Firestore. Dołączenie aspektów do zasobów umożliwia:

• Dodawanie metadanych firmy do komponentów
• Wyszukiwanie zasobów według metadanych biznesowych i innych metadanych niestandardowych

Więcej informacji o tworzeniu typów aspektów i dołączaniu aspektów do Cloud Firestore znajdziesz w artykule Zarządzanie aspektami i wzbogacanie metadanych.

Wyszukaj zasoby Cloud Firestore

Użyj strony wyszukiwania Knowledge Catalog w konsoli Google Cloud, aby wyszukać zasoby Cloud Firestore.

1. Otwórz stronę Wyszukiwanie w usłudze Knowledge Catalog.

   Przejdź do wyszukiwarki

2. W panelu Filtry kliknij Systemy, a następnie wybierz Firestore.

3. Opcjonalnie. W sekcji Aliasy typów możesz filtrować wyniki wyszukiwania według określonego typu zasobu Cloud Firestore, wybierając co najmniej 1 z tych aliasów:

   • Baza danych
   • Schemat bazy danych
   • Inne

Używanie zapytań do wyszukiwania słów kluczowych

Możesz użyć pola wyszukiwania w Knowledge Catalog, aby wyszukiwać słowa kluczowe. Możesz na przykład wpisać system=Firestore AND type=Database, aby wyświetlić wszystkie bazy danych Cloud Firestore.

Więcej informacji znajdziesz w artykule na temat składni wyszukiwania w usłudze Knowledge Catalog.

Aby wyświetlić wszystkie zasoby Cloud Firestore, wpisz system=Firestore. Możesz wpisać konkretne słowa kluczowe. Aby na przykład wyświetlić wszystkie bazy danych Cloud Firestore:

system=Firestore AND type=Database

W przypadku wyrażeń złożonych możesz też używać nawiasów i operatorów logicznych AND i OR. Więcej informacji o wyrażeniach, których możesz używać w polu wyszukiwania, znajdziesz w artykule Składnia wyszukiwania w usłudze Knowledge Catalog.

Możesz bezpośrednio wpisywać zapytania dotyczące konkretnych zasobów Cloud Firestore w polu wyszukiwania. Format ciągu zapytania jest następujący:

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

Zastąp następujące elementy:

• QUERY_STRING: użyj poniższej listy, aby określić ciąg zapytania na podstawie typu zasobu Cloud Firestore, którego dotyczy zapytanie:

  • firestore-database
  • firestore-schema

Przykładowe zapytanie może wyglądać tak:

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

Wyszukiwanie według typu aspektu

Knowledge Catalog zawiera kilka wbudowanych typów aspektów, których możesz używać do wyszukiwania.

Aby wyszukać według typu aspektu, wykonaj te czynności:

1. W panelu Aspekty kliknij menu Dodaj więcej typów aspektów.
2. Wpisz Firestore, a następnie wybierz co najmniej 1 z tych typów aspektów, aby ograniczyć wyniki wyszukiwania do tego typu.
   • Cloud Firestore baza danych
   • Cloud Firestore schemat
3. Kliknij OK.
4. W tabeli wyników kliknij nazwę zasobu, aby wyświetlić jego metadane.
5. Opcjonalnie: ulepsz lub wyświetl komponenty. Możesz wykonać dowolną z tych czynności:
   • Aby dodać sformatowany opis zasobu, w sekcji Przegląd kliknij Dodaj .
   • Aby dołączyć aspekt do zasobu, w sekcji Aspekty kliknij Dodaj .
   • Aby wyświetlić bazy danych instancji, kliknij kartę Lista wpisów, a następnie kliknij Pokaż wszystkie wpisy podrzędne w wyszukiwaniu.
   • W sekcji Szczegóły wpisu wyświetl pełne szczegóły zasobu. Kliknij nazwę wpisu, aby przejść do dodatkowych wpisów.

Wyszukiwanie w języku naturalnym w Cloud Firestore

Wyszukiwanie w języku naturalnym (wersja testowa) wykorzystuje AI do rozumienia zapytań semantycznych. Umożliwia znajdowanie zasobów za pomocą naturalnego języka, co eliminuje potrzebę stosowania złożonej składni. Możesz na przykład wpisać zapytania takie jak List all Firestore collections related to sales.

Więcej informacji znajdziesz w artykule na temat składni wyszukiwania w usłudze Knowledge Catalog.

Wyszukiwanie składniowe w: Cloud Firestore

Wyszukiwanie słów kluczowych umożliwia znajdowanie zasobów za pomocą określonych słów kluczowych, filtrów i zdefiniowanej składni. Możesz na przykład wpisać system=Firestore AND type=Database, aby wyświetlić wszystkie bazy danych Cloud Firestore.

Więcej informacji znajdziesz w artykule na temat składni wyszukiwania w usłudze Knowledge Catalog.

Przykładowy proces: przechodzenie od bazy danych do schematu

Aby przejść od bazy danych do schematu, wykonaj te czynności:

1. Otwórz stronę Wyszukiwanie w usłudze Knowledge Catalog.

   Przejdź do wyszukiwarki

2. W panelu Filtry wybierz Systemy, a następnie Firestore. Możesz też wpisać system=Firestore w polu wyszukiwania.

3. Wybierz bazę danych.

4. Na stronie Szczegóły Firestore kliknij kartę Lista wpisów, a następnie kliknij Pokaż wszystkie wpisy podrzędne w wyszukiwaniu.

5. Na stronie Szczegóły bazy danych Firestore kliknij kartę Lista wpisów, a następnie kliknij Pokaż wszystkie wpisy podrzędne w wyszukiwarce. Knowledge Catalog wyświetla grupy kolekcji w bazie danych.

6. Wybierz nazwę grupy kolekcji, a następnie na stronie Szczegóły grupy kolekcji kliknij Schemat, aby wyświetlić schemat.

7. Opcjonalnie: aby dodać typ aspektu do bazy danych, kliknij przycisk Dodaj aspekt.

Ceny

Przechowywanie metadanych technicznych Cloud Firestore w Knowledge Catalog jest bezpłatne. W przypadku wywołań interfejsu API i dodatkowego wzbogacania metadanych biznesowych obowiązują standardowe ceny Knowledge Catalog. Więcej informacji znajdziesz na stronie z cenami Knowledge Catalog.

Ograniczenia

• Wyniki zapytania są obcinane po przetworzeniu 10 000 grup kolekcji.
• Podczas pozyskiwania danych zbiorczych odzwierciedlenie aktualizacji bazy danych w Knowledge Catalog może potrwać do 48 godzin.
• Podczas przetwarzania na żywo może minąć do 5 minut, zanim aktualizacje bazy danych zostaną odzwierciedlone w Knowledge Catalog.
• Grupy kolekcji nie są aktualizowane podczas przetwarzania na żywo.
• Schematy grup kolekcji są aktualizowane podczas przetwarzania na żywo, ale ta aktualizacja obejmuje tylko pierwszych 100 prymitywnych pól najwyższego poziomu w porządku alfabetycznym. Pozostałe informacje o schemacie są aktualizowane w ciągu 24–48 godzin od przetworzenia danych na żywo.
• Proces wyodrębniania może potrwać kilka minut.

Co dalej?

• Zarządzanie katalogiem danych w Knowledge Catalog
• Role Identity and Access Management w Knowledge Catalog