Gerenciamento de índice

O Adobe Commerce e o Magento Open Source reindexam automaticamente sempre que um ou mais itens são alterados. As ações que acionam a reindexação incluem alterações de preço, criação de regras de preço de catálogo ou carrinho de compras, adição de novas categorias e assim por diante. Para otimizar o desempenho, o Commerce acumula dados em tabelas especiais usando indexadores. À medida que os dados são alterados, as tabelas indexadas devem ser atualizadas ou reindexadas. O Commerce reindexa como um processo em segundo plano e seu armazenamento permanece acessível durante os processos.

A reindexação de dados acelera o processamento e reduz o tempo de espera do cliente. Por exemplo, se você alterar o preço de um item de US$ 4,99 para US$ 3,99, o Commerce reindexa os dados para mostrar a alteração de preço na loja. Sem a indexação, a Commerce teria que calcular o preço de cada produto em tempo real; lidando com regras de preço de carrinho de compras, preços de pacotes, descontos, preços de camada e assim por diante. O carregamento do preço de um produto pode demorar mais do que o cliente está disposto a esperar.

Os indexadores podem ser definidos para atualizar ao salvar ou de acordo com a programação. Todos os índices podem usar qualquer uma das opções, exceto a Grade do Cliente, que oferece suporte apenas ao salvar. Ao indexar ao salvar, o Commerce inicia uma reindexação nas ações salvas. A página Gerenciamento de índice conclui a atualização e libera o cache, com a mensagem de reindexação aparecendo dentro de um ou dois minutos. Ao reindexar em uma programação, uma reindexação é executada de acordo com uma programação como um trabalho cron. Uma mensagem do sistema será exibida se um trabalho do cron não estiver disponível para atualizar indexadores que se tornarem inválidos. Seu armazenamento permanece acessível durante os processos de reindexação.

NOTE
Os comerciantes do Adobe Commerce que usam o Live Search, o Serviço de Catálogo ou o Product Recommendations têm a opção de usar um indexador de preços baseado em SaaS.

Quando uma reindexação é necessária, uma notificação é exibida na parte superior da página. O índice e a mensagem são apagados com base no modo de reindexação e nas possíveis ações que você realizar. Para obter informações mais detalhadas sobre indexação, consulte Como o aplicativo implementa a indexação no Guia do Desenvolvedor do PHP.

Gerenciamento de índice - ações

  • O Gerenciamento de índice tem uma apresentação ligeiramente diferente para catálogos de produtos simples.
  • Para evitar problemas quando vários usuários Administradores atualizarem objetos que acionam a reindexação automática, é recomendável configurar todos os indexadores para serem executados de acordo com o agendamento como trabalhos cron. Caso contrário, sempre que um objeto for salvo, qualquer objeto com interdependências poderá causar um deadlock. Os sintomas de um impasse incluem alto uso de CPU e erros MySQL. Como prática recomendada, é recomendável usar a indexação programada.
  • Adobe Commerce (somente Adobe Commerce) Por padrão, as ações de administrador, como reindexação, são registradas pelo sistema e podem ser exibidas no Relatório de Logs de Ação. O log de ações pode ser configurado no Log de Ações do Administrador nas configurações administrativas avançadas do seu armazenamento.

Práticas recomendadas para reindexação

A reindexação e o armazenamento em cache têm diferentes finalidades no Commerce. Os índices rastreiam as informações do banco de dados para melhorar o desempenho da pesquisa, recuperar dados mais rapidamente para vitrines e muito mais. Os caches salvam dados, imagens, formatos e outros itens carregados para melhorar o desempenho do carregamento e do acesso à loja.

  • Normalmente, você deseja reindexar ao atualizar dados no Commerce.
  • Se você tiver uma grande loja ou várias lojas, convém definir indexadores como categoria e produtos para trabalhos cron agendados devido à possibilidade de loop de reindexação. Talvez você queira definir o reindexação em um cronograma durante horas que não sejam de pico.
  • Ao reindexar, não é necessário executar também um cache de liberação.
  • Para novas instalações do Commerce, você deve liberar o cache e reindexar.
  • A limpeza de caches e reindexação não limpa o cache do navegador da Web do computador. Limpe o cache do navegador após concluir as atualizações na loja.

Alterar o modo de índice

