Sintaxis de búsqueda de Knowledge Catalog

Nota: La búsqueda en Knowledge Catalog admite la concordancia semántica y de palabras clave. También admite el modo de búsqueda solo por palabras clave para la retrocompatibilidad. Para obtener información sobre la búsqueda solo por palabras clave, sus filtros y cómo usarla, consulta Búsqueda solo por palabras clave.

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

• Búsqueda simple: Encuentra recursos de datos con un solo término de búsqueda.
• Búsqueda de texto libre: Encuentra recursos de datos con frases o palabras clave en lenguaje natural.
• Predicados calificados: Refina tu búsqueda con campos de metadatos específicos, como nombre, ubicación, sistema o tipo.
• Búsqueda de aspectos: Busca entradas según los metadatos técnicos y empresariales adjuntos.
• Operadores lógicos: Combinar varios criterios de búsqueda con los operadores AND, OR o NOT para crear consultas complejas Si comprendes esta sintaxis, puedes encontrar rápidamente los datos que necesitas.

Predicados calificados

Usa un predicado calificado para acotar los resultados de la búsqueda. Para ello, indícale explícitamente a la búsqueda que evalúe un campo de metadatos específico, como el nombre, el tipo o el sistema de un activo.

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

• Un signo igual (=) para restringir la búsqueda a una coincidencia exacta
• Un signo de dos puntos (:) después de la clave para hacer coincidir el predicado con una subcadena o un token dentro del valor en los resultados de la búsqueda.

La asignación de token divide el flujo del texto en una serie de tokens, cada uno correspondiente a una sola palabra.

Por ejemplo:

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

Modificadores admitidos

La búsqueda en Knowledge Catalog admite los siguientes calificadores:

Calificador	Descripción
name:x	Coincide con x como una subcadena del ID del recurso o el nombre visible del recurso.
displayname:x	Coincide con x como una substring del nombre visible del recurso.
column:x	Coincide con x como una subcadena 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. Por ejemplo: description:"products" muestra todos los recursos que tienen el token products en la descripción. Por ejemplo, "lista de productos en el inventario". description:"prod" no muestra los recursos que tienen el token products en la descripción. En cambio, muestra todos los recursos que tienen el token prod en la descripción. Por ejemplo, “entorno de producción”.
labels:bar	Coincide con los recursos que tienen una etiqueta (con algún valor) y la clave de etiqueta tiene bar como una subcadena.
labels=bar	Coincide con los recursos que tienen una etiqueta (con algún valor) y la clave de etiqueta es igual a bar como una cadena.
labels.bar:x	Coincide con x como una subcadena en el valor de una etiqueta con la clave bar adjunta a un recurso.
labels.foo=bar	Coincide con los recursos en los que la clave es igual a foo y el valor de la clave es igual a bar.
type=TYPE	Coincide con los recursos de un tipo de entrada específico o su alias de tipo. Requiere el calificador =.
projectid:bar	Coincide con los recursos de los proyectos de Google Cloud que coinciden conbarcomo una subcadena en el ID.
parent:x	Coincide con x como una subcadena de la ruta jerárquica de un recurso.
system=SYSTEM	Coincide con los recursos de un sistema especificado. Requiere el calificador =.
location=LOCATION	Coincide con los recursos en una ubicación especificada con un nombre exacto. Requiere el calificador =. Por ejemplo, location=us-central1 coincide con los recursos alojados en Iowa. Los recursos de BigQuery Omni admiten este calificador con 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, una marca de tiempo o un período relativo en días determinados. Para conocer los formatos y operadores compatibles, consulta Filtros de tiempo.
updatetime	Busca los recursos que se actualizaron antes, durante o después de una fecha, una marca de tiempo o un período relativo en días determinados. Para conocer los formatos y operadores compatibles, consulta Filtros de tiempo.

Calificadores de concordancia exacta

Las claves de predicado type, system, location y la búsqueda de aspectos (excepto has) solo admiten el calificador de concordancia exacta (=), no el calificador de subcadena (:).

Usa la siguiente sintaxis de concordancia exacta para estos predicados:

Clave del predicado	Sintaxis correcta	Sintaxis incorrecta
type	type=table (o type=view, type=dataset)	type:table o type:tab
system	system=bigquery (o system=spanner)	system:bigquery o system:big
location	location=us-central1 (o location=europe-west1)	location:us-central1 o location:us

Calificadores de subcadena

