Sintaxis de búsqueda de Dataplex Universal Catalog

En este documento se describe la sintaxis de la búsqueda por palabras clave de Dataplex Universal Catalog y de las búsquedas con IA en lenguaje natural.

Dataplex Universal Catalog te permite descubrir, catalogar de forma centralizada, gestionar y comprender los datos de tu organización. Para encontrar de forma eficiente recursos de datos específicos en tu catálogo de datos, puedes usar consultas de búsqueda avanzadas. La sintaxis de las consultas de búsqueda incluye lo siguiente:

  • Búsqueda simple: cómo encontrar recursos de datos con un solo término de búsqueda.
  • Predicados cualificados: cómo acotar la búsqueda usando campos de metadatos específicos, como el nombre, la ubicación o la descripción.
  • Búsqueda por aspectos: cómo buscar entradas en función de los metadatos técnicos y empresariales que tengan asociados.
  • Operadores lógicos: cómo combinar varios criterios de búsqueda con los operadores Y y O para crear consultas complejas. Si conoces esta sintaxis, podrás localizar rápidamente los datos que necesites.

Antes de empezar

Conocer las entradas, los aspectos, los tipos de aspectos, los grupos de entradas y los tipos de entradas de Dataplex Universal Catalog. Consulta Información sobre la gestión de metadatos en Dataplex Universal Catalog.

Dataplex Universal Catalog ofrece dos modos de búsqueda: búsqueda por palabras clave y búsqueda en lenguaje natural.

  • La búsqueda por palabras clave te permite encontrar recursos mediante palabras clave, filtros y una sintaxis definida.
  • La búsqueda en lenguaje natural aprovecha la IA para comprender las consultas semánticas. Te permite encontrar recursos de IA usando un lenguaje cotidiano, lo que elimina la necesidad de usar una sintaxis compleja.

En este documento se explica la sintaxis de la búsqueda por palabras clave y por lenguaje natural. IA Para lanzar una consulta de búsqueda de Dataplex Universal Catalog en la Google Cloud consola, ve a la página Búsqueda de Dataplex Universal Catalog y selecciona Dataplex Universal Catalog como plataforma de búsqueda.

Ir a Buscar

Para obtener más información, consulta Buscar recursos en Dataplex Universal Catalog.

Puedes encontrar recursos introduciendo un término o una frase sin ninguna sintaxis específica. Universal Catalog de Dataplex realiza una búsqueda amplia comparando tu consulta con varios campos de metadatos, entre los que se incluyen los siguientes:

  • Nombre, nombre visible o descripción de un recurso
  • Tipo de recurso
  • ID del proyecto
  • Descripción general
  • Nombre de la columna (o de la columna anidada) del esquema de un recurso
  • Descripción de la columna
  • Nombre completo
  • Contactos
  • Aspectos

Buscar con sintaxis de consulta

Para hacer búsquedas más precisas, puedes crear una consulta con una sintaxis específica, incluidos calificadores, operadores lógicos y búsquedas de aspectos.

Predicados cualificados

Puedes calificar un predicado añadiéndole un prefijo con una clave que restrinja la coincidencia a un metadato específico:

  • El signo igual (=) restringe la búsqueda a una coincidencia exacta.
  • Los dos puntos (:) después de la clave hacen que el predicado coincida con una subcadena o un token del valor de los resultados de búsqueda.

La tokenización divide el flujo de texto en una serie de tokens, donde cada token suele corresponder a una sola palabra.

Por ejemplo:

  • name:foo selecciona los recursos cuyos nombres contienen la subcadena foo, como foo1 y barfoo.
  • description:foo selecciona los recursos con el token foo en la descripción, como bar y foo.
  • location=foo coincide con los recursos de una ubicación especificada con foo como nombre de la ubicación.

El comportamiento de estos calificadores puede variar ligeramente entre los modos de búsqueda, tal como se detalla en las siguientes secciones.

Las claves de predicado type, system, location y orgid solo admiten el calificador de coincidencia exacta (=), no el calificador de subcadena (:). Por ejemplo, type=foo o orgid=number.

Dataplex Universal Catalog admite los siguientes calificadores para la búsqueda por palabras clave:

Calificador Descripción
name:x Coincide con x como subcadena del ID de recurso.
displayname:x Coincide con x como subcadena del nombre visible del recurso.
column:x Coincide con x como subcadena del nombre de la columna (o del nombre de la columna anidada) en el esquema del recurso.
description:x Coincide con x como 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 la etiqueta tiene bar como subcadena.
label=bar Coincide con los recursos de BigQuery que tienen una etiqueta (con algún valor) y la clave de la etiqueta es igual a bar como cadena.
label:bar:x Coincide con x como subcadena en el valor de una etiqueta con la clave bar adjunta 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 cadena.
type=TYPE Coincide con los recursos de un tipo de entrada específico o su alias de tipo.
projectid:bar Busca recursos en Google Cloud proyectos que coincidan con bar como subcadena en el ID.
parent:x Coincide con x como subcadena de la ruta jerárquica de un recurso. La ruta principal es un fully_qualified_name del recurso principal.
orgid=number Coincide con los recursos de una organización Google Cloud con el valor de ID exacto de number.
system=SYSTEM Busca recursos de un sistema especificado.
location=LOCATION

Busca 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 ubicación de BigQuery Omni. Por ejemplo, location=aws-us-east-1 coincide con los recursos de BigQuery Omni de Virginia del Norte.

createtime

Busca recursos que se hayan creado en una fecha u hora concretas, o antes o después de ellas.

Por ejemplo:

  • createtime:2019-01-01 coincide con los recursos creados el 1 de enero del 2019.
  • createtime<2019-02 coincide con los recursos creados antes del 2019-02-01T00:00:00.
  • createtime>2019-02 coincide con los recursos creados después del 2019-02-01T00:00:00.

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

Todas las marcas de tiempo deben estar en GMT. No se admiten las zonas horarias. Se admiten marcas de tiempo parciales, guiones (-) y barras (/) como separadores de fechas.

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 hayan actualizado en una fecha u hora concretas, antes o después de ellas.

Por ejemplo:

  • updatetime:2019-01-01 coincide con los recursos actualizados el 1 de enero del 2019.
  • updatetime<2019-02 coincide con los recursos actualizados antes del 2019-02-01T00:00:00.
  • updatetime>2019-02 coincide con los recursos actualizados después del 2019-02-01T00:00:00.

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

Todas las marcas de tiempo deben estar en GMT. No se admiten las zonas horarias. Se admiten marcas de tiempo parciales, guiones (-) y barras (/) como separadores de fechas.

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 Busca