Buscar recursos

Usa la búsqueda de Knowledge Catalog en BigQuery para encontrar recursos deGoogle Cloud , como conjuntos de datos y tablas, con consultas en lenguaje natural. La búsqueda con lenguaje cotidiano en los metadatos que creas te permite descubrir los recursos de datos que necesitas sin depender de coincidencias exactas de palabras clave.

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 recursos deGoogle Cloud , completa las tareas de esta sección.

Roles obligatorios

Para buscar recursos, necesitas al menos uno de los siguientes roles de IAM de Knowledge Catalog en el proyecto que se usa para la búsqueda: administrador de Dataplex Catalog, editor de Dataplex Catalog o visualizador de Dataplex 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 Permiso de búsqueda de este documento.

Por ejemplo, para buscar conjuntos de datos, tablas, vistas y modelos de BigQuery, necesitas los permisos correspondientes 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 necesarios:

  • 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 de Google Cloud nuevos con BigQuery. Si la API de Dataplex no está habilitada en tu proyecto, consulta Habilita Knowledge Catalog.

  1. En la consola de Google Cloud , 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. A continuación, se muestran 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. Están disponibles los siguientes filtros:

    • Alcance: Busca en toda la organización (opción predeterminada), el proyecto actual o solo los recursos destacados. Para obtener más información, consulta la sección Permiso de búsqueda de este documento.
    • Sistemas: Es el servicio de Google Cloud al que pertenece el recurso, como BigQuery. El sistema de Knowledge Catalog contiene grupos de entradas.
    • Proyectos: Son los proyectos en los que se buscará.
    • Tipo: Es 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: Son las ubicaciones en las que se realizará la búsqueda.
    • Selecciona 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: Son 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 los 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. O bien, 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, en los resultados de la búsqueda, haz clic en el nombre del recurso.

    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 la búsqueda importantes que quieres marcar como favoritos, puedes destacarlos. Haz clic en Destacar para el recurso. Puedes ver los recursos destacados en BigQuery Studio.
    • Para cerrar el resumen de recursos en el panel dividido, haz clic en Cerrar.

Como alternativa, puedes buscar recursos con Gemini Cloud Assist.

Filtros

Los filtros te permiten acotar 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 de BigQuery y el tipo de recurso dataset, los resultados de la búsqueda incluyen conjuntos de datos de BigQuery, pero no 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 incluirán conjuntos de datos y tablas.

Alcance de la búsqueda

En el caso de los proyectos que pertenecen a una organización de Google Cloud , 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 a los metadatos de BigQuery de un recurso, este 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 se mostrará como se espera en los resultados de la búsqueda.

Los resultados de la búsqueda solo incluyen los 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 usas la consola de Google Cloud , este es el proyecto que se selecciona en la consola.

¿Qué sigue?