Este documento describe la sintaxis de las búsquedas de Data Catalog. Antes de leer este documento, es importante que comprendas los conceptos de Data Catalog, como la entrada de datos, las etiquetas y las plantillas de etiquetas, y otros tipos de metadatos. Consulta ¿Qué es Data Catalog?
Para iniciar una búsqueda de Data Catalog En la consola de Google Cloud, ve a la página Búsqueda de Data Catalog Selecciona Data Catalog como el modo de búsqueda.
Búsqueda simple
En su forma más simple, una consulta de búsqueda de Data Catalog consta de un solo predicado. Este el predicado puede coincidir con varios fragmentos de metadatos:
- Subcadena de un nombre, nombre visible o descripción de un recurso de datos
- Tipo exacto de un recurso de datos
- Es una subcadena de un nombre de columna (o nombre de columna anidada) en el esquema de un recurso de datos.
- Una substring del ID del proyecto
- El valor de una etiqueta pública, el nombre de una plantilla de etiqueta pública nombre de campo en una plantilla de etiqueta pública adjunta a una entrada de datos.
- (Vista previa) Una cadena para una dirección de correo electrónico o el nombre de un administrador de datos
- (Vista previa) Una cadena de una descripción general
La búsqueda simple no admite campos de plantillas de etiquetas de tipo datetime
.
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 de
Foo Bar
- Recurso de datos con la descripción
This is the foo script.
- Recurso de datos con el tipo
foo
exacto - 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- Plantilla de etiqueta pública llamada
foo
, entradas de datos etiquetadas con la plantilla de etiquetafoo
, nombre visible de la plantilla de etiqueta defoo
, nombre del campo de la plantilla de etiqueta defoo
y valor del campo de etiqueta defoo
en una cadena, enum o texto enriquecido. - (Versión preliminar) Recurso de datos con un administrador de datos llamado
foo
. - (Vista previa) Recurso de datos con una descripción general que contiene la palabra
foo
.
Para obtener más información sobre los roles y permisos para ver etiquetas públicas y privadas, consulta Roles para ver etiquetas públicas y privadas.
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 coincidencia exacta.
Dos puntos (:
) después de que la clave hace coincidir el predicado con una substring o un token dentro
el valor en los resultados de la búsqueda.
La asignación de token divide el flujo de texto en una serie de tokens, con cada token corresponde a una sola palabra.
Por ejemplo:
name:foo
selecciona entidades con nombres que contienen la subcadenafoo
:foo1
ybarfoo
.description:foo
selecciona entidades con el tokenfoo
en la descripción:bar and foo
location=foo
hace coincidir todos los recursos de datos en una ubicación especificada confoo
como el nombre de la ubicación.
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 subcadena del nombre de la columna (o con el nombre de la columna anidada) en el esquema del recurso de datos.Puedes buscar una columna anidada por su ruta de acceso con el operador lógico AND. Por ejemplo, column:(foo bar) coincide con una columna anidada con la ruta de acceso foo.bar . |
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 una substring. |
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 conectada 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 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 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> |
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:
|
projectid:bar |
Coincide con los recursos de datos de los proyectos de Cloud que coinciden con bar como una substring en el ID. |
parent:x |
Coincide con x como substring de la ruta jerárquica de un recurso de datos de BigQuery. La ruta tiene el formato <project_id>.<dataset_name> .Por ejemplo, parent:foo.bar hace coincidir todas las tablas y vistas de un conjunto de datos con la ruta project-foo.bar-dataset . |
orgid=number |
Hace coincidir los recursos de datos dentro de una organización de Cloud con el valor de ID exacto de number . |
system=<system> |
Coincide con todos los recursos de datos de un sistema específico. Los sistemas incluyen:
|
location=<location> |
Hace coincidir todos los recursos de datos en una ubicación específica con un nombre exacto. Por ejemplo, location=us-central1 coincide con todos los recursos alojados en Iowa.Para obtener una lista completa de las ubicaciones compatibles, consulta Regiones de Data Catalog. |
cluster_location=<location> |
Hace coincidir todos los recursos de datos de Bigtable en una ubicación específica con un nombre exacto. Por ejemplo, cluster_location=us-central1 coincide con todos los recursos alojados en Iowa.Para obtener una lista completa de las ubicaciones compatibles, consulta Regiones de Bigtable. |
tag:x |
Hace coincidir los recursos de datos donde x coincide con cualquier subcadena en <tag_template_project_id >.<tag_template_id >.<tag_field_id > de una etiqueta privada o pública.Ejemplos:
|
tag:key<operator>val |
Primero, haz coincidir key con cualquier substring del ID del campo de la etiqueta, el ID de la plantilla de la etiqueta o el ID del proyecto de Google Cloud de una plantilla de etiqueta. Luego, hace coincidir val con el valor de etiqueta de key según el tipo de campo de etiqueta.Los conjuntos de <operator> dependientes del tipo permitidos para los valores de etiqueta son los siguientes:
|
createtime |
Encuentra los recursos de datos que se crearon antes, durante o después de una fecha u hora determinadas. Ejemplos:
|
updatetime |
Busca los recursos de datos que se actualizaron antes, durante o después de una fecha u hora determinadas. Ejemplos:
|
policytag:x |
Haz coincidir x como una substring del nombre visible de la etiqueta de política. Encuentra todos los recursos mediante la etiqueta de política de coincidencias o sus descendientes. |
policytagid=x |
Coincide con x como un ID de etiqueta de política o taxonomía. Encuentra todos los recursos mediante la etiqueta de política de coincidencias o sus descendientes. |
term:x |
Busca coincidencias con los recursos de datos conectados a un término del glosario empresarial en el que una subcadena de nombre, descripción o administrador de datos coincide con x . |
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 . |
Operadores lógicos
Una consulta puede estar compuesta por varias
predicados con operadores lógicos. Si no especificas un operador, la lógica
AND
está implícito. Por ejemplo, foo bar
muestra entidades que coinciden con ambas.
los predicados foo
y bar
.
Se admiten AND lógico y OR lógico, por ejemplo, foo OR bar
.
Puedes anular un predicado con un prefijo -
o NOT
. Por ejemplo, -name:foo
muestra
todas las entidades con nombres que no coinciden con el predicado foo
.
Sintaxis abreviada
También está disponible una sintaxis de búsqueda abreviada, con |
para los operadores OR
y
,
para los operadores AND
.
Por ejemplo, para buscar entradas dentro de uno de varios proyectos con el operador OR
, puedes usar la siguiente sintaxis:
projectid:(pid1|pid2|pid3|pid4)
En lugar de esta sintaxis:
projectid:pid1 OR projectid:pid2 OR projectid:pid3 OR projectid:pid4
Para buscar entradas con nombres de columnas coincidentes, haz lo siguiente:
- Y:
column:(name1, name2, name3)
- O:
column:(name1|name2|name3)
Esta sintaxis abreviada funciona para los dominios calificados
predicados ya mencionados, excepto tag
, term
y
policytag
, policytagid
y label
.