Cerca asset di dati in Dataplex Catalog

Utilizza la ricerca in Dataplex Catalog per cercare asset di dati come come set di dati BigQuery, istanze Cloud SQL e altri. Per ulteriori informazioni informazioni sugli asset Google Cloud supportati Dataplex Catalog, consulta Origini Google Cloud supportate.

Nota: questo documento descrive la ricerca di Dataplex Catalog. Per informazioni sulla ricerca in Data Catalog, consulta Cercare e visualizzare gli asset di dati con Data Catalog e Dataplex Catalog e Data Catalog.

Ambito della ricerca

I risultati di ricerca in Dataplex Catalog rispettano le autorizzazioni che hai sulle risorse corrispondenti nei sistemi di origine.

Ad esempio, se disponi dell'accesso in lettura ai metadati BigQuery , quell'oggetto viene visualizzato nella tua ricerca in Dataplex Catalog che consentono di analizzare i dati e visualizzare i risultati. Se hai accesso a una tabella BigQuery, ma non al contenente la tabella, la tabella viene comunque visualizzata come previsto Ricerca in Dataplex Catalog.

I risultati di ricerca includono solo le risorse che appartengono alla stessa rete VPC-SC perimetro come progetto sotto il quale viene eseguita la ricerca. Quando utilizzi il Google Cloud, si tratta del progetto selezionato nella Google Cloud.

Per ulteriori informazioni sui ruoli IAM Dataplex Catalog, consulta Ruoli IAM 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 nel risultato successivo pagine. Inoltre, i risultati restituiti (e non restituiti) possono variare se ripeti query di ricerca.

Tabelle con frazioni di data

Dataplex Catalog aggrega le tabelle con frazioni di date in un'unica voce logica. Questa voce ha lo stesso schema dello shard della tabella con il numero 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 avranno accesso al set di dati che li contiene. Privato con data frazionata tabelle non sono visibili nella ricerca in Dataplex Catalog, anche se sono presenti in Dataplex Catalog e possono essere taggati.

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. La 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 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 le risorse corrispondenti almeno una condizione per ogni sezione selezionata. Più filtri che vengono selezionate all'interno di una singola sezione vengono valutate utilizzando l'operatore logico OR.

Ad esempio, considera la combinazione di filtri nell'immagine seguente (fai clic sull'immagine per ingrandire). 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 dati test_bq_dataset.

Dataplex Catalog cerca i seguenti asset:

• Tabelle BigQuery in test_bq_dataset con aspetto My aspect type 1
• Tabelle BigQuery in test_bq_dataset con aspetto My aspect type 2
• Visualizzazioni BigQuery in test_bq_dataset con aspetto My aspect type 1
• Visualizzazioni BigQuery in test_bq_dataset con aspetto My aspect type 2

Filtra per valore di aspetto

I filtri Aspetti ti consentono di eseguire query per asset taggati utilizzando una specifica modello. Puoi utilizzare il menu Personalizza per perfezionare ulteriormente i risultati e filtrare in base a specifici valori di aspetto. Le condizioni di filtro dei valori di aspetto dipendono il tipo di dati di quel campo di aspetto. Ad esempio, per datetime e number puoi specificare una data o un intervallo specifici.

Filtra visibilità

I filtri Sistemi, Alias del tipo, Progetto e Set di dati sono visualizzato a seconda della query corrente nel campo Ricerca.

Nota: i set di filtri non vengono aggiornati se modifichi i filtri selezionati. Ad esempio: se selezioni il sistema BigQuery nella sezione Sistemi, i dati i filtri dei tipi non si limitano ai filtri specifici di BigQuery come una tabella, una vista o un set di dati.

Prima di iniziare

Prima di cercare asset di dati, procedi nel seguente modo.

Ruoli obbligatori

Questa sezione descrive i ruoli e le autorizzazioni necessari per cercare i dati asset e accedere ai risultati di ricerca.

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci accesso.

Potresti anche riuscire a ottenere le autorizzazioni richieste ruoli personalizzati o altro ruoli predefiniti.