Los predicados como name, displayname, column, projectid y parent admiten la coincidencia de subcadenas con el calificador de dos puntos (:):

• name:transactions coincide con los recursos cuyo ID o nombre visible contiene transactions. Por ejemplo, daily_transactions_raw y transactions_v2.
• column:customer_id coincide con los recursos que tienen un nombre de columna que contiene customer_id.
• projectid:prod coincide con los recursos de los proyectos cuyo ID contiene prod. Por ejemplo, finance-prod-2026.

Filtros de tiempo

Puedes filtrar los recursos por hora de creación (createtime) o por hora de última actualización (updatetime).

Operadores y formatos admitidos

• Operadores admitidos: :, =, <, >, <=, >=, =>, =<
• Días relativos (-Nd): Filtra por una cantidad relativa de días en el pasado (por ejemplo, -30d, -7d, -1d).
• Fechas del calendario (YYYY-MM-DD o YYYY/MM/DD): Filtra por una fecha específica en GMT/UTC.
• Marcas de tiempo completas (YYYY-MM-DDTHH:MM:SS o YYYY-MM-DDTHH:MM:SSZ): Filtra por una marca de tiempo precisa en GMT/UTC. También se admiten marcas de tiempo parciales, como YYYY-MM-DDTHH:MM o YYYY-MM-DDTHH.

Sintaxis del filtro de tiempo

En la siguiente tabla, se explica la sintaxis del filtro de tiempo:

Categoría de formato	Sintaxis válida	Sintaxis no válida	Descripción
Unidades de tiempo relativas	createtime>-30d (últimos 30 días) createtime<=-7d (hace 7 días o antes) updatetime=-1d (día anterior) updatetime>=-90d	createtime>-24h createtime>-60m createtime>-2w createtime>30d	Solo se admiten unidades de día negativas (-Nd) para el tiempo relativo. No se admiten unidades más cortas (horas h, minutos m) ni más largas (semanas w, meses m). Los desplazamientos positivos sin un signo menos inicial (-) no son válidos.
Fechas del calendario	createtime:2025-01-15 createtime>2025-01-01 createtime<=2025-06-30 createtime:2025/01/15 createtime:2025-01 createtime:2025	createtime:15-01-2025 createtime:Jan-15-2025 createtime:01/15/2025	Las fechas deben seguir el formato YYYY-MM-DD o YYYY/MM/DD. Los formatos con un orden de componentes no estándar (como DD-MM-YYYY o MM/DD/YYYY) o nombres de meses no son válidos.
Marcas de tiempo y zonas horarias	createtime:2025-01-15T05:30:00 createtime>2025-01-15T05:30:00Z createtime:2025-01-15T05:30	createtime:2025-01-15T05:30:00-08:00 createtime:2025-01-15T05:30:00 EST createtime:2025-01-15T05:30:00+05:30	Todas las marcas de tiempo se evalúan en GMT/UTC. No se admiten las abreviaturas de zonas horarias (como EST o PST) ni las compensaciones de zonas horarias que no sean GMT (como -08:00 o +05:30).
Intervalos del día	createtime>=2025-01-15T09:00:00 createtime<=2025-01-15T17:00:00	createtime:09:00:00..17:00:00 createtime:09:00-17:00	No se admite la sintaxis de rangos horarios. En su lugar, usa comparaciones separadas de límite inferior y superior con cadenas de fecha y hora completas.
Fechas en lenguaje natural	createtime=-1d createtime>-30d	createtime:yesterday createtime:"last week" createtime:today	No se admiten las frases de fecha en lenguaje natural dentro de los calificadores createtime o updatetime. Usa la sintaxis de días relativos (-1d, -7d) o fechas explícitas.

Filtros de etiquetas

Usa el predicado labels para filtrar recursos por etiquetas adjuntas. Puedes filtrar por clave de etiqueta, valor de etiqueta o ambos:

Patrón de consulta	Ejemplo	Descripción
labels=KEY	labels=environment	Coincide con los recursos que tienen una etiqueta con la clave exacta environment, independientemente de su valor.
labels:KEY_SUBSTRING	labels:tier	Coincide con los recursos que tienen una clave de etiqueta que contiene tier como una subcadena (como service_tier o storage_tier).
labels.KEY=VALUE	labels.env=prod	Coincide con los recursos en los que la clave de etiqueta es env y su valor es exactamente prod.
labels.KEY:VALUE_SUBSTRING	labels.owner:analytics	Coincide con los recursos que tienen la clave de etiqueta owner, en la que el valor contiene analytics como una subcadena (como analytics-team o data-analytics).
Varias etiquetas (Y)	labels.env=prod labels.data_tier=tier1	Coincide con los recursos que tienen adjuntas las etiquetas env=prod y data_tier=tier1.
Combinado con el sistema y el tipo	system=bigquery type=table labels.env=prod labels.confidentiality=high	Coincide con las tablas de BigQuery etiquetadas con env=prod y confidentiality=high.

