Buscar recursos

Usa la búsqueda de Knowledge Catalog para encontrar Google Cloud recursos en BigQuery, como conjuntos de datos y tablas de BigQuery.

La búsqueda de Knowledge Catalog admite consultas de búsqueda en lenguaje natural (también conocidas como consultas de búsqueda semántica), que te permiten buscar recursos con lenguaje cotidiano.

Al igual que la búsqueda de palabras clave, la búsqueda en lenguaje natural enfatiza el descubrimiento de recursos mediante el análisis de los metadatos asociados con los recursos de tu organización. La búsqueda tiene en cuenta una amplia gama de metadatos que describen los recursos, incluidos los que creas.

La búsqueda en lenguaje natural se centra en mejorar la recuperación en lugar de la precisión.

Para obtener más información sobre cómo buscar datos de tablas en BigQuery, consulta Introducción a la búsqueda en BigQuery.

Regístrate para la versión preliminar

Para registrarte en la versión preliminar, tu representante de cuenta de Google debe enviar una solicitud completando el formulario de registro. Después de enviar el formulario, el equipo de BigQuery se comunicará contigo para indicarte los próximos pasos.

Antes de comenzar

Antes de usar la búsqueda en lenguaje natural en BigQuery para buscar Google Cloud recursos, completa las tareas de esta sección.

Roles obligatorios

Para buscar recursos, necesitas tener al menos uno de los siguientes roles de IAM para Knowledge Catalog en el proyecto que se usa en la búsqueda: administrador de Knowledge Catalog, editor de Knowledge Catalog o visualizador de Knowledge Catalog. Los permisos en los resultados de la búsqueda se verifican de forma independiente del proyecto seleccionado.

Los resultados de la búsqueda en BigQuery se limitan según tus permisos de IAM sobre los recursos subyacentes. Para buscar un recurso en BigQuery, debes tener permisos para acceder al recurso correspondiente. Para obtener más información, consulta la sección Alcance de la búsqueda de este documento.

Por ejemplo, para buscar conjuntos de datos, tablas, vistas y modelos de BigQuery, necesitas los permisos respectivos para acceder a esos recursos. Para obtener más información, consulta Permisos de BigQuery. En la siguiente lista, se describen los permisos mínimos requeridos:

  • Para buscar una tabla, necesitas el permiso bigquery.tables.get para esa tabla.
  • Para buscar un conjunto de datos, necesitas el permiso bigquery.datasets.get para ese conjunto de datos.

El rol de visualizador de metadatos de BigQuery (roles/bigquery.metadataViewer) incluye los permisos bigquery.tables.get y bigquery.datasets.get, y te permite buscar cualquier recurso de BigQuery.

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Habilita la API

Para usar la búsqueda, asegúrate de haber habilitado la API de Dataplex. La API de Dataplex está habilitada de forma predeterminada para todos los proyectos nuevos Google Cloud con BigQuery. Si la API de Dataplex no está habilitada en tu proyecto, consulta Habilita Knowledge Catalog.

  1. En la Google Cloud consola, ve a la página Búsqueda de BigQuery.

    Ir a Búsqueda

  2. En el campo de búsqueda, ingresa tu consulta en lenguaje natural y, luego, presiona Intro. Las siguientes son algunas consultas de ejemplo:

    • Show me the datasets that contain taxi information
    • Find data on vaccine distribution across different countries
    • Get tables with historical temperature data for major world cities
    • Search for hurricane tracking and storm activity datasets
    • Population data by country

  3. Para filtrar la búsqueda, haz clic en Filtros. Los siguientes filtros están disponibles:

    • Alcance: Busca en la organización (predeterminado), en el proyecto actual, o solo en los recursos destacados. Para obtener más información, consulta la sección Alcance de la búsqueda de este documento.
    • Sistemas: El Google Cloud servicio al que pertenece el recurso, como BigQuery. El sistema Knowledge Catalog contiene grupos de entradas.
    • Proyectos: Los proyectos en los que se realizará la búsqueda.
    • Tipo: El tipo de recurso, como la conexión de BigQuery, el bucket de Cloud Storage o la base de datos. Según el tipo de recurso, también puedes filtrar por subtipo, como el tipo de conexión o el dialecto de SQL.
    • Seleccionar ubicaciones: Las ubicaciones en las que se realizará la búsqueda.
    • Seleccionar conjuntos de datos: Esto limita los resultados de la búsqueda a los recursos de BigQuery que pertenecen a los conjuntos de datos de BigQuery seleccionados. En el campo Escribe para filtrar, ingresa el nombre del conjunto de datos.
    • Anotaciones: Los tipos de aspectos de Knowledge Catalog que están asociados con el recurso que buscas. Para filtrar por valores de aspecto, haz clic en Filtrar por valores de anotación y, luego, selecciona los valores.

    Para quitar un filtro, haz clic en Borrar junto al filtro específico que deseas quitar. Para quitar todos los filtros, haz clic en Borrar filtros.

    Para obtener más información sobre cómo se evalúan los filtros, consulta la sección Filtros de este documento.

  4. Opcional: Para ver más información sobre un recurso, haz clic en el nombre del recurso en los resultados de la búsqueda.

    Se abrirá un resumen del recurso en un panel dividido. Sigue uno de estos pasos:

    • Para abrir el recurso en el servicio al que pertenece, haz clic en Abrir en PRODUCT_NAME para el recurso. Por ejemplo, para abrir un conjunto de datos de BigQuery en BigQuery Studio, haz clic en Abrir en Studio. Las opciones disponibles dependen del recurso.
    • Para ver los metadatos de Knowledge Catalog asociados con un recurso, haz clic en Abrir en Knowledge Catalog para el recurso.
    • Si tienes resultados de búsqueda importantes que deseas marcar, puedes destacarlos. Haz clic en Destacar para el recurso. Puedes ver los recursos destacados en BigQuery Studio.
    • Para cerrar el resumen del recurso en el panel dividido, haz clic en Cerrar.

Como alternativa, puedes buscar recursos con Gemini Cloud Assist.

Filtros

Los filtros te permiten reducir los resultados de la búsqueda.

Cuando proporcionas filtros en varias secciones, estos se evalúan con el operador lógico AND. Los resultados de la búsqueda contienen recursos que coinciden con al menos una condición de cada sección seleccionada. Por ejemplo, si seleccionas el sistema BigQuery y el tipo de recurso dataset, los resultados de la búsqueda incluyen conjuntos de datos de BigQuery, pero no conjuntos de datos de Gemini Enterprise Agent Platform.

Si seleccionas varios filtros en una sola sección, estos se evalúan con el operador lógico OR. Por ejemplo, si seleccionas el tipo de recurso dataset y el tipo de recurso table, los resultados de la búsqueda incluyen conjuntos de datos y tablas.

Alcance de la búsqueda

En el caso de los proyectos que pertenecen a una Google Cloud organización, la búsqueda opera dentro del alcance de esa organización.

Los resultados de la búsqueda respetan los permisos que tienes sobre los recursos. Por ejemplo, si tienes acceso de lectura de metadatos de BigQuery a un recurso, ese recurso aparecerá en los resultados de la búsqueda. Si tienes acceso a una tabla de BigQuery, pero no al conjunto de datos que la contiene, la tabla seguirá apareciendo como se espera en los resultados de la búsqueda.

Los resultados de la búsqueda incluyen solo aquellos recursos que pertenecen al mismo perímetro de Controles del servicio de VPC que el proyecto en el que se realiza la búsqueda. Cuando se usa la Google Cloud consola, este es el proyecto seleccionado en la consola.

¿Qué sigue?