En este documento, se describe la sintaxis de las búsquedas de Dataplex. Antes cuando leas este documento, es importante que entiendas 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 consulta de búsqueda de Dataplex Catalog en 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 columna anidada) en el esquema de un conjunto de datos recurso
- 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_bar
en el esquema de un recurso de datos - Columna anidada
foo_bar
en el esquema de un recurso de datos prod-foo-bar
del proyecto- Recurso de datos con una descripción general que contiene la palabra
foo
Predicados calificados
Puedes calificar un predicado si le agregas un prefijo con una clave que restrinja la hacer coincidir con una pieza específica de metadatos:
- Un signo igual (
=
) restringe la búsqueda a una coincidencia exacta. - Dos puntos (
:
) después de que la clave hace coincidir el predicado con una subcadena o con una token correcto dentro del valor de los resultados de la búsqueda.
La asignación de token divide el flujo de texto en una serie de tokens, con cada token que, por lo general, corresponde a una sola palabra.
Por ejemplo:
name:foo
selecciona entidades con nombres que contienen la subcadenafoo
, comofoo1
ybarfoo
.description:foo
selecciona entidades con el tokenfoo
en la descripción. comobar
yfoo
.location=foo
hace coincidir los recursos de datos en una ubicación especificada confoo
como el nombre de la ubicación.
Las claves de predicado type
, system
, location
y orgid
solo admiten la
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 coincidencias con x como substring del nombre de la columna (o anidada
nombre de columna) 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 |
Hace coincidir los recursos de datos de BigQuery que tienen una etiqueta (con algunos
value) y la clave de etiqueta tiene bar como substring. |
label=bar |
Hace 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 subcadena en el valor de una etiqueta con
clave bar adjunta a un recurso de datos de BigQuery. |
label=foo:bar |
Hace coincidir los recursos de datos de BigQuery en los que la clave es igual a
foo y el valor clave es igual a bar . |
label.foo=bar |
Hace coincidir los recursos de datos de BigQuery en los que la clave es igual a
foo y el valor clave es igual a bar . |
label.foo |
Hace coincidir los recursos de datos de BigQuery que tienen una etiqueta cuya
key 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 coincidan con
bar como una subcadena en el ID. |
parent:x |
Coincide con x como subcadena de la ruta jerárquica de un
recurso de datos. La ruta de acceso superior es un fully_qualified_name de
el 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 usando el
Nombre de la ubicación de BigQuery Omni.
Por ejemplo:
|
createtime |
Encuentra recursos de datos que se crearon antes o después de un determinado fecha u hora. Por ejemplo:
Formato de marca de tiempo: Todas las marcas de tiempo deben estar en GMT. no se admiten las zonas horarias. Parcial
marcas de tiempo, separadores de fecha de guion ( Por ejemplo:
|
updatetime |
Encuentra recursos de datos que se actualizaron en un determinado momento, antes o después de él fecha u hora. Por ejemplo:
Formato de marca de tiempo: Todas las marcas de tiempo deben estar en GMT. no se admiten las zonas horarias. Parcial
marcas de tiempo, 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 consulta sintaxis.
Calificador | Descripción |
---|---|
aspect:x |
Coincide con x como substring de la ruta de acceso completa al aspecto.
de un aspecto asociado a la entrada, en el formato
projectid.location.ASPECT_TYPE_ID |
aspect=x |
Coincide con x como la ruta completa al aspecto.
de un aspecto asociado 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 siguientes consultas 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
especifican 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, tanto or
como OR
son
aceptable.
Sintaxis abreviada
También está disponible una sintaxis de búsqueda abreviada, con |
(barra vertical) para
Operadores OR
y ,
(coma) para los operadores AND
.
Por ejemplo, para buscar entradas dentro de uno de muchos proyectos con el 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
predicados calificados, excepto label
.
¿Qué sigue?
- Obtén más información para 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.