Usa índices de IA

Puedes usar la función AI.SEARCH para consultar tus datos mientras BigQuery controla automáticamente la selección de columnas, la optimización de índices y el mantenimiento continuo.

En este documento, se explica cómo crear, supervisar y borrar índices de IA, y cómo consultar tus datos indexados.

Roles y permisos

Para obtener los permisos que necesitas para usar los índices de IA, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

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

Crea un índice de IA

Puedes crear un índice de IA en una tabla estándar de BigQuery con la sentencia de lenguaje de definición de datos (DDL) CREATE AI INDEX. Puedes especificar las columnas que deseas indexar o hacer que BigQuery seleccione automáticamente las columnas candidatas con la opción AUTO COLUMNS.

Limitaciones para crear índices de IA

Cuando creas un índice de IA, se aplican las siguientes limitaciones:

  • Solo se admiten columnas STRING de nivel superior que no se repitan. No se admiten ARRAY<STRING>, STRUCT, JSON, ObjectRef, campos anidados, columnas que no sean STRING ni pseudocolumnas.
  • Puedes indexar hasta 50 columnas en un solo índice de IA.
  • Solo puedes crear un índice de IA en una tabla estándar de BigQuery. No se admiten vistas, vistas materializadas, tablas externas, tablas de BigLake, tablas de Apache Iceberg ni instantáneas de tablas.
  • No puedes crear índices de IA en conjuntos de datos que tengan réplicas entre regiones.
  • Cuando ejecutas CREATE AI INDEX, la tabla base puede tener como máximo 1,000,000 de filas para proyectos a pedido o hasta 100,000,000 de filas si el proyecto que contiene la tabla tiene una asignación de reserva de BACKGROUND.
  • AUTO COLUMNS selecciona columnas cuando se ejecuta la sentencia CREATE AI INDEX. Si agregas columnas a la tabla más adelante, no se indexarán automáticamente. Para incluir columnas nuevas, quita el índice de IA y vuelve a crearlo.
  • Cada tabla admite, como máximo, un índice de IA. Una tabla con un índice de IA tampoco puede tener un índice vectorial ni una columna de embeddings generada automáticamente.

Para obtener una lista completa de las limitaciones, consulta Limitaciones de los índices de IA.

Crea un índice de IA con AUTO COLUMNS

Cuando creas un índice de IA con AUTO COLUMNS, BigQuery analiza automáticamente el esquema de la tabla y selecciona hasta 50 columnas aptas. Para crear un índice de IA con AUTO COLUMNS, usa la declaración DDL CREATE AI INDEX:

  1. Ve a BigQuery Studio en la consola de Cloud de Confiance .

    Ir a BigQuery Studio

  2. En el editor de consultas, ejecuta la siguiente instrucción de SQL:

    CREATE AI INDEX INDEX_NAME
    ON DATASET_NAME.TABLE_NAME(AUTO COLUMNS);

    Reemplaza lo siguiente:

    • INDEX_NAME: Es el nombre del índice de IA que crearás. Debido a que el índice siempre se crea en el mismo proyecto y conjunto de datos que la tabla base, no es necesario que especifiques el proyecto o el conjunto de datos en el nombre del índice. El nombre del índice debe ser único entre todos los índices de la tabla.
    • DATASET_NAME: es el nombre del conjunto de datos que contiene la tabla.
    • TABLE_NAME: Es el nombre de la tabla estándar que se indexará.

En el siguiente ejemplo, se crea un índice de IA con AUTO COLUMNS en mydataset.products:

CREATE AI INDEX products_ai_index
ON mydataset.products(AUTO COLUMNS);

Crea un índice de IA en columnas específicas

Puedes crear un índice de IA en una sola columna o en un subconjunto específico de columnas. Por ejemplo, cuando tu tabla tiene más de 50 columnas aptas o cuando deseas excluir columnas sensibles o con mucho ruido, como IDs opacos, UUID, hashes o registros sin procesar. Si especificas varias columnas, coloca las más informativas, como una columna de título o nombre, primero en la lista de columnas.

En el siguiente ejemplo, se crea un índice de IA solo en las columnas name y description de mydataset.products:

CREATE AI INDEX products_ai_index
ON mydataset.products(name, description);

En el siguiente ejemplo, se crea un índice de IA solo en la columna description de mydataset.products:

CREATE AI INDEX products_ai_index
ON mydataset.products(description);

Busca en una tabla con un índice de IA

