DocumentaciónCommerceGuía de configuración

[Solo PaaS]{class="badge informative" title="Se aplica solo a proyectos de Adobe Commerce en la nube (infraestructura PaaS administrada por Adobe) y a proyectos locales."}

Administrar los indexadores

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Experimentado
  • Administrador
  • Desarrollador
WARNING
Todos los comandos CLI de Magento deben ser ejecutados por el propietario del sistema de archivos.

Para ver una lista de todos los indexadores:

bin/magento indexer:info

La lista se muestra de la siguiente manera:

cataloginventory_stock                   Stock
design_config_grid                       Design Config Grid
customer_grid                            Customer Grid
catalog_category_product                 Category Products
catalog_product_category                 Product Categories
catalogrule_rule                         Catalog Rule Product
catalog_product_attribute                Product EAV
inventory                                Inventory
catalog_product_price                    Product Price
catalogrule_product                      Catalog Product Rule
targetrule_product_rule                  Product/Target Rule
targetrule_rule_product                  Target Rule/Product
catalogsearch_fulltext                   Catalog Search
salesrule_rule                           Sales Rule
sales_order_data_exporter                Sales Order Feed
sales_order_status_data_exporter         Sales Order Statuses Feed
store_data_exporter                      Stores Feed
NOTE
Los comerciantes de Adobe Commerce que usan Live Search, Servicio de catálogo o Product Recommendations tienen la opción de usar la indexación de precios basada en SaaS.

Ver estado del indexador

Utilice este comando para ver el estado de todos los indexadores o de indexadores específicos. Por ejemplo, averigüe si es necesario reindexar un indexador.

Opciones de comando:

bin/magento indexer:status [indexer]

Donde [indexer] es una lista de indizadores separados por espacios. Omita [indexer] para ver el estado de todos los indizadores.

Resultado de muestra:

+----------------------------------+---------------------------+--------+-----------+---------------------+---------------------+
| ID                               | Title                     | Status | Update On | Schedule Status     | Schedule Updated    |
+----------------------------------+---------------------------+--------+-----------+---------------------+---------------------+
| catalogrule_product              | Catalog Product Rule      | Ready  | Schedule  | idle (0 in backlog) | 2025-07-11 08:00:52 |
| catalogrule_rule                 | Catalog Rule Product      | Ready  | Schedule  | idle (0 in backlog) | 2025-07-11 08:00:52 |
| catalogsearch_fulltext           | Catalog Search            | Ready  | Schedule  | idle (0 in backlog) | 2025-07-11 08:01:02 |
| catalog_category_product         | Category Products         | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:11:33 |
| customer_grid                    | Customer Grid             | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:11:31 |
| design_config_grid               | Design Config Grid        | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:11:31 |
| inventory                        | Inventory                 | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:11:36 |
| catalog_product_category         | Product Categories        | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:11:33 |
| catalog_product_attribute        | Product EAV               | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:11:36 |
| catalog_product_price            | Product Price             | Ready  | Schedule  | idle (0 in backlog) | 2025-07-11 08:00:54 |
| targetrule_product_rule          | Product/Target Rule       | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:11:39 |
| sales_order_data_exporter        | Sales Order Feed          | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:12:10 |
| sales_order_status_data_exporter | Sales Order Statuses Feed | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:12:10 |
| salesrule_rule                   | Sales Rule                | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:12:10 |
| cataloginventory_stock           | Stock                     | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:11:31 |
| store_data_exporter              | Stores Feed               | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:12:11 |
| targetrule_rule_product          | Target Rule/Product       | Ready  | Schedule  | idle (0 in backlog) | 2025-06-03 14:11:39 |
+----------------------------------+---------------------------+--------+-----------+---------------------+---------------------+

Reindexar

Utilice este comando para reindexar todos los indexadores o los seleccionados una sola vez.

INFO
Este comando reindexa solo una vez. Para mantener los indizadores actualizados, debe configurar un trabajo cron.

Opciones de comando:

bin/magento indexer:reindex [indexer]

Donde [indexer] es una lista de indizadores separados por espacios. Omita [indexer] para reindexar todos los indexadores.

Resultado de muestra:

Stock index has been rebuilt successfully in <time>
Design Config Grid index has been rebuilt successfully in <time>
Customer Grid index has been rebuilt successfully in <time>
Category Products index has been rebuilt successfully in <time>
Product Categories index has been rebuilt successfully in <time>
Catalog Rule Product index has been rebuilt successfully in <time>
Product EAV index has been rebuilt successfully in <time>
Inventory index has been rebuilt successfully in <time>
Product Price index has been rebuilt successfully in <time>
Catalog Product Rule index has been rebuilt successfully in <time>
Product/Target Rule index has been rebuilt successfully in <time>
Target Rule/Product index has been rebuilt successfully in <time>
Catalog Search index has been rebuilt successfully in <time>
Sales Rule index has been rebuilt successfully in <time>
Sales Order Feed index has been rebuilt successfully in <time>
Sales Order Statuses Feed index has been rebuilt successfully in <time>
Stores Feed index has been rebuilt successfully in <time>
INFO
La reindexación de todos los indexadores puede llevar mucho tiempo en tiendas con una gran cantidad de productos, clientes, categorías y reglas promocionales.