IMPORTANT
Para armazenamentos que usam o Adobe Commerce B2B e definiram o Elasticsearch como o indexador de texto completo (catalogsearch_fulltext): o índice de texto completo deve ser executado novamente após qualquer alteração de permissões em massa ou quando o indexador "permissões" estiver no modo "Agendado".
  1. Na barra lateral Admin, vá para System > Tools>Index Management.

  2. Marque a caixa de seleção para cada indexador que você deseja alterar.

  3. Defina Actions como um dos seguintes:

    • Update on Save
    • Update by Schedule
    • Invalidate index
    note important
    IMPORTANT
    A Grade de Clientes só pode ser reindexada usando Update on Save. Este índice não oferece suporte a Update by Schedule.
  4. Clique em Submit para aplicar a alteração a cada indexador selecionado.

    Colunas de Gerenciamento de Índice

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto
    Coluna Descrição
    Indexer O nome do indexador.
    Description Uma descrição do indexador.
    Mode Indica o modo de atualização atual de cada indexador. Opções:
    Update on Save- O índice é definido para atualização sempre que uma alteração de entidade é salva. Essas entidades incluem produtos, categorias e clientes. Quando a ação de salvamento for concluída, uma série de etapas começará a capturar as alterações e a atualizar o índice. A página Gerenciamento de índice atualiza e libera a mensagem de reindexação em um ou dois minutos.
    Update on Schedule - O índice está definido para ser atualizado de acordo com a agenda, de acordo com um trabalho do cron. O trabalho cron inclui o intervalo de agendamento para reindexação, gravando atualizações no índice quando executado.
    Schedule Status Exibe as atualizações de status do agendamento.
    Status Exibe um dos seguintes:
    Ready— O índice está atualizado.
    Suspended - Reindexação em pausa.
    Processing- Reindexação em execução no momento.
    Reindex Required - Foi feita uma alteração que requer reindexação, mas os indexadores não podem ser atualizados automaticamente. Verifique se cron está disponível e configurado corretamente.
    Updated Indica a data e a hora em que um índice foi atualizado pela última vez.

Reindexar usando a linha de comando

O Commerce fornece opções adicionais de reindexação usando a linha de comando. Para obter detalhes completos e opções de comando, consulte Reindexar{:target="blank"} no Guia de Configuração.

Eventos de gatilho de índice

Reindexação de acionadores

Tipo de índice
Reindexação de evento
Product Prices
Adicionar grupo de clientes
Alterar definições de configuração
Flat catalog product data
Adicionar repositório
Adicionar grupo de repositório
Adicionar, editar ou excluir atributo (para pesquisa e filtragem)
Flat catalog category data
Adicionar repositório
Adicionar grupo de repositório
Adicionar, editar ou excluir atributo (para pesquisa e filtragem)
Catalog category/product index
Adicionar, editar ou excluir produtos (único, em massa e importação)
Alterar relações entre produtos e categorias
Adicionar, editar ou excluir categorias
Adicionar ou excluir lojas
Excluir grupos de lojas
Excluir sites
Catalog search index
Adicionar, editar ou excluir produtos (único, em massa e importação)
Adicionar ou excluir lojas
Excluir grupos de lojas
Excluir sites
Stock status index
Alterar as configurações de inventário.
Category permissions index
Adicionar repositório
Adicionar grupo de repositório
Adicionar, excluir ou atualizar atributo (para pesquisa e filtragem)
IMPORTANT
O uso de um catálogo simples não é mais recomendado como prática recomendada. O uso continuado desse recurso é conhecido por causar degradação de desempenho e outros problemas de indexação. Consulte Usar produto de catálogo simples para obter mais informações.

Indexar ações e controles

Ação
Resultado
Controles
Criando uma loja, um novo grupo de clientes ou qualquer ação listada em Actions that Cause a Full Reindex
Reindexação completa
A reindexação completa é executada dentro do cronograma determinado pelo trabalho Adobe Commerce ou Magento Open Source cron.
Carregamento de itens em massa (importação/exportação do Commerce, consulta SQL direta e qualquer outro método que adicione, altere ou exclua dados diretamente)
Reindexação parcial (somente os itens alterados são reindexados)
Na frequência determinada pelo trabalho cron do Commerce.
Alteração do escopo (por exemplo, de global para site)
Reindexação parcial (somente os itens alterados são reindexados)
Na frequência determinada pelo trabalho cron do Commerce.

Eventos que acionam a reindexação completa

Indexador
Evento
Catalog Category Flat Indexer
Criar um repositório Web
Criar uma exibição de repositório Web
Criar ou excluir um atributo que seja qualquer um dos seguintes:
- Pesquisável ou visível na pesquisa avançada
- Filtrável
- Filtrável na pesquisa
- Usado para classificação
Alterar um atributo existente para que ele seja qualquer um dos anteriores.
Habilitar opções de vitrine de categoria simples
Catalog Product Flat Indexer
Criar um repositório Web
Criar uma exibição de repositório Web
Criar ou excluir um atributo que seja qualquer um dos seguintes:
- Pesquisável ou visível na pesquisa avançada
- Filtrável
- Filtrável na pesquisa
- Usado para classificação
Alterar um atributo existente para ser qualquer um dos anteriores.
Habilitar opções de vitrine de categoria simples
Stock status indexer
Quando as Opções de inventário de catálogo a seguir forem alteradas na configuração do sistema:
Stock Options - Exibir Produtos sem Estoque
Product Stock Options - Gerenciar Estoque
Price Indexer
Adicionando um grupo de clientes.
Quando qualquer uma das opções de Inventário de Catálogo a seguir for alterada na configuração do sistema:
Stock Options - Exibir Produtos sem Estoque
Product Stock Options - Gerenciar Estoque
Price - Escopo do Preço do Catálogo
Category or Product Indexer
Criar ou excluir uma exibição de loja
Excluir uma loja
Excluir um site
recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1