管理索引器
要查看所有索引器的列表,请执行以下操作:
bin/magento indexer:info
该列表显示如下:
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
catalogrule_product Catalog Product Rule
cataloginventory_stock Stock
targetrule_product_rule Product/Target Rule
targetrule_rule_product Target Rule/Product
catalog_product_price Product Price
catalogsearch_fulltext Catalog Search
salesrule_rule Sales Rule
查看索引器状态
使用此命令可以查看所有索引器或特定索引器的状态。 例如,了解索引器是否需要重新索引。
命令选项:
bin/magento indexer:status [indexer]
其中[indexer]
是以空格分隔的索引器列表。 省略[indexer]
以查看所有索引器的状态。
示例结果:
+----------------------+------------------+-----------+---------------------+---------------------+
| Title | Status | Update On | Schedule Status | Schedule Updated |
+----------------------+------------------+-----------+---------------------+---------------------+
| Catalog Product Rule | Reindex required | Save | | |
| Catalog Rule Product | Reindex required | Save | | |
| Catalog Search | Ready | Save | | |
| Category Products | Reindex required | Schedule | idle (0 in backlog) | 2021-06-28 09:45:53 |
| Customer Grid | Ready | Schedule | idle (0 in backlog) | 2021-06-28 09:45:52 |
| Design Config Grid | Ready | Schedule | idle (0 in backlog) | 2018-06-28 09:45:52 |
| Inventory | Ready | Save | | |
| Product Categories | Reindex required | Schedule | idle (0 in backlog) | 2021-06-28 09:45:53 |
| Product EAV | Reindex required | Save | | |
| Product Price | Reindex required | Save | | |
| Stock | Reindex required | Save | | |
+----------------------+------------------+-----------+---------------------+---------------------+
重新索引
使用此命令可只重新索引一次所有或选定的索引器。
命令选项:
bin/magento indexer:reindex [indexer]
其中[indexer]
是以空格分隔的索引器列表。 省略[indexer]
以重新索引所有索引器。
示例结果:
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>
Catalog Product Rule index has been rebuilt successfully in <time>
Stock index has been rebuilt successfully in <time>
Product Price index has been rebuilt successfully in <time>
Catalog Search index has been rebuilt successfully in <time>
以并行模式重新索引
在并行模式下运行索引器之前,必须在PHP中启用进程控制支持(pcntl
)。 请参阅PHP文档中的安装。
索引器具有作用域和多线程,以支持在并行模式下重新索引。 它通过索引器的维度进行并行,并在多个线程中执行,从而缩短处理时间。
在此上下文中,dimension
是重新索引的范围,例如为website
或只是特定的customer_group
。
索引并行化仅影响作用域的索引器,这意味着Commerce使用索引器作为其作用域将数据拆分为多个表,而不是将所有数据保留在一个表中。
您可以在并行模式下运行以下索引:
Catalog Search Fulltext
可以由存储视图并行。Category Product
可以由存储视图并行。Catalog Price
可由网站和客户组并行。Catalog Permissions
可由客户组并行。
要使用并行化,请为产品价格索引器设置一种可用的维度模式:
none
(默认)website
customer_group
website_and_customer_group
例如,为每个网站设置模式:
bin/magento indexer:set-dimensions-mode catalog_product_price website
要对目录权限使用并行化,请为目录权限索引器设置一种可用的维度模式:
none
(默认)customer_group
或者检查当前模式:
bin/magento indexer:show-dimensions-mode
要在并行模式下重新索引,请使用环境变量MAGE_INDEXER_THREADS_COUNT
运行reindex命令,或向env.php
文件添加一个环境变量。 此变量设置用于重新索引处理的线程数。
例如,以下命令跨三个线程运行Catalog Search Fulltext
索引器:
MAGE_INDEXER_THREADS_COUNT=3 php -f bin/magento indexer:reindex catalogsearch_fulltext
重置索引器
使用此命令可使所有索引器或特定索引器的状态失效。
命令选项:
bin/magento indexer:reset [indexer]
其中[indexer]
是以空格分隔的索引器列表。 省略[indexer]
以使所有索引器失效。
示例结果:
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.
Catalog Product Rule indexer has been invalidated.
Stock indexer has been invalidated.
Product Price indexer has been invalidated.
Catalog Search indexer has been invalidated.
配置索引器
使用此命令可设置以下索引器选项:
- 保存时更新(
realtime
):在管理员中进行更改后,索引数据将更新。 (例如,将产品添加到管理员中的类别后,会重新索引类别产品索引。) - 按计划(
schedule
)更新:数据已根据cron作业设置的计划编制索引。
显示当前配置
要查看当前索引器配置,请执行以下操作:
bin/magento indexer:show-mode [indexer]
其中[indexer]
是以空格分隔的索引器列表。 省略[indexer]
以显示所有索引器的模式。 例如,要显示所有索引器的模式,请执行以下操作:
示例结果:
Design Config Grid: Update on Save
Customer Grid: Update on Save
Category Products: Update on Save
Product Categories: Update on Save
Catalog Rule Product: Update on Save
Product EAV: Update on Save
Inventory: Update on Save
Catalog Product Rule: Update on Save
Stock: Update on Save
Product Price: Update on Save
Catalog Search: Update on Save
设置索引器模式
realtime
而不是schedule
设置Customer Grid。 只能使用Update on Save选项为Customer Grid重新编制索引。 此索引不支持Update by Schedule
选项。 使用以下命令行将此索引器设置为保存时更新: php bin/magento indexer:set-mode realtime customer_grid
要指定索引器配置,请执行以下操作:
bin/magento indexer:set-mode {realtime|schedule} [indexer]
其中:
realtime
— 将选定的索引器设置为在保存时更新。schedule
— 根据cron计划设置要保存的指定索引器。indexer
— 是索引器的空格分隔列表。 省略indexer
以按相同方式配置所有索引器。
例如,要仅更改按计划更新的类别产品和产品类别索引器,请输入:
bin/magento indexer:set-mode schedule catalog_category_product catalog_product_category
示例结果:
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'
当索引器模式设置为schedule
时,添加与索引器相关的数据库触发器;当索引器模式设置为realtime
时,删除与索引器相关的数据库触发器。 如果索引器设置为schedule
时数据库中缺少触发器,请将索引器更改为realtime
,然后将它们改回schedule
。 这将重置触发器。
设置索引器状态
bin/magento indexer:set-status
命令是在Adobe Commerce 2.4.7中引入的。它允许管理员修改一个或多个索引器的运行状态,在大量操作(如数据导入、更新或维护)期间优化系统性能。
命令语法:
bin/magento indexer:set-status {invalid|suspended|valid} [indexer]
其中:
invalid
— 将索引器标记为过期,在下次cron运行时提示重新索引,除非它们被挂起。suspended
— 暂时停止索引器的自动cron触发更新。 此状态同时适用于实时模式和计划模式,确保在密集型操作期间暂停自动更新。valid
— 指示索引器数据是最新的,无需重新索引。indexer
— 是索引器的空格分隔列表。 省略indexer
以按相同方式配置所有索引器。
例如,要暂停特定的索引器,请输入:
bin/magento indexer:set-status suspended catalog_category_product catalog_product_category
示例结果:
Index status for Indexer 'Category Products' was changed from 'valid' to 'suspended'.
Index status for Indexer 'Product Categories' was changed from 'valid' to 'suspended'.
管理暂停的索引器状态
当索引器设置为suspended
状态时,它主要影响自动重新索引和实例化视图更新。 下面是简要概述:
已跳过重新索引:已绕过suspended
索引器和共享同一shared_index
的任何索引器的自动重新索引。 这可以确保不会重新索引与已暂停进程相关的数据,从而节省系统资源。
已跳过实例化视图更新:与重新索引类似,与suspended
索引器或其共享索引相关的实例化视图更新也会暂停。 该操作进一步减少了暂停期间的系统负载。
indexer:reindex
命令对所有索引器(包括标记为suspended
的索引器)重新编制索引,使其在自动索引器暂停时可用于手动更新。suspended
或invalid
更改为valid
需要谨慎。 如果存在累积的未索引数据,此操作可能会导致性能下降。valid
以维护系统性能和数据完整性之前,确保所有数据都准确编制索引,这一点至关重要。