Reindexación en modo paralelo

Para poder ejecutar indizadores en modo paralelo, debe habilitar la compatibilidad con Control de procesos (pcntl) en PHP. Consulte Instalación en la documentación de PHP.

Los indizadores tienen ámbitos y subprocesos múltiples para admitir la reindexación en modo paralelo. Se paraleliza por la dimensión del indexador y se ejecuta en varios subprocesos, lo que reduce el tiempo de procesamiento.

En este contexto, dimension es el ámbito de la reindexación, por ejemplo website o simplemente un customer_group específico.

La paralelización de índices afecta únicamente a los indexadores con ámbito, lo que significa que Commerce divide los datos en varias tablas utilizando el indexador como ámbito en lugar de mantener todos los datos en una tabla.

Puede ejecutar los siguientes índices en modo paralelo:

  • Catalog Search Fulltext se puede comparar con las vistas de tiendas.
  • Category Product se puede comparar con las vistas de tiendas.
  • Catalog Price puede estar en paralelo con los grupos de sitios web y clientes.
  • Catalog Permissions puede estar en paralelo en los grupos de clientes.
INFO
La paralelización para la búsqueda en el catálogo de texto completo y categoría de producto está habilitada de forma predeterminada.

Para utilizar la paralelización, establezca uno de los modos de dimensión disponibles para el indexador de precios de producto:

  • none (predeterminado)
  • website
  • customer_group
  • website_and_customer_group

Por ejemplo, para establecer el modo por sitio web:

bin/magento indexer:set-dimensions-mode catalog_product_price website

Para utilizar la paralelización para los permisos de Catálogo, establezca uno de los modos de dimensiones disponibles para el indexador Permisos de catálogo:

  • none (predeterminado)
  • customer_group

O para comprobar el modo actual:

bin/magento indexer:show-dimensions-mode

Para reindexar en modo paralelo, ejecute el comando reindex usando la variable de entorno MAGE_INDEXER_THREADS_COUNT o agregue una variable de entorno al archivo env.php. Esta variable establece el número de subprocesos para el procesamiento de reindexación.

Por ejemplo, el comando siguiente ejecuta el indizador Catalog Search Fulltext en tres subprocesos:

MAGE_INDEXER_THREADS_COUNT=3 php -f bin/magento indexer:reindex catalogsearch_fulltext

Restablecer indizador

Utilice este comando para invalidar el estado de todos los indexadores o de indexadores específicos.

Opciones de comando:

bin/magento indexer:reset [indexer]

Donde [indexer] es una lista de indizadores separados por espacios. Omita [indexer] para invalidar todos los indizadores.

Resultado de muestra:

Stock indexer has been invalidated.
Design Config Grid indexer has been invalidated.
Customer Grid indexer has been invalidated.
Category Products indexer has been invalidated.
Product Categories indexer has been invalidated.
Catalog Rule Product indexer has been invalidated.
Product EAV indexer has been invalidated.
Inventory indexer has been invalidated.
Product Price indexer has been invalidated.
Catalog Product Rule indexer has been invalidated.
Product/Target Rule indexer has been invalidated.
Target Rule/Product indexer has been invalidated.
Catalog Search indexer has been invalidated.
Sales Rule indexer has been invalidated.
Sales Order Feed indexer has been invalidated.
Sales Order Statuses Feed indexer has been invalidated.
Stores Feed indexer has been invalidated.

Configuración de indexadores

Utilice este comando para establecer las siguientes opciones del indizador:

  • Actualización al guardar (realtime): los datos indizados se actualizan cuando se realiza un cambio en el administrador. (Por ejemplo, el índice de productos de la categoría se reindexará después de agregar los productos a una categoría en el Administrador).
  • Actualización por programación (schedule): los datos se indizan según la programación establecida por el trabajo cron.

Más información sobre la indexación.

Mostrar la configuración actual

Para ver la configuración actual del indizador:

bin/magento indexer:show-mode [indexer]

Donde [indexer] es una lista de indizadores separados por espacios. Omita [indexer] para mostrar todos los modos de los indizadores. Por ejemplo, para mostrar el modo de todos los indexadores:

Resultado de muestra:

Stock:                                             Update by Schedule
Design Config Grid:                                Update by Schedule
Customer Grid:                                     Update by Schedule
Category Products:                                 Update by Schedule
Product Categories:                                Update by Schedule
Catalog Rule Product:                              Update by Schedule
Product EAV:                                       Update by Schedule
Inventory:                                         Update by Schedule
Product Price:                                     Update by Schedule
Catalog Product Rule:                              Update by Schedule
Product/Target Rule:                               Update by Schedule
Target Rule/Product:                               Update by Schedule
Catalog Search:                                    Update by Schedule
Sales Rule:                                        Update by Schedule
Sales Order Feed:                                  Update by Schedule
Sales Order Statuses Feed:                         Update by Schedule
Stores Feed:                                       Update by Schedule

