Sintaxis de búsqueda de Dataplex Catalog

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, aspectos, tipos de aspectos, grupos de entradas y tipos de entradas. Para obtener más información, consulta Descripción general de Dataplex Catalog.

Para iniciar una búsqueda de Dataplex Catalog en la consola deGoogle Cloud , ve a la página Búsqueda de Dataplex y selecciona Dataplex Catalog como modo de búsqueda.

Ir a Búsqueda

Para obtener más información, consulta Cómo buscar recursos en Dataplex Catalog.

En su forma más simple, una búsqueda de Dataplex Catalog consiste en un solo predicado. Un predicado de este tipo puede hacer coincidir varios metadatos:

  • Es una subcadena de un nombre, un nombre visible o una descripción de un recurso.
  • Es una subcadena del tipo de un recurso.
  • Es una subcadena de un nombre de columna (o nombre de columna anidada) en el esquema de un 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 con el nombre foo.bar
  • Recurso con el nombre visible Foo Bar
  • Recurso con la descripción This is the foo script
  • Recurso con el tipo exacto foo
  • Columna foo_bar en el esquema de un recurso
  • Columna anidada foo_bar en el esquema de un recurso
  • prod-foo-bar del proyecto
  • Recurso con una descripción general que contiene la palabra foo

Predicados calificados

Puedes calificar un predicado si le antepones una clave que restrinja la coincidencia a una pieza de metadatos específica:

  • Un signo igual (=) restringe la búsqueda a una concordancia exacta.
  • Un dos puntos (:) después de la clave hace que el predicado coincida con una subcadena o un token 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, cada uno correspondiente a una sola palabra.

Por ejemplo:

  • name:foo selecciona entidades con nombres que contienen la subcadena foo, como foo1 y barfoo.
  • description:foo selecciona entidades con el token foo en la descripción, como bar y foo.
  • location=foo busca recursos en una ubicación especificada con foo como 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 substring (:). 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.
displayname:x Haz coincidir x como una substring del nombre visible del recurso.
column:x Coincide con x como una substring del nombre de la columna (o el nombre de la columna anidada) en el esquema del recurso.
description:x Coincide con x como un token en la descripción del recurso.
label:bar Coincide con los recursos de BigQuery que tienen una etiqueta (con algún valor) y la clave de etiqueta tiene bar como una substring.
label=bar Coincide con los recursos 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 conectada a un recurso de BigQuery.
label=foo:bar Coincide con los recursos 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 BigQuery en los que la clave es igual a foo y el valor de la clave es igual a bar.
label.foo Coincide con los recursos de BigQuery que tienen una etiqueta cuya clave es igual a foo como una cadena.
type=TYPE Coincide con los recursos de un tipo de entrada específico o su alias de tipo.
projectid:bar Coincide con los recursos de los proyectos de Google Cloud que coinciden con bar como una subcadena en el ID.
parent:x Coincide con x como una substring de la ruta jerárquica de un recurso. La ruta de acceso superior es un fully_qualified_name del recurso superior.
orgid=number Coincide con los recursos dentro de una organización de Google Cloud con el valor de ID exacto de number.
system=SYSTEM Coincide con los recursos de un sistema especificado.
location=LOCATION

Coincide con los recursos en una ubicación especificada con un nombre exacto. Por ejemplo, location=us-central1 coincide con los recursos alojados en Iowa.

Los recursos de BigQuery Omni admiten este calificador mediante el nombre de la ubicación de BigQuery Omni. Por ejemplo, location=aws-us-east-1 coincide con los recursos de BigQuery Omni en el norte de Virginia.

createtime

Busca recursos que se crearon antes, durante o después de una fecha o hora determinadas.

Por ejemplo:

  • createtime:2019-01-01 coincide con los recursos creados el 1/1/2019.
  • createtime<2019-02 coincide con los recursos creados antes del 01/02/2019 a las 00:00:00.
  • createtime>2019-02 coincide con los recursos creados después del 1/2/2019 a las 00:00:00.

Formato de marca de tiempo: YYYY-MM-DDThh:mm:ss

Todas las marcas de tiempo deben estar en GMT. No se admiten zonas horarias. Se admiten marcas de tiempo parciales, separadores de fecha con guion (-) y separadores de fecha con barra (/).

Por ejemplo:

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

Busca recursos que se actualizaron antes, durante o después de una fecha o hora determinadas.

Por ejemplo:

  • updatetime:2019-01-01 coincide con los recursos actualizados el 1/1/2019.
  • updatetime<2019-02 coincide con los recursos actualizados antes del 01/02/2019 a las 00:00:00.
  • updatetime>2019-02 coincide con los recursos actualizados después del 1/2/2019 a las 00:00:00.

Formato de marca de tiempo: YYYY-MM-DDThh:mm:ss

Todas las marcas de tiempo deben estar en GMT. No se admiten zonas horarias. Se admiten marcas de tiempo parciales, separadores de fecha con guion (-) y separadores de fecha con barra (/).

Por ejemplo:

  • 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 Coincide con x como una substring de fully_qualified_name.
fully_qualified_name=x Coincide con x como fully_qualified_name.

Para buscar entradas según sus aspectos adjuntos, usa la siguiente sintaxis de consulta.

Calificador Descripción
aspect:x Coincide con x como una subcadena de la ruta de acceso completa al tipo de aspecto de un aspecto que se adjunta 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 que está adjunto a la entrada, en el formato projectid.location.ASPECT_TYPE_ID.
aspect:xOPERATORvalue

Busca valores de campos de aspecto. Coincide con x como una subcadena de la ruta de acceso completa al tipo de aspecto y el nombre de campo de un aspecto que está adjunto a la entrada, en el formato projectid.location.ASPECT_TYPE_ID.FIELD_NAME.

La lista de operadores compatibles depende del tipo de campo en el aspecto, como se indica a continuación:

  • Cadena: = (coincidencia exacta) y : (subcadena)
  • Todos los tipos de números: =, :, <, >, <=, >=, =>, =<
  • Enum: =
  • Fecha y hora: Igual que para los números, pero los valores que se comparan se tratan como fechas y horas en lugar de números.
  • Booleano: =

Solo se pueden buscar los campos de nivel superior del aspecto.

Por ejemplo, todas las siguientes consultas coinciden con las entradas en las que el valor del campo is-enrolled en el aspecto employee-info es true. También se muestran otras entradas que coinciden con la subcadena.

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

Operadores lógicos

Una consulta puede constar de varios predicados con operadores lógicos. Si no especificas un operador, AND lógico está implícito. Por ejemplo, foo bar muestra entidades que coinciden con el predicado foo y el bar.

Se admiten 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 hay una sintaxis de búsqueda abreviada disponible que usa | (barra vertical) para los operadores OR y , (coma) para los operadores AND.

Por ejemplo, para buscar entradas dentro de uno de varios 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 columnas 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?