Puedes consultar una tabla que tenga un índice de IA con la función AI.SEARCH. Cuando una tabla tiene un índice de IA, solo se requieren dos argumentos: base_table o base_table_query, y query_value.

Busca en todas las columnas indexadas

Para buscar en todas las columnas que abarca el índice de IA, omite el argumento column_to_search y pasa la tabla base y la cadena de consulta.

En el siguiente ejemplo, se buscan todas las columnas de mydataset.products que están cubiertas por el índice de IA:

SELECT
  base.id,
  base.name,
  base.description,
  distance
FROM
  AI.SEARCH(
    TABLE mydataset.products,
    'shoes that keep your feet dry in the rain',
    top_k => 5)
ORDER BY distance;

Supervisa el estado de los índices de IA

Puedes supervisar el estado, la cobertura y las columnas indexadas de tus índices de IA consultando las siguientes vistas de INFORMATION_SCHEMA:

  • INFORMATION_SCHEMA.AI_INDEXES: contiene metadatos sobre cada índice de IA en un conjunto de datos.
  • INFORMATION_SCHEMA.AI_INDEX_COLUMNS: Enumera las columnas que abarca cada índice de IA en un conjunto de datos, lo que te permite verificar qué columnas se seleccionaron cuando se usó AUTO COLUMNS.
  • INFORMATION_SCHEMA.JOBS: contiene información sobre los trabajos en segundo plano, incluidos los que se usan para crear y mantener índices de IA.

Ejemplo de índice de IA

En la siguiente consulta, se muestra la cobertura y el tamaño de almacenamiento de todos los índices de IA en my_project.my_dataset:

SELECT
  table_name,
  index_name,
  creation_time,
  coverage_percentage,
  unindexed_row_count,
  total_logical_bytes
FROM
  my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEXES;

El resultado es similar al siguiente:

+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| table_name | index_name        | creation_time       | coverage_percentage | unindexed_row_count       | total_logical_bytes   |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| products   | products_ai_index | 2026-10-01 18:02:11 | 100                 | 0                         | 25344                 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+

Ejemplo de columnas de índice de IA

En la siguiente consulta, se enumeran las columnas indexadas para los índices de IA en my_project.my_dataset:

SELECT
  table_name,
  index_name,
  index_column_name
FROM
  my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEX_COLUMNS;

El resultado es similar al siguiente:

+------------+-------------------+-------------------+
| table_name | index_name        | index_column_name |
+------------+-------------------+-------------------+
| products   | products_ai_index | name              |
| products   | products_ai_index | description       |
| products   | products_ai_index | category          |
| products   | products_ai_index | review            |
+------------+-------------------+-------------------+

Ejemplo de seguimiento de los costos de los trabajos en segundo plano

Para hacer un seguimiento de los valores total_slot_ms y total_bytes_billed de los trabajos de procesamiento de datos de índices de IA en segundo plano en una tabla, consulta la vista INFORMATION_SCHEMA.JOBS para los trabajos con un prefijo job_id de gc_:

SELECT
  job_id,
  creation_time,
  reservation_id,
  total_slot_ms,
  total_bytes_processed,
  total_bytes_billed
FROM
  `region-REGION`.INFORMATION_SCHEMA.JOBS j
WHERE
  EXISTS (
    SELECT 1
    FROM UNNEST(j.referenced_tables) t
    WHERE
      j.project_id = 'PROJECT_ID'
      AND t.dataset_id = 'DATASET_ID'
      AND t.table_id = 'TABLE'
  )
  AND STARTS_WITH(job_id, 'gc_')
ORDER BY
  j.creation_time DESC;

Reemplaza lo siguiente:

  • REGION: Es la región del conjunto de datos que contiene tu tabla, por ejemplo, us.
  • PROJECT_ID: el ID del proyecto que contiene tu tabla.
  • DATASET_ID: Es el nombre del conjunto de datos que contiene tu tabla.
  • TABLE: Es el nombre de la tabla que contiene el índice de IA.

Borra un índice de IA

Cuando borras una tabla indexada, también se borra su índice de IA. Para borrar un índice de IA sin borrar la tabla, usa la declaración DDL DROP AI INDEX:

DROP AI INDEX IF EXISTS INDEX_NAME ON DATASET_NAME.TABLE_NAME;

Reemplaza lo siguiente:

  • INDEX_NAME: Es el nombre del índice de IA que borrarás.
  • DATASET_NAME: Es el nombre del conjunto de datos que contiene la tabla.
  • TABLE_NAME: Es el nombre de la tabla que contiene el índice de IA.

¿Qué sigue?