인덱서 관리
모든 인덱서의 목록을 보려면 다음과 같이 하십시오.
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
인덱서 모드 설정
schedule
대신 realtime
(으)로 Customer Grid을(를) 설정하십시오. Customer Grid은(는) Update on Save 옵션을 사용해야만 다시 인덱싱할 수 있습니다. 이 인덱스는 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
—인덱서에 대한 자동 크론 트리거 업데이트를 일시적으로 중지합니다. 이 상태는 실시간 및 예약 모드 모두에 적용되므로 집중 작업 중에 자동 업데이트가 일시 중지되도록 할 수 있습니다.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
(으)로 업데이트하기 전에 모든 데이터가 정확하게 인덱싱되도록 하는 것이 중요합니다.