Sintassi di ricerca per Dataplex Catalog

Questo documento descrive la sintassi delle query di ricerca di Dataplex. Prima di leggere questo documento, è importante comprendere i concetti di Dataplex Catalog, ad esempio voci di dati, aspetti, tipi di aspetti, gruppi di voci e tipi di voci. Per saperne di più, consulta la panoramica di Dataplex Catalog.

Per lanciare una query di ricerca di Dataplex Catalog nella console Google Cloud, vai alla pagina Ricerca di Dataplex e seleziona Dataplex Catalog come modalità di ricerca.

Vai a Cerca

Per saperne di più, consulta Cercare risorse in Dataplex Catalog.

Nella sua forma più semplice, una query di ricerca di Dataplex Catalog è costituita da un singolo predicato. Un predicato di questo tipo può corrispondere a più elementi di metadati:

  • Una sottostringa di un nome, un nome visualizzato o una descrizione di una risorsa
  • Una sottostringa del tipo di una risorsa
  • Una sottostringa di un nome di colonna (o nome di colonna nidificata) nello schema di una risorsa
  • Una sottostringa di un ID progetto
  • Una stringa da una descrizione generale

Ad esempio, il predicato foo corrisponde alle seguenti entità:

  • Risorsa con il nome foo.bar
  • Risorsa con il nome visualizzato Foo Bar
  • Risorsa con descrizione This is the foo script
  • Risorsa con il tipo esatto foo
  • Colonna foo_bar nello schema di una risorsa
  • Colonna nidificata foo_bar nello schema di una risorsa
  • Progetto prod-foo-bar
  • Risorsa con una panoramica contenente la parola foo

Predicati qualificati

Puoi qualificare un predicato anteponendogli una chiave che limita la corrispondenza a un determinato elemento di metadati:

  • Un segno di uguale (=) limita la ricerca a una corrispondenza esatta.
  • Un due punti (:) dopo la chiave associa il predicato a una sottostringa o a un token all'interno del valore nei risultati di ricerca.

La tokenizzazione suddivide lo stream di testo in una serie di token, ciascuno solitamente corrispondente a una singola parola.

Ad esempio:

  • name:foo seleziona le entità con nomi contenenti la sottostringa foo, ad esempio foo1 e barfoo.
  • description:foo seleziona le entità con il token foo nella descrizione, come bar e foo.
  • location=foo corrisponde alle risorse in una località specificata con foo come nome della località.

Le chiavi del predicato type, system, location e orgid supportano solo il qualificatore della corrispondenza esatta (=), non il qualificatore della sottostringa (:). Ad esempio,type=foo o orgid=number.

Dataplex Catalog supporta i seguenti qualificatori:

Qualificatore Descrizione
name:x Corrisponde a x come sottostringa dell'ID risorsa.
displayname:x Corrispondenza di x come sottostringa del nome visualizzato della risorsa.
column:x Corrisponde a x come sottostringa del nome della colonna (o del nome della colonna nidificata) nello schema della risorsa.
description:x Corrisponde a x come token nella descrizione della risorsa.
label:bar Corrisponde alle risorse BigQuery che hanno un'etichetta (con un valore) e la chiave dell'etichetta ha bar come sottostringa.
label=bar Corrisponde alle risorse BigQuery che hanno un'etichetta (con un valore) e la chiave dell'etichetta è uguale a bar come stringa.
label:bar:x Corrisponde a x come sottostringa nel valore di un'etichetta con la chiave bar associata a una risorsa BigQuery.
label=foo:bar Corrisponde alle risorse BigQuery in cui la chiave è uguale a foo e il valore della chiave è uguale a bar.
label.foo=bar Corrisponde alle risorse BigQuery in cui la chiave è uguale a foo e il valore della chiave è uguale a bar.
label.foo Corrisponde alle risorse BigQuery con un'etichetta la cui chiave è uguale a foo come stringa.
type=TYPE Corrisponde alle risorse di un tipo di voce specifico o al relativo alias di tipo.
projectid:bar Corrisponde alle risorse all'interno dei progetti Google Cloud che corrispondono bar come sottostringa nell'ID.
parent:x Corrisponde a x come sottostringa del percorso gerarchico di una risorsa. Il percorso principale è un fully_qualified_name della risorsa principale.
orgid=number Corrisponde alle risorse all'interno di un'organizzazione Google Cloud con il valore ID esatto di number.
system=SYSTEM Corrisponde alle risorse di un sistema specificato.
location=LOCATION

Corrisponde alle risorse in una posizione specificata con un nome esatto. Ad esempio, location=us-central1 corrisponde agli asset ospitati in Iowa.

Gli asset BigQuery Omni supportano questo qualificatore utilizzando il nome della posizione BigQuery Omni. Ad esempio, location=aws-us-east-1 corrisponde agli asset BigQuery Omni nella Virginia settentrionale.

createtime