Ruoli obbligatori per la ricerca delle voci

Per cercare le voci, hai bisogno di almeno uno dei Ruoli IAM di Dataplex Catalog all'interno del progetto utilizzato per la ricerca. Le autorizzazioni nei risultati di ricerca sono indipendentemente dal progetto selezionato.

Ruoli richiesti per accedere ai risultati di ricerca

L'ambito dei risultati di ricerca in Dataplex Catalog è limitato il tuo ruolo. Per cercare un asset in Dataplex Catalog, devi dispongono delle autorizzazioni per accedere alla risorsa corrispondente nel sistema di origine. Per saperne di più, consulta la sezione Ambito della ricerca di questo documento.

Ad esempio, per cercare set di dati, tabelle, viste e set di dati BigQuery modelli, devi disporre delle rispettive autorizzazioni per queste voci. Per ulteriori informazioni, vedi Autorizzazioni BigQuery. Nell'elenco seguente vengono descritte le autorizzazioni minime richieste:

• Per cercare una tabella, devi disporre dell'autorizzazione bigquery.tables.get .
• Per cercare un set di dati, devi disporre dell'autorizzazione bigquery.tables.get del set di dati.
• Per cercare metadati per un set di dati o una tabella, è necessario il metodo BigQuery Ruolo Visualizzatore metadati (roles/bigquery.metadataViewer).

Un altro esempio: per cercare istanze, database, schemi di Cloud SQL tabelle e viste, devi disporre delle rispettive autorizzazioni per queste voci. Per ulteriori informazioni le informazioni, vedi Ruoli e autorizzazioni di Cloud SQL.

Per cercare voci personalizzate, devi avere il ruolo Visualizzatore Dataplex Catalog (roles/dataplex.catalogViewer).

Abilita l'API

Attiva l'API Dataplex.

Abilita l'API

Ricerca di asset di dati

Console

Per cercare asset di dati:

1. Nella console Google Cloud, vai alla pagina Ricerca in Dataplex.

   Vai a Cerca

2. Per Scegli la piattaforma di ricerca, seleziona Dataplex Catalog come modalità di ricerca.

   Se selezioni Dataplex Catalog puoi eseguire ricerche Archiviazione dei metadati Dataplex Catalog. Selezione Data Catalog ti consente di eseguire ricerche in Data Catalog repository esistente, se sei un utente di Data Catalog esistente.

3. 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. Rete di ricerca per 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, seleziona e fai clic su OK.

4. (Facoltativo) Oltre agli asset disponibili, 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. Per ad esempio "search terms".

• Puoi anteporre NOT a una parola chiave in modo che corrisponda alla negazione logica del Filtro keyword:term. Puoi anche utilizzare gli operatori booleani AND e OR per combinare le espressioni di ricerca. Gli operatori AND, OR e NOT non sono sensibile alle maiuscole.

  Ad esempio, NOT column:term elenca tutte le colonne tranne quelle che corrispondono del termine specificato. Per un elenco di parole chiave e altri termini che puoi utilizzare nella un'espressione di ricerca in Dataplex Catalog, consulta Sintassi di ricerca.

gcloud

Per cercare asset di dati, utilizza 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.

1. Nella console Google Cloud, vai alla pagina Ricerca in Dataplex.

   Vai a Cerca

2. Seleziona Dataplex Catalog come modalità di ricerca.

3. Nella casella di ricerca, inserisci il nome di una voce.

4. Fai clic sulla voce.

   Si apre la pagina dei dettagli della voce. La pagina include le seguenti sezioni:

   • Dettagli voce: include informazioni quali tipo di voce, sistema piattaforma, nome completo, ora di creazione, ora ultima modifica, descrizione e amministratori.
   • Panoramica: una panoramica della voce, se disponibile.
   • Aspetti: gli aspetti obbligatori e facoltativi definiti per la voce. Per ulteriori informazioni, vedi Categorie di aspetti.

gcloud

Per visualizzare i dettagli di una voce, utilizza 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.