Wyświetlanie statystyk Knowledge Catalog

Zasoby Cloud Firestore możesz wyszukiwać i nimi zarządzać za pomocą Knowledge Catalog, czyli platformy do przechowywania metadanych, zarządzania nimi i uzyskiwania do nich dostępu. Knowledge Catalog umożliwia analizowanie metadanych Cloud Firestore i pomaga w wykonywaniu takich zadań jak:

• analiza, w tym zależności i przydatność do danego przypadku użycia;
• zarządzanie zmianą;
• ewolucja schematu.

Knowledge Catalog jest domyślnie włączony w nowych i dotychczasowych Cloud Firestore bazach danych i automatycznie pobiera te metadane:

Zanim zaczniesz

Aby korzystać z analiz w Knowledge Catalog w Cloud Firestore, musisz najpierw mieć bazę danych Cloud Firestore. Więcej informacji znajdziesz w artykule Tworzenie baz danych i zarządzanie nimi.

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

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

Aby przyznać podmiotom zabezpieczeń (takim jak użytkownicy, grupy lub konta usługi) te uprawnienia, przypisz im rolę uprawnień Wyświetlający Cloud Datastore (roles/datastore.viewer) w projekcie, który zawiera 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 Cloud Firestore role i uprawnienia.

Role wymagane 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ą 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 (takie jak kolekcje i bazy danych) i wyodrębniać ich metadane techniczne (np. 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 w języku naturalnym

Knowledge Catalog obsługuje wyszukiwanie słów kluczowych i 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 Cloud Firestore bazy danych.
• Wyszukiwanie w języku naturalnym (wersja zapoznawcza) wykorzystuje AI do interpretowania zapytań semantycznych. Umożliwia znajdowanie zasobów za pomocą języka potocznego, 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 Składnia wyszukiwania w Knowledge Catalog.

Przykład: wykrywanie schematu grupy kolekcji Cloud Firestore

Aby zrozumieć proces wykrywania metadanych, rozważ Cloud Firestore bazę danych 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 swoich Cloud Firestore zasobów. Dołączanie aspektów do zasobów umożliwia:

• dodawanie metadanych biznesowych do zasobó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.

Wyszukiwanie zasobów Cloud Firestore

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

1. Otwórz stronę Wyszukiwanie w 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 typów:

   • Baza danych
   • Schemat bazy danych
   • Inne

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

W polu wyszukiwania w Knowledge Catalog możesz wykonywać zapytania dotyczące wyszukiwania słów kluczowych. Możesz na przykład wpisać system=Firestore AND type=Database, aby wyświetlić wszystkie Cloud Firestore bazy danych.

Więcej informacji znajdziesz w artykule Składnia wyszukiwania w 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 złożonych wyrażeń możesz też używać nawiasów oraz 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 Knowledge Catalog.

W polu wyszukiwania możesz bezpośrednio wpisywać zapytania dotyczące wyszukiwania konkretnych zasobów Cloud Firestore do wyszukiwania. Format ciągu zapytania jest taki:

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

Zastąp następujące elementy:

• QUERY_STRING: użyj tej listy, aby określić ciąg zapytania na podstawie typu zasobu Cloud Firestore, o który chcesz zapytać:

  • 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 wyszukiwać według typu aspektu:

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
   • Schemat Cloud Firestore
3. Kliknij OK.
4. W tabeli wyników kliknij nazwę zasobu, aby wyświetlić jego metadane.
5. Opcjonalnie: ulepsz lub wyświetl zasoby. Możesz wykonać dowolną z tych czynności:
   • Aby dodać opis zasobu w formacie tekst sformatowany , w sekcji Przegląd kliknij Dodaj .
   • Aby dołączyć aspekt do zasobu, w sekcji Aspekty kliknij Dodaj .
   • Aby wyświetlić bazy danych członków instancji, kliknij kartę Lista wpisów , a następnie Pokaż wszystkie wpisy podrzędne w wyszukiwaniu.
   • W sekcji Szczegóły wpisu wyświetl pełne informacje o zasobie. Kliknij nazwę wpisu, aby przejść do dodatkowych wpisów.

Wyszukiwanie w języku naturalnym w Cloud Firestore

Wyszukiwanie w języku naturalnym (wersja zapoznawcza) wykorzystuje AI do interpretowania zapytań semantycznych. Umożliwia znajdowanie zasobów za pomocą języka potocznego, 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 Składnia wyszukiwania w Knowledge Catalog.

Wyszukiwanie składni 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 Cloud Firestore bazy danych.

Więcej informacji znajdziesz w artykule Składnia wyszukiwania w Knowledge Catalog.

Przykładowy przepływ pracy: przechodzenie od bazy danych do schematu

Aby przejść od bazy danych do schematu:

1. Otwórz stronę Wyszukiwanie w 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 Pokaż wszystkie wpisy podrzędne w wyszukiwaniu.

5. Na stronie Szczegóły bazy danych Firestore kliknij kartę Lista wpisów , a następnie Pokaż wszystkie wpisy podrzędne w wyszukiwaniu. 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 cennika Knowledge Catalog.

Ograniczenia

• Wyniki zapytania są obcinane po pozyskaniu 10 tys. grup kolekcji.
• Podczas pozyskiwania zbiorczego aktualizacje bazy danych mogą być widoczne w Knowledge Catalog dopiero po 48 godzinach.
• Podczas pozyskiwania na żywo aktualizacje bazy danych mogą być widoczne w Knowledge Catalog dopiero po 5 minutach.
• Grupy kolekcji nie są aktualizowane podczas pozyskiwania na żywo.
• Schematy grup kolekcji są aktualizowane podczas pozyskiwania na żywo, ale ta aktualizacja obejmuje tylko pierwsze 100 pól pierwotnych najwyższego poziomu w kolejności alfabetycznej. Pozostałe informacje o schemacie są aktualizowane w ciągu 24–48 godzin po pozyskaniu na żywo.
• Proces wyodrębniania może potrwać kilka minut.

Co dalej?

• Informacje o zarządzaniu katalogiem danych w Knowledge Catalog
• Role uprawnień Knowledge Catalog Identity and Access Management