Trova le risorse create prima, dopo o entro una determinata data o ora.

Ad esempio:

  • createtime:2019-01-01 corrisponde alle risorse create il giorno 1/01/2019.
  • createtime<2019-02 corrisponde alle risorse create prima del giorno 01-02-2019 00:00:00.
  • createtime>2019-02 corrisponde alle risorse create dopo il giorno 01-02-2019 00:00:00.

Formato del timestamp: YYYY-MM-DDThh:mm:ss

Tutti i timestamp devono essere in GMT; i fusi orari non sono supportati. Sono supportati i timestamp parziali, i separatori di date con trattino (-) e i separatori di date con barra (/).

Ad esempio:

  • 2010-10-22T05:36:24
  • 2010-10-22T05:36
  • 2010-10-22T05
  • 2010-10-22
  • 2010-10
  • 2010
  • 2010/10/22
updatetime

Trova le risorse aggiornate prima, durante o dopo una determinata data o ora.

Ad esempio:

  • updatetime:2019-01-01 corrisponde alle risorse aggiornate il giorno 1° gennaio 2019.
  • updatetime<2019-02 corrisponde alle risorse aggiornate prima del 01-02-2019 00:00:00.
  • updatetime>2019-02 corrisponde alle risorse aggiornate dopo il giorno 01-02-2019 00:00:00.

Formato del timestamp: YYYY-MM-DDThh:mm:ss

Tutti i timestamp devono essere in GMT; i fusi orari non sono supportati. Sono supportati i timestamp parziali, i separatori di date con trattino (-) e i separatori di date con barra (/).

Ad esempio:

  • 2010-10-22T05:36:24
  • 2010-10-22T05:36
  • 2010-10-22T05
  • 2010-10-22
  • 2010-10
  • 2010
  • 2010/10/22
fully_qualified_name:x Corrisponde a x come sottostringa di fully_qualified_name.
fully_qualified_name=x Corrisponde a x come fully_qualified_name.

Per cercare le voci in base agli aspetti associati, utilizza la seguente sintassi della query.

Qualificatore Descrizione
aspect:x Corrisponde a x come sottostringa del percorso completo al tipo di aspetto di un aspetto associato alla voce, nel formato projectid.location.ASPECT_TYPE_ID
aspect=x Corrisponde a x come percorso completo al tipo di aspetto di un aspetto associato alla voce, nel formato projectid.location.ASPECT_TYPE_ID
aspect:xOPERATORvalue

Cerca i valori dei campi di aspetto. Corrisponde a x come sottostringa del percorso completo al tipo di aspetto e al nome del campo di un aspetto associato alla voce, nel formato projectid.location.ASPECT_TYPE_ID.FIELD_NAME

L'elenco degli operatori supportati dipende dal tipo di campo nell'aspetto, come segue:

  • Stringa: = (corrispondenza esatta) e : (sottostringa)
  • Tutti i tipi di numeri: =, :, <, >, <=, >=, =>, =<
  • Enum: =
  • Data e ora: come per i numeri, ma i valori da confrontare vengono trattati come date e ora anziché come numeri
  • Boolean: =

Solo i campi di primo livello dell'aspetto sono disponibili per la ricerca.

Ad esempio, tutte le seguenti query corrispondono alle voci in cui il valore del campo is-enrolled nell'aspetto employee-info è true. Vengono restituite anche altre voci che corrispondono alla sottostringa.

  • aspect:example-project.us-central1.employee-info.is-enrolled=true
  • aspect:example-project.us-central1.employee=true
  • aspect:employee=true

Operatori logici

Una query può essere composta da più predicati con operatori logici. Se non specifichi un operatore, viene implicito AND logico. Ad esempio, foo bar restituisce le entità che corrispondono sia al predicato foo sia al predicato bar.

Sono supportati i valori logici AND e OR. Ad esempio: foo OR bar.

Puoi negare un predicato con un prefisso - (trattino) o NOT. Ad esempio, -name:foo restituisce le entità con nomi che non corrispondono al predicato foo.

Gli operatori logici non sono sensibili alle maiuscole. Ad esempio, sia or sia OR sono accettabili.

Sintassi abbreviata

È disponibile anche una sintassi di ricerca abbreviata, che utilizza | (barra verticale) per gli operatori OR e , (virgola) per gli operatori AND.

Ad esempio, per cercare voci all'interno di uno dei molti progetti utilizzando l'operatore OR, puoi utilizzare la seguente sintassi abbreviata:

projectid:(id1|id2|id3|id4)

La stessa ricerca senza utilizzare la sintassi abbreviata è la seguente:

projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4

Per cercare voci con nomi di colonne corrispondenti, utilizza quanto segue:

  • AND: column:(name1, name2, name3)
  • OPPURE: column:(name1|name2|name3)

Questa sintassi abbreviata funziona per i predicati qualificati, ad eccezione di label.

Passaggi successivi