Búsqueda por aspecto

Puedes usar la sintaxis de consulta para buscar entradas según los aspectos adjuntos.

La coincidencia de subcadena intenta coincidir con una cantidad limitada de aspectos. Si no encuentras la entrada con un fragmento de la ruta de acceso, usa la ruta de acceso completa para acotar la búsqueda y aumentar la recuperación.

Calificador	Descripción
aspect:x o has: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 o has=x	Coincide con x como la ruta de acceso completa al tipo de aspecto de un aspecto adjunto a la entrada, en el formato projectid.location.ASPECT_TYPE_ID
x OPERATOR value	Busca valores de campos de aspectos. Coincide con x como una subcadena del nombre de ruta de acceso completo al tipo de aspecto y al nombre del campo de un aspecto adjunto a la entrada, en los siguientes formatos: Sintaxis para los tipos de aspectos del sistema: ASPECT_TYPE_ID.FIELD_NAME dataplex-types.ASPECT_TYPE_ID.FIELD_NAME dataplex-types.LOCATION.ASPECT_TYPE_ID.FIELD_NAME Por ejemplo, las siguientes búsquedas coinciden con las entradas en las que el valor del campo type en el aspecto bigquery-dataset es default: bigquery-dataset.type=default dataplex-types.bigquery-dataset.type=default dataplex-types.global.bigquery-dataset.type=default Sintaxis para tipos de aspectos personalizados: Si el aspecto se crea en la región global, se mostrará el siguiente mensaje: PROJECT_ID.ASPECT_TYPE_ID.FIELD_NAME Si el aspecto se crea en una región específica: PROJECT_ID.REGION.ASPECT_TYPE_ID.FIELD_NAME Por ejemplo, las siguientes búsquedas coinciden con las entradas en las que el valor del campo is-enrolled en el aspecto employee-info es true. example-project.us-central1.employee-info.is-enrolled=true example-project.employee-info.is-enrolled=true La lista de operadores admitidos depende del tipo de campo en el aspecto, como se indica a continuación: Cadena: = (concordancia exacta) 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.

Operadores lógicos

Una búsqueda puede combinar varios predicados con operadores lógicos. Nota: Los operadores lógicos AND, OR y NOT distinguen entre mayúsculas y minúsculas, y deben estar en letras mayúsculas.

Operador AND

Si separas varios términos de búsqueda o predicados con un espacio, se implica el operador lógico AND, lo que significa que no tienes que escribirlo de forma explícita.

En los siguientes ejemplos, se muestra cómo construir consultas con el operador AND.

• Cómo buscar tablas de BigQuery

  system=bigquery type=table
  

• Buscar recursos en el proyecto banking-prod con una columna llamada customer_id

  projectid:banking-prod column:customer_id
  

• Si es necesario, puedes usar el operador AND explícito:

  system=bigquery AND type=table AND location=us-central1
  

Operador OR

Usa el operador OR para que coincida con cualquiera de varias condiciones. Cuando combines OR con otros criterios, usa paréntesis ( ) para agrupar las expresiones y definir la prioridad.

En los siguientes ejemplos, se muestra cómo construir consultas con el operador OR.

• Cómo buscar tablas y vistas de BigQuery

  system=bigquery (type=table OR type=view)
  

• Buscar tablas en varios sistemas

  (system=bigquery OR system=spanner) type=table
  

• Buscar entradas en conjuntos de datos de marketing o finanzas

  system=bigquery (parent:marketing_analytics OR parent:finance_analytics)
  

Operador NOT

Puedes negar un predicado anteponiéndole la letra NOT en mayúscula o un - (guion).

En los siguientes ejemplos, se muestra cómo construir consultas con el operador NOT.

• Encuentra todas las tablas, excepto las de un proyecto de zona de pruebas

  • Usa el operador NOT

  type=table NOT projectid:sandbox-project
  

  • Usar guion

  type=table -projectid:sandbox-project
  

• Busca todos los recursos de BigQuery que no contengan test en su nombre.

  system=bigquery -name:test
  

