DocumentaçãoCommerceGuia de configuração

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Gerenciar os indexadores

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

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor
WARNING
Todos os comandos da CLI do Magento devem ser executados pelo proprietário do sistema de arquivos.

Para exibir uma lista de todos os indexadores:

bin/magento indexer:info

A lista é exibida da seguinte maneira:

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
Os comerciantes do Adobe Commerce que usam o Live Search, o Serviço de Catálogo ou as Recomendações de Produto têm a opção de usar a indexação de preço com base em SaaS.

Exibir status do indexador

Use este comando para exibir o status de todos os indexadores ou indexadores específicos. Por exemplo, descubra se um indexador precisa ser reindexado.

Opções de comando:

bin/magento indexer:status [indexer]

Onde [indexer] é uma lista de indexadores separada por espaços. Omitir [indexer] para exibir o status de todos os indexadores.

Exemplo de resultado:

+----------------------------------+---------------------------+--------+-----------+---------------------+---------------------+
| 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

Use esse comando para reindexar todos os indexadores ou os indexadores selecionados apenas uma vez.

INFO
Esse comando reindexa apenas uma vez. Para manter os indexadores atualizados, você deve configurar um trabalho do cron.

Opções de comando:

bin/magento indexer:reindex [indexer]

Onde [indexer] é uma lista de indexadores separada por espaços. Omitir [indexer] para reindexar todos os indexadores.

Exemplo de resultado:

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
A reindexação de todos os indexadores pode levar muito tempo para lojas com um grande número de produtos, clientes, categorias e regras promocionais.

Reindexação no modo paralelo

Antes de executar indexadores no modo paralelo, você deve habilitar o suporte de Controle de Processo (pcntl) no PHP. Consulte Instalação na documentação do PHP.

Os indexadores têm escopo e são multisegmentados para oferecer suporte à reindexação no modo paralelo. Ela é paralelizada pela dimensão do indexador e é executada em várias threads, reduzindo o tempo de processamento.

Neste contexto, dimension é o escopo da reindexação, por exemplo, um website ou apenas um customer_group específico.

A paralelização de índice afeta apenas indexadores com escopo, o que significa que o Commerce divide os dados em várias tabelas usando o indexador como escopo, em vez de manter todos os dados em uma tabela.

Você pode executar os seguintes índices no modo paralelo:

  • Catalog Search Fulltext pode ser paralelizado por exibições de armazenamento.
  • Category Product pode ser paralelizado por exibições de armazenamento.
  • O Catalog Price pode ser comparado a sites e grupos de clientes.
  • Catalog Permissions pode ser paralelizado por grupos de clientes.
INFO
A paralelização para Texto completo da pesquisa no catálogo e Produto da categoria é ativada por padrão.

Para usar a paralelização, defina um dos modos de dimensões disponíveis para o indexador de preço do produto:

  • none (padrão)
  • website
  • customer_group
  • website_and_customer_group

Por exemplo, para definir o modo por site:

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

Para usar a paralelização para permissões de Catálogo, defina um dos modos de dimensões disponíveis para o indexador de Permissões de Catálogo:

  • none (padrão)
  • customer_group

Ou para verificar o modo atual:

bin/magento indexer:show-dimensions-mode

Para reindexar no modo paralelo, execute o comando reindex usando a variável de ambiente MAGE_INDEXER_THREADS_COUNT ou adicione uma variável de ambiente ao arquivo env.php. Essa variável define o número de threads para o processamento de reindexação.

Por exemplo, o comando a seguir executa o indexador Catalog Search Fulltext em três threads:

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

Redefinir indexador

Use este comando para invalidar o status de todos os indexadores ou indexadores específicos.

Opções de comando:

bin/magento indexer:reset [indexer]

Onde [indexer] é uma lista de indexadores separada por espaços. Omitir [indexer] para invalidar todos os indexadores.

Exemplo de resultado:

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.

Configurar indexadores

Use este comando para definir as seguintes opções do indexador:

  • Atualização ao salvar (realtime): os dados indexados são atualizados quando uma alteração é feita no Administrador. (Por exemplo, o índice de produtos da categoria é reindexado depois que os produtos são adicionados a uma categoria no Administrador.)
  • Atualizar por agendamento (schedule): os dados são indexados de acordo com o agendamento definido pelo seu trabalho cron.

Saiba mais sobre indexação.

Exibir a configuração atual

