Usa la ricerca in Dataplex Catalog per cercare asset di dati come set di dati BigQuery, istanze Cloud SQL e altri. Per ulteriori informazioni sugli asset Google Cloud supportati in Dataplex Catalog, consulta Origini Google Cloud supportate.
Ambito della ricerca
I risultati di ricerca in Dataplex Catalog rispettano le autorizzazioni di cui disponi sulle risorse corrispondenti nei sistemi di origine.
Ad esempio, se disponi dell'accesso in lettura ai metadati BigQuery a un oggetto, quest'ultimo viene visualizzato nei risultati di ricerca di Dataplex Catalog. Se hai accesso a una tabella BigQuery, ma non al set di dati che la contiene, la tabella verrà comunque visualizzata come previsto nella ricerca di Dataplex Catalog.
I risultati della ricerca includono solo le risorse che appartengono allo stesso perimetro VPC-SC del progetto in cui viene eseguita la ricerca. Quando utilizzi la console Google Cloud, questo è il progetto selezionato nella console.
Per ulteriori informazioni sui ruoli IAM di Dataplex Catalog, consulta Ruoli IAM di Dataplex.
Limitazioni del richiamo nella ricerca
Le query di ricerca di Dataplex Catalog non garantiscono il richiamo completo. I risultati che corrispondono alla tua query potrebbero non essere restituiti, anche nelle pagine dei risultati successive. Inoltre, i risultati restituiti (e non restituiti) possono variare se ripeti le query di ricerca.
Tabelle con frazioni di data
Dataplex Catalog aggrega le tabelle suddivise in base alle date in un'unica voce logica. Questa voce ha lo stesso schema dello shard della tabella con la data più recente. La voce deriva il suo livello di accesso dal set di dati a cui appartiene. La ricerca in Dataplex Catalog mostra queste voci logiche solo se hai accesso al set di dati che le contiene. Le singole tabelle con sharding non sono visibili nella ricerca in Dataplex Catalog, anche se sono presenti in Dataplex Catalog e possono essere codificate.
Filtri
I filtri ti consentono di restringere i risultati di ricerca. Tutti i filtri sono raggruppati in sezioni:
- Sistemi come BigQuery, Cloud SQL e altri. Il sistema Dataplex contiene voci personalizzate.
- Aspetti (tag) elencano tutti gli aspetti disponibili per te.
- In Progetto sono elencati tutti i progetti disponibili per te.
- Alias dei tipi che descrivono i tipi di risorse, come database, set di dati, modelli, tabelle, viste, servizi e tipi personalizzati.
- I set di dati provengono da BigQuery.
Puoi combinare i filtri di più sezioni per trovare gli asset che corrispondono ad almeno una condizione per ogni sezione selezionata. Più filtri selezionati all'interno di una singola sezione vengono valutati utilizzando l'operatore logico OR
.
Ad esempio, considera la combinazione di filtri nell'immagine seguente (fai clic sull'immagine per ingrandirla). Questi filtri di ricerca sono selezionati: sistemi BigQuery
, alias di tipo table
e view
, aspetti My aspect
type 1
e My aspect type 2
, progetto my-test-project
e set di datitest_bq_dataset
.
Dataplex Catalog cerca i seguenti asset:
- Tabelle BigQuery in
test_bq_dataset
con aspettoMy aspect type 1
- Tabelle BigQuery in
test_bq_dataset
con aspettoMy aspect type 2
- Visualizzazioni BigQuery in
test_bq_dataset
con aspettoMy aspect type 1
- Visualizzazioni BigQuery in
test_bq_dataset
con aspettoMy aspect type 2
Filtra per valore di aspetto
I filtri Aspetti ti consentono di eseguire query per asset taggati utilizzando un modello specifico. Puoi utilizzare il menu Personalizza per perfezionare ulteriormente i risultati e
filtrare in base a valori di aspetto specifici. Le condizioni di filtro dei valori di aspetto dipendono
dal tipo di dati del campo in questione. Ad esempio, per i campi datetime
e number
, puoi specificare una data o un intervallo specifico.
Filtra visibilità
I filtri Sistemi, Alias del tipo, Progetto e Set di dati vengono visualizzati a seconda della query corrente nel campo Cerca.
Prima di iniziare
Prima di cercare asset di dati, procedi nel seguente modo.
Ruoli obbligatori
L'ambito dei risultati di ricerca in Dataplex Catalog dipende dal tuo ruolo. Per cercare un asset in Dataplex Catalog, devi disporre delle autorizzazioni per accedere alla risorsa corrispondente nel sistema di origine. Per ulteriori informazioni, consulta la sezione Ambito della ricerca di questo documento.
Ad esempio, per cercare set di dati, tabelle, viste e modelli BigQuery, devi disporre delle rispettive autorizzazioni per queste voci. Per ulteriori informazioni, consulta Autorizzazioni BigQuery. Nell'elenco seguente vengono descritte le autorizzazioni minime richieste:
- Per cercare una tabella, devi disporre dell'autorizzazione
bigquery.tables.get
per la tabella. - Per cercare un set di dati, devi disporre dell'autorizzazione
bigquery.tables.get
per il set di dati. - Per cercare metadati per un set di dati o una tabella, devi disporre del ruolo Visualizzatore metadati BigQuery (
roles/bigquery.metadataViewer
).
Come ulteriore esempio, per cercare istanze, database, schemi, tabelle e viste Cloud SQL, devi disporre delle rispettive autorizzazioni per queste voci. Per ulteriori informazioni, consulta Ruoli e autorizzazioni di Cloud SQL.
Per cercare voci personalizzate, devi avere il ruolo Visualizzatore Dataplex Catalog (roles/dataplex.catalogViewer
).
Per maggiori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Abilita l'API
Attiva l'API Dataplex.
Ricerca di asset di dati
Console
Per cercare asset di dati:
Nella console Google Cloud, vai alla pagina Ricerca in Dataplex.
Per Scegli la piattaforma di ricerca, seleziona Dataplex Catalog come modalità di ricerca.
Se selezioni Dataplex Catalog, puoi eseguire ricerche nell'archiviazione dei metadati di Dataplex Catalog. La selezione di Data Catalog ti consente di eseguire ricerche nel tuo repository Data Catalog, se sei già un utente di Data Catalog.
Nel campo di ricerca, inserisci la query o utilizza il riquadro Filtri per perfezionare i parametri di ricerca.
Puoi aggiungere manualmente i seguenti filtri:
- Aggiungi un filtro per il progetto: in Progetto, fai clic su Aggiungi progetto. Cerca un progetto specifico, selezionalo e fai clic su Apri.
- Aggiungi un filtro per tipo di aspetto: in Aspetti, fai clic sul menu Aggiungi altri tipi di aspetto. Cerca un modello specifico, selezionalo e fai clic su OK.
(Facoltativo) Oltre agli asset a tua disposizione, puoi cercare asset di dati disponibili pubblicamente in Google Cloud selezionando Includi set di dati pubblici.
Utilizza i seguenti suggerimenti per creare una query di ricerca:
- Racchiudi l'espressione di ricerca tra virgolette se contiene spazi. Ad
esempio,
"search terms"
. Puoi anteporre
NOT
a una parola chiave in modo che corrisponda alla negazione logica del filtrokeyword:term
. Puoi anche utilizzare gli operatori booleaniAND
eOR
per combinare le espressioni di ricerca. Gli operatoriAND
,OR
eNOT
non sono sensibili alle maiuscole.Ad esempio,
NOT column:term
elenca tutte le colonne tranne quelle che corrispondono al termine specificato. Per un elenco di parole chiave e altri termini che puoi utilizzare in un'espressione di ricerca in Dataplex Catalog, consulta Sintassi di ricerca.
gcloud
Per cercare asset di dati, utilizza il comando gcloud dataplex entries search
.
REST
Per cercare asset di dati, utilizza il metodo searchEntries
.
Visualizzare i dettagli di una voce
Console
Utilizza la ricerca in Dataplex Catalog per visualizzare i dettagli di una voce.
Nella console Google Cloud, vai alla pagina Ricerca in Dataplex.
Seleziona Dataplex Catalog come modalità di ricerca.
Nella casella di ricerca, inserisci il nome di una voce.
Fai clic sulla voce.
Si apre la pagina dei dettagli della voce. La pagina include le seguenti sezioni:
- Dettagli della voce: include informazioni quali tipo di voce, sistema, piattaforma, nome completo, ora di creazione, ora dell'ultima modifica, descrizione e steward.
- Panoramica: una panoramica della voce, se disponibile.
- Aspetti: gli aspetti obbligatori e facoltativi definiti per la voce. Per ulteriori informazioni, consulta Categorie di aspetti.
gcloud
Per visualizzare i dettagli di una voce, usa il comando gcloud dataplex entries lookup
.
REST
Per visualizzare i dettagli di una voce, utilizza il
metodo lookupEntry
.
Passaggi successivi
- Comprendere la sintassi di ricerca per Dataplex Catalog.
- Scopri di più su Dataplex Catalog.
- Scopri come arricchire le voci con metadati utilizzando gli aspetti.
- Scopri come gestire le voci e importare origini personalizzate.