Sintaxis abreviada

Si quieres usar la sintaxis abreviada, usa | (barra vertical) para los operadores OR y , (coma) para los operadores AND dentro de los paréntesis. Esta sintaxis abreviada funciona para los predicados calificados.

• Cómo buscar en varios IDs de proyectos

  • Usa el operador OR:

  projectid:(finance-prod|sales-prod|analytics-prod)
  

  • Usa paréntesis:

  projectid:finance-prod OR projectid:sales-prod OR projectid:analytics-prod
  

• Buscar entradas que coincidan con varios nombres de columnas (AND)

  column:(customer_id,transaction_date,amount)
  

• Buscar entradas que coincidan con cualquiera de varios nombres de columna (OR)

  column:(customer_id|user_id|client_id)
  

Política de comodines

La sintaxis de búsqueda de Knowledge Catalog no admite comodines, como * o ?, en cadenas de búsqueda ni predicados.

Si incluyes un asterisco (*) o un signo de interrogación (?) en una búsqueda, se tratará como un carácter literal en lugar de un comodín de coincidencia de patrones.

Por ejemplo, para buscar tablas cuyos nombres terminen con _masked, haz lo siguiente:

• Admitida: name:_masked : Usa el calificador de coincidencia de subcadena : para encontrar todos los recursos cuyo nombre contenga _masked, como customer_records_masked o transactions_masked.
• No admitido: name:*_masked: El * se trata como un carácter literal, no como un comodín de patrón.

Paréntesis

Los paréntesis en las búsquedas tienen funciones técnicas específicas. Si abusas de los paréntesis o los aplicas a búsquedas en lenguaje natural, puedes confundir al analizador de búsqueda y reducir la calidad de los resultados.

Lenguaje natural simple

Cuando hagas una pregunta comercial, pasa la búsqueda en texto sin formato. No lo encierres entre paréntesis. Por ejemplo, escribe lo siguiente:

Find customer orders containing email addresses

Sintaxis abreviada del predicado

Los paréntesis son muy eficaces cuando se usan con claves de predicado para enumerar varias condiciones de OR y AND en un formato compacto.

• Agrupa las claves de predicado con OR (|).

  • Buscar entradas que residan en cualquiera de los proyectos enumerados (|)

    projectid:(finance-prod|finance-test|analytics-raw)
    

  • Buscar entradas que residan en cualquiera de los proyectos enumerados (OR)

  projectid:finance-prod OR projectid:finance-test OR projectid:finance-raw
  

• Agrupa las claves de predicado con AND (,).

  • Buscar entradas que contengan todas las columnas especificadas con (,)

  column:(customer_id, order_date, total_amount)
  

  • Buscar entradas que contengan todas las columnas especificadas con (AND)

  column:customer_id AND column:order_date AND column:total_amount
  

Búsqueda híbrida

Puedes combinar una búsqueda en lenguaje natural con filtros compactos.

Por ejemplo, para encontrar tablas que especifiquen usuarios activos por mes, pero restringir la búsqueda a los proyectos especificados, usa la siguiente consulta:

monthly active users type=table projectid:(data-warehouse|analytical-tier)

Prácticas recomendadas para usar paréntesis

• No encierres toda la pregunta entre paréntesis, ya que el motor semántico podría tratar los paréntesis como caracteres literales, lo que generaría resultados de baja relevancia.

  • Incorrecto: (Show me datasets about US population by state)
  • Correcto: Show me datasets about US population by state

• Evita combinar árboles booleanos complejos y anidados con paréntesis dentro del campo de lenguaje natural. La Búsqueda está optimizada para la intención del lenguaje natural. Si se complica demasiado la consulta con paréntesis y bloques de lógica explícitos, se confunde el analizador.

  • Incorrecto: (revenue data) AND system=BIGQUERY AND projectid:(data-warehouse | analytical-tier)
  • Correcto: revenue data system=bigquery projectid:(data-warehouse|analytical-tier)

• No agregues espacios de forma arbitraria, a menos que formen parte del valor.

  • Incorrecto: column:( email | id )
  • Correcto: column:(email|id).

¿Qué sigue?

• Obtén más información para buscar recursos en Knowledge Catalog
• Obtén más información sobre la administración de metadatos en Knowledge Catalog.
• Obtén más información para enriquecer entradas y vínculos de entrada con metadatos usando aspectos.
• Obtén más información para administrar entradas y transferir fuentes personalizadas.