Puoi cercare e gestire le risorse Cloud Firestore utilizzando Knowledge Catalog, una piattaforma per archiviare, gestire e accedere ai metadati. Puoi utilizzare Knowledge Catalog per analizzare i Cloud Firestore metadati e svolgere attività come:
- Analisi, incluse le dipendenze e l'idoneità per un caso d'uso
- Gestione dei cambiamenti
- Evoluzione dello schema
Knowledge Catalog è abilitato per impostazione predefinita nei database Cloud Firestore nuovi ed esistenti e recupera automaticamente i seguenti metadati:
| Risorsa | Tipo | Campi |
|---|---|---|
| Database | Control plane |
|
| Schema del database | Piano dati |
|
Prima di iniziare
Per utilizzare gli insight di Knowledge Catalog con Cloud Firestore, devi prima avere un database Cloud Firestore. Per saperne di più, consulta Crea e gestisci database.
Ruoli richiesti per accedere ai risultati di ricerca
Per cercare e visualizzare i metadati Cloud Firestore in
Knowledge Catalog, le entità devono disporre delle autorizzazioni per visualizzare le risorse
Cloud Firestore, inclusa l'autorizzazione
dataplex.projects.search.
Per concedere queste autorizzazioni alle entità, come utenti, gruppi o service account, assegna loro il
Visualizzatore Cloud Datastore (roles/datastore.viewer)
ruolo IAM nel progetto che contiene le Cloud Firestore
risorse.
| Operazione di Knowledge Catalog | Cloud Firestore risorsa | Ruoli o autorizzazioni richiesti |
|---|---|---|
| Cerca risorse Cloud Firestore | Database | datastore.databases.getMetadata |
| Schema del database | datastore.schemas.get |
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso. Per saperne di più sui ruoli IAM di Cloud Firestore, consulta ruoli e autorizzazioni di Cloud Firestore.
Ruoli richiesti per la ricerca di voci
Per cercare le voci, devi avere almeno uno dei seguenti ruoli IAM all'interno del progetto usato per la ricerca:
- Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) - Dataplex Catalog Editor (
roles/dataplex.catalogEditor) - Dataplex Catalog Viewer (
roles/dataplex.catalogViewer)
Le autorizzazioni sui risultati di ricerca vengono controllate indipendentemente dal progetto selezionato. Per saperne di più, consulta Cercare asset di dati con Knowledge Catalog.
Tipi di rilevamento dei metadati
Il rilevamento dei metadati di Knowledge Catalog è un processo automatizzato che analizza le origini dati connesse, come Cloud Firestore, per identificare gli asset di dati (come raccolte e database) ed estrarre i relativi metadati tecnici, come schemi, descrizioni e località, nel catalogo di Knowledge Catalog. Questo processo viene eseguito periodicamente per mantenere il catalogo sincronizzato con i sistemi di origine.
Ricerca per parola chiave e in linguaggio naturale
Knowledge Catalog supporta le ricerche per parola chiave e in linguaggio naturale.
- La ricerca per parola chiave consente di trovare le risorse utilizzando parole chiave, filtri e una sintassi definiti. Ad esempio, puoi inserire
system=Firestore AND type=Databaseper visualizzare tutti i database Cloud Firestore. - La ricerca in linguaggio naturale (anteprima) utilizza l'AI per comprendere le query semantiche. Consente di trovare le risorse utilizzando un linguaggio naturale, eliminando la necessità di una sintassi complessa. Ad esempio, puoi inserire query come
List all Firestore databases related to sales.
Per saperne di più, consulta Sintassi di ricerca per Knowledge Catalog.
Esempio: scoprire lo schema di un gruppo di raccolte Cloud Firestore
Per comprendere il processo di rilevamento dei metadati, considera un Cloud Firestore
database denominato user-firestore-database. In questo database è presente uno schema di gruppo di raccolte denominato user-schema.
Al termine del rilevamento, puoi cercare questi asset, user-firestore-database
e user-schema, nella pagina Knowledge Catalog della
console Google Cloud o utilizzando l'API Knowledge Catalog.
Puoi quindi visualizzare i dettagli degli asset e arricchirli con metadati aziendali o operativi aggiuntivi.
Arricchire i metadati utilizzando gli aspetti
I tipi di aspetto sono risorse riutilizzabili che puoi utilizzare come modelli per gli aspetti. I tipi di aspetto ti aiutano a evitare la duplicazione del lavoro e gli aspetti incompleti. Puoi utilizzare Knowledge Catalog per creare i tipi di aspetto di cui hai bisogno.
Dopo aver creato i tipi di aspetto personalizzati, puoi collegare gli aspetti alle tue Cloud Firestore risorse. Il collegamento degli aspetti alle risorse consente di:
- Aggiungere metadati aziendali agli asset
- Cercare gli asset in base ai metadati aziendali e ad altri metadati personalizzati
Per saperne di più sulla creazione di tipi di aspetto e sul collegamento degli aspetti a Cloud Firestore, consulta Gestire gli aspetti e arricchire i metadati.
Cercare asset Cloud Firestore
Utilizza la pagina di ricerca di Knowledge Catalog nella console Google Cloud per cercare gli asset Cloud Firestore.
Vai alla pagina Ricerca di Knowledge Catalog.
Nel riquadro Filtri, fai clic su Sistemi, quindi seleziona Firestore.
(Facoltativo) In Alias di tipo, puoi filtrare i risultati di ricerca in base a un tipo specifico di Cloud Firestore asset selezionando uno o più dei seguenti alias di tipo:
- Database
- Schema del database
- Altro
Utilizzare le query per eseguire la ricerca per parola chiave
Puoi utilizzare il campo di ricerca in Knowledge Catalog per eseguire query di ricerca per parola chiave. Ad esempio, puoi inserire
system=Firestore AND type=Database per visualizzare tutti i Cloud Firestore database.
Per saperne di più, consulta Sintassi di ricerca per Knowledge Catalog.
Per visualizzare tutti gli asset Cloud Firestore, inserisci system=Firestore. Puoi inserire parole chiave specifiche. Ad esempio, per visualizzare tutti i database Cloud Firestore:
system=Firestore AND type=Database
Puoi anche utilizzare le parentesi e gli operatori logici AND e OR per espressioni complesse. Per saperne di più sulle espressioni che puoi utilizzare in
nel campo di ricerca, consulta Sintassi di ricerca per Knowledge Catalog.
Puoi inserire direttamente le query di ricerca per asset Cloud Firestore specifici nel campo di ricerca. Il formato della stringa di query è il seguente:
type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"
Sostituisci quanto segue:
QUERY_STRING: utilizza il seguente elenco per identificare una stringa di query in base al tipo di asset Cloud Firestore su cui vuoi eseguire la query:firestore-databasefirestore-schema
Una query di esempio potrebbe essere simile alla seguente:
type="projects/1234567890/locations/global/entryTypes/firestore-schema"
Cercare per tipo di aspetto
Knowledge Catalog include alcuni tipi di aspetto integrati che puoi utilizzare per eseguire le ricerche.
Per cercare per tipo di aspetto:
- Nel riquadro Aspetti, fai clic sul menu Aggiungi altri tipi di aspetto.
- Inserisci
Firestore, quindi seleziona uno o più dei seguenti tipi di aspetto per limitare i risultati di ricerca a quel tipo.- Database Cloud Firestore
- Schema Cloud Firestore
- Fai clic su OK.
- Nella tabella dei risultati, fai clic sul nome dell'asset per visualizzarne i metadati.
- (Facoltativo) Migliora o visualizza gli asset. Puoi eseguire una delle seguenti operazioni:
- Per aggiungere una descrizione in RTF dell'asset, in Panoramica, fai clic su Aggiungi .
- Per collegare un aspetto all'asset, in Aspetti, fai clic su Aggiungi .
- Per visualizzare i database membri di un'istanza, fai clic sulla scheda Elenco voci , quindi su Mostra tutte le voci secondarie nella ricerca.
- In Dettagli voce, visualizza i dettagli completi dell'asset. Fai clic sul nome della voce per visualizzare altre voci.
Ricerca in linguaggio naturale in Cloud Firestore
La ricerca in linguaggio naturale (anteprima) utilizza l'AI per comprendere le query semantiche. Consente di trovare le risorse utilizzando un linguaggio naturale, eliminando la necessità di una sintassi complessa. Ad esempio, puoi inserire query come List all Firestore collections related to sales.
Per saperne di più, consulta Sintassi di ricerca per Knowledge Catalog.
Ricerca per sintassi in Cloud Firestore
La ricerca per parola chiave consente di trovare le risorse utilizzando parole chiave, filtri e una sintassi definiti. Ad esempio, puoi inserire system=Firestore AND type=Database
per visualizzare tutti i database Cloud Firestore.
Per saperne di più, consulta Sintassi di ricerca per Knowledge Catalog.
Flusso di lavoro di esempio: visualizzare in dettaglio dal database allo schema
Per visualizzare in dettaglio da un database a uno schema:
Vai alla pagina Ricerca di Knowledge Catalog.
Nel riquadro Filtri, seleziona Sistemi e poi Firestore. In alternativa, inserisci
system=Firestorenel campo di ricerca.Seleziona un database.
Nella pagina Dettagli Firestore, fai clic sulla scheda Elenco voci, quindi su Mostra tutte le voci secondarie nella ricerca.
Nella pagina Dettagli database Firestore, fai clic sulla scheda Elenco voci , quindi su Mostra tutte le voci secondarie nella ricerca. Knowledge Catalog mostra i gruppi di raccolte nel database.
Seleziona il nome di un gruppo di raccolte, quindi nella pagina Dettagli gruppo di raccolte fai clic su Schema per visualizzare lo schema.
(Facoltativo) Per aggiungere un tipo di aspetto a un database, fai clic sul pulsante Aggiungi aspetto.
Prezzi
Non sono previsti addebiti per l'archiviazione dei metadati tecnici Cloud Firestore in Knowledge Catalog. Si applicano i prezzi standard di Knowledge Catalog per le chiamate API e l'arricchimento dei metadati aziendali aggiuntivi. Per saperne di più, consulta la pagina dei prezzi di Knowledge Catalog.
Limitazioni
- I risultati delle query vengono troncati dopo l'importazione di 10.000 gruppi di raccolte.
- Durante l'importazione batch, possono essere necessarie fino a 48 ore prima che gli aggiornamenti al database vengano visualizzati in Knowledge Catalog.
- Durante l'importazione live, possono essere necessari fino a 5 minuti prima che gli aggiornamenti al database vengano visualizzati in Knowledge Catalog.
- I gruppi di raccolte non vengono aggiornati durante l'importazione live.
- Gli schemi dei gruppi di raccolte vengono aggiornati durante l'importazione live, ma questo aggiornamento riguarda solo i primi 100 campi primitivi di primo livello in ordine alfabetico. Le informazioni sullo schema rimanenti vengono aggiornate 24-48 ore dopo l'importazione live.
- La procedura di estrazione potrebbe richiedere alcuni minuti.
Passaggi successivi
- Informazioni sulla gestione del catalogo dati in Knowledge Catalog
- Ruoli Identity and Access Management di Knowledge Catalog