Establecer el modo del indizador

IMPORTANT
El comportamiento del indizador Customer Grid cambió en 2.4.8:
  • Anterior a 2.4.8: el indizador Customer Grid solo se puede reindexar usando la opción Update on Save y no admite la opción Update by Schedule.
Utilice el siguiente comando para configurar este indexador para que se actualice al guardar:
code language-none 
bash

bin/magento indexer:set-mode realtime customer_grid
  • 2.4.8 y versiones posteriores: el indizador Customer Grid admite los modos Update on Save y Update by Schedule, y el valor predeterminado es Update by Schedule.
Consulte las Prácticas recomendadas para la configuración del indizador en el Manual de implementación.
INFO
Antes de cambiar los modos del indizador, establezca su sitio web en el modo mantenimiento y deshabilite los trabajos cron. Esto garantiza que no tenga bloqueos de base de datos.

Para especificar la configuración del indexador:

bin/magento indexer:set-mode {realtime|schedule} [indexer]

Donde:

  • realtime: define los indexadores seleccionados para que se actualicen al guardar.
  • schedule: establece los indizadores especificados para que se guarden según la programación de cron.
  • indexer: es una lista de indizadores separados por espacios. Omita indexer para configurar todos los indizadores de la misma manera.

Por ejemplo, para cambiar únicamente los indexadores de productos de categoría y categorías de productos para actualizar según lo programado, introduzca:

bin/magento indexer:set-mode schedule catalog_category_product catalog_product_category

Resultado de muestra:

Index mode for Indexer Category Products was changed from 'Update on Save' to 'Update by Schedule'
Index mode for Indexer Product Categories was changed from 'Update on Save' to 'Update by Schedule'

Los déclencheur de base de datos relacionados con los indizadores se agregan cuando el modo de indizador se establece en schedule y se quitan cuando el modo de indizador se establece en realtime. Si faltan los déclencheur en la base de datos mientras los indizadores están establecidos en schedule, cambie los indizadores a realtime y vuelva a cambiarlos a schedule. Esto restablece los déclencheur.

Establecer estado del indizador

El comando bin/magento indexer:set-status se introdujo en Adobe Commerce 2.4.7. Permite a los administradores modificar el estado operativo de uno o más indexadores, optimizando el rendimiento del sistema durante operaciones extensas como importaciones de datos, actualizaciones o mantenimiento.

Sintaxis del comando:

bin/magento indexer:set-status {invalid|suspended|valid} [indexer]

Donde:

  • invalid: marca los indizadores como desactualizados y solicita la reindexación en la siguiente ejecución de cron a menos que se suspendan.
  • suspended: detiene temporalmente las actualizaciones automáticas activadas por cron para los indexadores. Este estado se aplica tanto a los modos de tiempo real como a los de programación, lo que garantiza que las actualizaciones automáticas se detengan durante las operaciones intensivas.
  • valid: indica que los datos del indizador están actualizados y no es necesario volver a indexarlos.
  • indexer: es una lista de indizadores separados por espacios. Omita indexer para configurar todos los indizadores de la misma manera.

Por ejemplo, para suspender indexadores específicos, introduzca:

bin/magento indexer:set-status suspended catalog_category_product catalog_product_category

Resultado de muestra:

Index status for Indexer 'Category Products' was changed from 'valid' to 'suspended'.
Index status for Indexer 'Product Categories' was changed from 'valid' to 'suspended'.

Administración del estado del indexador suspendido

Cuando un indizador se establece en un estado suspended, afecta principalmente a la reindexación automática y a las actualizaciones de la vista materializada. A continuación se muestra una breve descripción general:

Se ha omitido la reindexación: el sistema omite la reindexación automática para los indexadores suspended y cualquier indexador que comparta el mismo shared_index. Este método ahorra recursos del sistema al evitar la reindexación de datos relacionados con procesos suspendidos.

Actualizaciones de vistas materializadas omitidas: de forma similar a la reindexación, el sistema también pone en pausa las actualizaciones de vistas materializadas relacionadas con indizadores suspended o sus índices compartidos. Esta pausa reduce aún más la carga del sistema durante los períodos de suspensión.

INFO
El comando indexer:reindex vuelve a indizar todos los indizadores, incluidos los marcados como suspended, por lo que resulta útil para las actualizaciones manuales cuando se pausan las automáticas.
IMPORTANT
Cambiar el estado de un indizador a valid de suspended o invalid requiere precaución. Esta acción puede provocar una degradación del rendimiento si se acumulan datos sin indexar.
Es crucial asegurarse de que todos los datos estén indexados con precisión antes de actualizar manualmente el estado a valid para mantener el rendimiento del sistema y la integridad de los datos.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c