Puoi cercare e gestire le tue risorse Cloud Firestore utilizzando Knowledge Catalog, una piattaforma per l'archiviazione, la gestione e l'accesso ai metadati. Puoi utilizzare Knowledge Catalog per analizzare i metadati di Cloud Firestore e aiutarti con 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
Abilita l'API Knowledge Catalog (dataplex.googleapis.com).
- Prima di poter abilitare le API, devi disporre del ruolo IAM Amministratore di Service Usage
roles/serviceusage.serviceUsageAdmin, che contiene l'autorizzazioneserviceusage.services.enable. Scopri come concedere i ruoli. - Per abilitare un'API, consulta Abilitazione delle API.
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 i database.
Ruoli richiesti per accedere ai risultati di ricerca
Per cercare e visualizzare i metadati di 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à, ad esempio utenti, gruppi o service account, assegna loro il ruolo IAM Cloud Datastore Viewer (roles/datastore.viewer) nel progetto che contiene le risorse Cloud Firestore.
| 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 obbligatori 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 Cerca 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 posizioni, nel catalogo di Knowledge Catalog. Questo processo viene eseguito periodicamente per mantenere il catalogo sincronizzato con i sistemi di origine.
Ricerca per parole chiave e in linguaggio naturale
Knowledge Catalog supporta le ricerche per parole chiave e in linguaggio naturale.
- La ricerca per parole chiave ti consente di trovare risorse utilizzando parole chiave specifiche, filtri e una sintassi definita. 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. Ti 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: scopri uno schema di gruppo di raccolte Cloud Firestore
Per comprendere il processo di rilevamento dei metadati, considera un database Cloud Firestore denominato user-firestore-database. In questo database, hai 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.
Arricchisci 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 aspetti personalizzati, puoi collegare gli aspetti alle tue risorse Cloud Firestore. Il collegamento di aspetti alle risorse ti consente di:
- Aggiungi metadati aziendali agli asset
- Cerca asset in base ai metadati aziendali e ad altri metadati personalizzati
Per scoprire di più sulla creazione di tipi di aspetto e sul collegamento di aspetti a Cloud Firestore, consulta Gestisci gli aspetti e arricchisci i metadati.
Cerca 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 e poi seleziona Firestore.
Facoltativo. In Alias di tipo, puoi filtrare i risultati di ricerca in base a un tipo specifico di asset Cloud Firestore selezionando uno o più dei seguenti alias di tipo:
- Database
- Schema del database
- Altro
Utilizza le query per eseguire la ricerca per parola chiave
Puoi utilizzare il campo di ricerca in Knowledge Catalog per eseguire query di ricerca per parole chiave. 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.
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 scoprire di più sulle espressioni che puoi utilizzare 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 una query:firestore-databasefirestore-schema
Una query di esempio potrebbe essere simile alla seguente:
type="projects/1234567890/locations/global/entryTypes/firestore-schema"
Cerca per tipo di aspetto
Knowledge Catalog include alcuni tipi di aspetti integrati che puoi utilizzare per eseguire ricerche.
Per eseguire una ricerca in base al tipo di aspetto, segui questi passaggi:
- Nel riquadro Aspetti, fai clic sul menu Aggiungi altri tipi di aspetti.
- Inserisci
Firestore, quindi seleziona uno o più dei seguenti tipi di aspetto per limitare i risultati di ricerca a quel tipo.- Cloud Firestore database
- Cloud Firestore schema
- Fai clic su OK.
- Nella tabella dei risultati, fai clic sul nome della risorsa per visualizzarne i metadati.
- (Facoltativo) Migliora o visualizza gli asset. Puoi eseguire una delle seguenti operazioni:
- Per aggiungere una descrizione in RTF dell'asset, fai clic su Aggiungi in Panoramica .
- 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. Ti 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 della sintassi in Cloud Firestore
La ricerca per parole chiave ti consente di trovare risorse utilizzando parole chiave specifiche, filtri e una sintassi definita. 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.
Esempio di flusso di lavoro: visualizza in dettaglio dal database allo schema
Per eseguire il drill down 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 del 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 è previsto alcun costo per l'archiviazione dei metadati tecnici di Cloud Firestore in Knowledge Catalog. Si applicano i prezzi standard di Knowledge Catalog per le chiamate API e l'arricchimento aggiuntivo dei metadati aziendali. Per saperne di più, consulta la pagina dei prezzi di Knowledge Catalog.
Limitazioni
- I risultati della query vengono troncati dopo l'importazione di 10.000 gruppi di raccolte.
- Durante l'importazione in batch, possono essere necessarie fino a 48 ore prima che gli aggiornamenti al database vengano visualizzati in Knowledge Catalog.
- Durante l'importazione in tempo reale, 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 in tempo reale.
- Gli schemi dei gruppi di raccolte vengono aggiornati durante l'importazione in tempo reale, ma questo aggiornamento copre solo i primi 100 campi primitivi di primo livello in ordine alfabetico. Le restanti informazioni dello schema vengono aggiornate da 24 a 48 ore dopo l'importazione in tempo reale.
- Il processo di estrazione potrebbe richiedere alcuni minuti.
Passaggi successivi
- Informazioni sulla gestione del Data Catalog in Knowledge Catalog
- Ruoli di Identity and Access Management di Knowledge Catalog