Para exibir a configuração do indexador atual:

bin/magento indexer:show-mode [indexer]

Onde [indexer] é uma lista de indexadores separada por espaços. Omitir [indexer] para mostrar os modos de todos os indexadores. Por exemplo, para mostrar o modo de todos os indexadores:

Exemplo de resultado:

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

Definir o modo do indexador

IMPORTANT
O comportamento do indexador Customer Grid foi alterado na versão 2.4.8:
  • Anterior a 2.4.8: o indexador Customer Grid só pode ser reindexado usando a opção Update on Save e não oferece suporte à opção Update by Schedule.
Use o seguinte comando para definir este indexador para atualizar ao salvar:
code language-none 
bash

bin/magento indexer:set-mode realtime customer_grid
  • 2.4.8 e posterior: o indexador Customer Grid oferece suporte aos modos Update on Save e Update by Schedule e o padrão é Update by Schedule.
Consulte Práticas recomendadas para a configuração de indexador no Manual de implementação.
INFO
Antes de alternar os modos do indexador, defina o site como manutenção e desabilite os trabalhos cron. Isso garante que você não tenha bloqueios de banco de dados.

Para especificar a configuração do indexador:

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

Onde:

  • realtime — Define os indexadores selecionados para atualização ao salvar.
  • schedule — Define os indexadores especificados para serem salvos de acordo com o cronograma cron.
  • indexer — É uma lista de indexadores separada por espaços. Omitir indexer para configurar todos os indexadores da mesma maneira.

Por exemplo, para alterar apenas os produtos da categoria e os indexadores de categorias de produto para atualizar no cronograma, insira:

bin/magento indexer:set-mode schedule catalog_category_product catalog_product_category

Exemplo de resultado:

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'

Os gatilhos de banco de dados relacionados a indexadores são adicionados quando o modo do indexador está definido como schedule e removidos quando o modo do indexador está definido como realtime. Se houver disparadores ausentes no banco de dados enquanto os indexadores estiverem definidos como schedule, altere os indexadores para realtime e altere-os de volta para schedule. Isso redefine os acionadores.

Definir status do indexador

O comando bin/magento indexer:set-status foi introduzido no Adobe Commerce 2.4.7. Ele permite que os administradores modifiquem o status operacional de um ou mais indexadores, otimizando o desempenho do sistema durante operações extensas, como importações, atualizações ou manutenção de dados.

Sintaxe de comando:

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

Onde:

  • invalid — Marca os indexadores como desatualizados, solicitando a reindexação na próxima execução do cron, a menos que estejam suspensos.
  • suspended — Interrompe temporariamente atualizações automáticas acionadas por cron para indexadores. Esse status se aplica aos modos de tempo real e agendamento, garantindo que as atualizações automáticas sejam pausadas durante operações intensivas.
  • valid — Indica que os dados do indexador estão atualizados, sem necessidade de reindexação.
  • indexer — É uma lista de indexadores separada por espaços. Omitir indexer para configurar todos os indexadores da mesma maneira.

Por exemplo, para suspender indexadores específicos, insira:

bin/magento indexer:set-status suspended catalog_category_product catalog_product_category

Exemplo de resultado:

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

Gerenciar status do indexador suspenso

Quando um indexador é definido com o status suspended, ele afeta principalmente a reindexação automática e as atualizações de exibição materializada. Esta é uma breve visão geral:

Reindexação ignorada: o sistema ignora a reindexação automática de suspended indexadores e indexadores que compartilham o mesmo shared_index. Essa abordagem preserva os recursos do sistema, evitando a reindexação de dados relacionados a processos suspensos.

Atualizações de Exibição Materializada Ignoradas: assim como a reindexação, o sistema também pausa as atualizações nas exibições materializadas relacionadas a indexadores suspended ou seus índices compartilhados. Essa pausa reduz ainda mais a carga do sistema durante os períodos de suspensão.

INFO
O comando indexer:reindex reindexa todos os indexadores, incluindo indexadores marcados como suspended, tornando-o útil para atualizações manuais quando os automáticos são pausados.
IMPORTANT
Alterar o status de um indexador de valid ou suspended para invalid requer cuidado. Essa ação pode levar à degradação do desempenho se houver dados não indexados acumulados.
É crucial garantir que todos os dados sejam indexados com precisão antes de atualizar manualmente o status para valid para manter o desempenho do sistema e a integridade dos dados.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c