Sintaxis de búsqueda de Data Catalog

Este documento describe la sintaxis de las búsquedas de Data Catalog.

Predicados simples

En su forma más simple, una consulta de búsqueda comprende un solo predicado. Por ejemplo, el predicado foo coincide con las siguientes entidades de Data Catalog:

  • Una entidad con una descripción This is the foo script.
  • Una entidad con el nombre foo.bar.

Predicados calificados

Puede calificar un predicado si lo prefijas con una clave que restrinja la coincidencia a una pieza específica de metadatos. Por ejemplo, name:foo seleccionará entidades cuyos nombres coincidan con el predicado foo.

Data 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 Coincide con x como una substring del nombre de la columna en el esquema del recurso de datos.
description:x Coincide con x como un token en la descripción del recurso de datos.
labels: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 una substring.
labels.bar:x Coincide con x como un token en el valor de una etiqueta bar conectada a un recurso de datos de BigQuery.
type=<type> Coincide con los elementos de datos de un tipo o subtipo de un objeto específico. Los subtipos se pueden agregar con el formato <type>.<sub-type>.
Los tipos y subtipos incluyen lo siguiente:
  • type=table coincide con todas las tablas.
  • type=dataset coincide con todos los conjuntos de datos de BigQuery.
  • type=table.view o type=view coincide con todas las vistas.
  • type=tag_template coincide con todas las plantillas de etiquetas.
  • type=entry_group coincide con todos los grupos de entradas.
  • type=data_stream coincide con todos los temas de Pub/Sub.
projectid:bar Coincide con los recursos de datos de los proyectos de Cloud que coinciden con bar como una substring en el ID.
orgid:bar Coincide con los recursos de datos de las organizaciones de Cloud que coinciden con bar como una substring en el ID.
system=<system> Coincide con todos los recursos de datos de un sistema específico.
Los sistemas incluyen:
  • system=bigquery coincide con todos los recursos de datos de BigQuery.
  • system=cloud_pubsub coincide con todos los recursos de datos de Pub/Sub.
  • system=data_catalog coincide con todos los recursos de datos creados en Data Catalog.
tag:x Coincide con los recursos de datos en los que x coincide con cualquier substring en <tag_template_project_id>.<tag_template_id>.<tag_field_id>.
Ejemplos:
  • tag:data_owner coincide con los recursos de datos que tienen la etiqueta data_owner.
  • tag:data_gov_template coincide con los recursos de datos etiquetados con la plantilla de etiqueta data_gov_template.
  • tag:mycloudproject.data_gov_template coincide con los recursos de datos etiquetados con la plantilla data_gov_template en el proyecto mycloudproject.
tag:key:val Coincide con key en las substrings de la ID del campo de etiqueta, la ID de la plantilla de etiqueta o la ID del proyecto de Cloud de una plantilla de etiqueta. Coincide con val como token en el valor de etiqueta de key cuando el campo de etiqueta es de tipo string. Coincide con val exactamente con el valor de etiqueta de key cuando el valor del campo de etiqueta es de tipo boolean, enum o double.
Operadores permitidos:
  • string: ":"
  • booleano y enumerado: "="
  • doble: "=", "<", ">", "<=", ">="
  • marca de tiempo: ":", "=", "<", ">", "<=", ">="
Ejemplos
  • string: tag:data_owner:@mail.com coincide con los recursos de datos que tienen valores @mail.com.
  • booleano: tag:data_gov_template.hasPII=true coincide con etiquetas booleanas hasPII en data_gov_template que son true.
  • enumerado: tag:certification_level_1=HIGHEST
  • doble: tag:datascore=9 hace coincidir los recursos de datos etiquetas dobles datascore que tienen el valor 9.
  • marca de tiempo: tag:expiredDate:2019-01-01 coincide con los recursos de datos que tienen una etiqueta expiredDate de 2019-01-01.
  • marca de tiempo: tag:expiredDate<2019-02 coincide con los recursos de datos que tienen una etiqueta expiredDate anterior a 2019-02-01T00:00:00.
createtime Encuentra los recursos de datos que se crearon antes, durante o después de una fecha u hora determinadas.
Ejemplos:
  • createtime:2019-01-01 coincide con los recursos de datos creados en 2019-01-01.
  • createtime<2019-02 coincide con los recursos de datos creados antes del 2019-02-01T00:00:00.
  • createtime>2019-02 coincide con los elementos de datos creados después de 2019-02-01T00:00:00.
updatetime Busca los recursos de datos que se actualizaron antes, durante o después de una fecha u hora determinadas.
Ejemplos:
  • updatetime:2019-01-01 coincide con los recursos de datos actualizados en 2019-01-01.
  • updatetime<2019-02 coincide con los recursos de datos actualizados antes del 2019-02-01T00:00:00.
  • updatetime>2019-02 coincide con los recursos de datos actualizados después del 2019-02-01T00:00:00.

Operadores lógicos

Una consulta puede estar compuesta por varios predicados con operadores lógicos. Si no especifica un operador, se implica AND lógico. Por ejemplo, foo bar devuelve entidades que coinciden con el predicado foo y el predicado bar.

Se admiten AND lógico y OR lógico, por ejemplo, foo OR bar.

Puede negar un predicado con un prefijo - o NOT. Por ejemplo, -name:foo devuelve todas las entidades con nombres que no coinciden con el predicado foo.