En este documento, se describe la sintaxis de las búsquedas de Dataplex. Antes de leer este documento, es importante que comprendas los conceptos de Dataplex Catalog, como entradas de datos, aspectos, tipos de aspecto, grupos y tipos de entradas. Para obtener más información, consulta Descripción general del catálogo de Dataplex.
Para iniciar una búsqueda de Dataplex Catalog en la consola de Google Cloud, ve a la página Búsqueda de Dataplex y selecciona Dataplex Catalog como el modo de búsqueda.
Para obtener más información, consulta Busca recursos de datos en Dataplex Catalog.
Búsqueda simple
En su forma más sencilla, una consulta de búsqueda de Dataplex Catalog consta de un solo predicado. Este predicado puede coincidir con varias partes de metadatos:
- Subcadena de un nombre, nombre visible o descripción de un recurso de datos
- Subcadena del tipo de un recurso de datos
- Una subcadena del nombre de una columna (o el nombre de la columna anidada) en el esquema de un recurso de datos
- Una substring del ID del proyecto
- Una cadena de una descripción general
Por ejemplo, el predicado foo coincide con las siguientes entidades:
- Recurso de datos con el nombre
foo.bar - Recurso de datos con el nombre visible
Foo Bar - Recurso de datos con la descripción
This is the foo script - Recurso de datos con el tipo exacto
foo - Columna
foo_baren el esquema de un recurso de datos - Columna anidada
foo_baren el esquema de un recurso de datos prod-foo-bardel proyecto- Recurso de datos con una descripción general que contiene la palabra
foo
Predicados calificados
Para calificar un predicado, puedes agregarle un prefijo con una clave que restrinja la coincidencia a un fragmento específico de metadatos:
- Un signo igual (
=) restringe la búsqueda a una coincidencia exacta. - Dos puntos (
:) después de que la clave coincide con el predicado de una substring o un token dentro del valor en los resultados de la búsqueda.
La asignación de token divide el flujo de texto en una serie de tokens, cada uno correspondiente a una sola palabra.
Por ejemplo:
name:fooselecciona entidades con nombres que contienen la subcadenafoo, comofoo1ybarfoo.description:fooselecciona entidades con el tokenfooen la descripción, comobaryfoo.location=foohace coincidir los recursos de datos en una ubicación específica confoocomo el nombre de la ubicación.
Las claves de predicado type, system, location y orgid solo admiten el calificador de concordancia exacta (=), no el calificador de subcadena (:). Por ejemplo, type=foo o orgid=number.
Dataplex Catalog admite los siguientes calificadores:
| Calificador | Descripción |
|---|---|
name:x |
Coincide con x como una substring del ID del recurso de datos. |
displayname:x |
Haga coincidir x como una substring del nombre comercial del recurso de datos. |
column:x |
Busca una coincidencia con x como substring del nombre de la columna (o el nombre de la columna anidada) en el esquema del recurso de datos. |
description:x |
Coincide con x como un token en la descripción del recurso de datos. |
label:bar |
Coincide con los recursos de datos de BigQuery que tienen una etiqueta (con algún valor) y la clave de etiqueta tiene bar como subcadena. |
label=bar |
Haz coincidir los recursos de datos de BigQuery que tienen una etiqueta (con algún valor) y la clave de etiqueta es igual a bar como una cadena. |
label:bar:x |
Coincide con x como una substring en el valor de una etiqueta con la clave bar adjunta a un recurso de datos de BigQuery. |
label=foo:bar |
Coincide con los recursos de datos de BigQuery en los que la clave es igual a
foo y el valor de la clave es igual a bar. |
label.foo=bar |
Coincide con los recursos de datos de BigQuery en los que la clave es igual a
foo y el valor de la clave es igual a bar. |
label.foo |
Busca coincidencias con los recursos de datos de BigQuery que tienen una etiqueta cuya clave es igual a foo como una cadena. |
type=TYPE |
Hace coincidir recursos de datos de un tipo de entrada específico o su alias de tipo. |
projectid:bar |
Hace coincidir los recursos de datos dentro de los proyectos de Google Cloud que coinciden con bar como una substring en el ID. |
parent:x |
Busca x como substring de la ruta jerárquica de un recurso de datos. La ruta de acceso superior es una fully_qualified_name del recurso superior. |
orgid=number |
Hace coincidir los recursos de datos dentro de una organización de Google Cloud con
el valor de ID exacto de number. |
system=SYSTEM |
Hace coincidir recursos de datos de un sistema especificado. |
location=LOCATION |
Hace coincidir los recursos de datos de una ubicación específica con un nombre exacto.
Por ejemplo, Los recursos de BigQuery Omni admiten este calificador mediante el
nombre de ubicación de BigQuery Omni.
Por ejemplo,
|
createtime |
Encuentra recursos de datos que se crearon en una hora o fecha determinada, o bien antes o después de esta. Por ejemplo:
Formato de marca de tiempo: Todas las marcas de tiempo deben estar en GMT. No se admiten las zonas horarias. Se admiten las marcas de tiempo parciales, los separadores de fecha de guion ( Por ejemplo:
|
updatetime |
Encuentra recursos de datos que se actualizaron en una hora o fecha determinada, o antes o después de esta. Por ejemplo:
Formato de marca de tiempo: Todas las marcas de tiempo deben estar en GMT. No se admiten las zonas horarias. Se admiten las marcas de tiempo parciales, los separadores de fecha de guion ( Por ejemplo:
|
fully_qualified_name:x |
Coincide con x como una subcadena de fully_qualified_name. |
fully_qualified_name=x |
Coincide con x como fully_qualified_name. |
Búsqueda de aspecto
Para buscar entradas según sus aspectos adjuntos, usa la siguiente sintaxis de consulta.
| Calificador | Descripción |
|---|---|
aspect:x |
Coincide con x como una substring de la ruta de acceso completa al tipo de aspecto de un aspecto adjunto a la entrada, en el formato projectid.location.ASPECT_TYPE_ID. |
aspect=x |
Coincide con x como la ruta de acceso completa al tipo de aspecto de un aspecto adjunto a la entrada, en el formato projectid.location.ASPECT_TYPE_ID. |
aspect:xOPERATORvalue |
Busca valores de campo de aspecto. Coincide con La lista de operadores admitidos depende del tipo de campo en el aspecto, de la siguiente manera:
Solo se pueden buscar campos de nivel superior del aspecto. Por ejemplo, todas las consultas siguientes coinciden con entradas en las que el valor del campo
|
Operadores lógicos
Una consulta puede constar de varios predicados con operadores lógicos. Si no especificas un operador, el AND lógico está implícito. Por ejemplo, foo bar muestra entidades que coinciden con el predicado foo y el predicado bar.
Se admiten los valores lógicos AND y OR lógicos. Por ejemplo, foo OR bar.
Puedes anular un predicado con un prefijo - (guion) o NOT. Por ejemplo, -name:foo muestra entidades con nombres que no coinciden con el predicado foo.
Los operadores lógicos no distinguen mayúsculas de minúsculas. Por ejemplo, or y OR son aceptables.
Sintaxis abreviada
También está disponible una sintaxis de búsqueda abreviada, con | (barra vertical) para los operadores OR y , (coma) para los operadores AND.
Por ejemplo, para buscar entradas dentro de uno de muchos proyectos con el operador OR, puedes usar la siguiente sintaxis abreviada:
projectid:(id1|id2|id3|id4)
La misma búsqueda sin usar la sintaxis abreviada se ve de la siguiente manera:
projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4
Para buscar entradas con nombres de columna coincidentes, usa lo siguiente:
- Y:
column:(name1, name2, name3) - O:
column:(name1|name2|name3)
Esta sintaxis abreviada funciona para los predicados calificados, excepto para label.
¿Qué sigue?
- Aprende a buscar recursos de datos en Dataplex Catalog
- Obtén más información sobre Dataplex Catalog.
- Obtén información para enriquecer entradas con metadatos mediante aspectos.
- Obtén más información sobre cómo administrar entradas y transferir fuentes personalizadas.