Uppdatera dina innehållsfragment för optimerad GraphQL-filtrering updating-content-fragments-for-optimized-graphql-filtering
Om du vill optimera prestanda för dina GraphQL-filter kör du en procedur för att uppdatera dina innehållsfragment.
Förutsättningar prerequisites
Det finns krav för den här uppgiften:
-
Se till att du har minst 2023.1.0-utgåvan av AEM as a Cloud Service.
-
Se till att användaren som utför uppgiften har de behörigheter som krävs:
- minst
Deployment Manager
en roll i Cloud Manager krävs.
- minst
Uppdatera dina innehållsfragment updating-content-fragments
-
Aktivera uppdateringen genom att ange följande variabler för instansen med användargränssnittet i Cloud Manager:
De tillgängliga variablerna är:
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 layout-auto html-authored Namn Värde Standardvärde Tjänst Används Typ Anteckningar 1 "CF_MIGRATION_ENABLED" "1" "0" Alla Variabel Enables(!=0) eller inaktiverar(0) som utlöser migreringsjobb för innehållsfragment. 2 `CF_MIGRATION_ENFORCE` "1" "0" Alla Variabel Tvinga (!=0) ommigrering av innehållsfragment.
Om du anger flaggan till 0 utförs en stegvis migrering av CF:er. Detta innebär, om jobbet avslutas av någon anledning, att nästa körning av jobbet startar migreringen från den punkt där det avslutades. Den första migreringen rekommenderas för tvång (value=1).3 "CF_MIGRATION_BATCH" "50" "50" Alla Variabel Storlek på gruppen för att spara antalet innehållsfragment efter migreringen.
Detta gäller hur många CF:er som sparas i databasen i en batch och kan användas för att optimera antalet skrivningar i databasen.4 "CF_MIGRATION_LIMIT" "1000" "1000" Alla Variabel Maximalt antal innehållsfragment som ska bearbetas samtidigt.
Se även anmärkningarna för "CF_MIGRATION_INTERVAL".5 "CF_MIGRATION_INTERVAL" "60" "600" Alla Variabel Intervall (sekunder) för att bearbeta återstående innehållsfragment upp till nästa gräns
Det här intervallet betraktas också som både en väntetid innan jobbet startas och en fördröjning mellan bearbetningen av varje efterföljande CF_MIGRATION_LIMIT-antal CF:er.
(*)note note NOTE (*) Värdet för CF_MIGRATION_INTERVAL
kan också hjälpa till att beräkna den totala körningstiden för migreringsjobbet.Till exempel: - Totalt antal innehållsfragment = 20 000
- CF_MIGRATION_LIMIT = 1000
- CF_MIGRATION_INTERNAL = 60 (Sec)
- Ungefärlig tid krävs för att slutföra migreringen = 60 + (20 000/1 000 * 60) = 1 260 sek = 21 minuter
De ytterligare"60" sekunder som läggs till i början beror på den initiala fördröjningen när jobbet startas.
Det här är bara minimum den tid som krävs för att slutföra jobbet, men inte I/O-tiden. Den faktiska tiden kan vara längre än denna uppskattning. -
Övervaka uppdateringens förlopp och slutförande.
För att göra detta ska du övervaka loggarna på författaren och publicera med golden från:
-
com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob
-
Författarloggar, till exempel:
code language-shell 23.01.2023 13:13:45.926 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob This instance<dd9ffdc1-0c28-4d04-9a96-5d4d223e457e> is the leader, will schedule the upgrade schedule job. ... 23.01.2023 13:13:45.941 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Scheduling content fragments upgrade from version 0 to 1, slingJobId: 2023/1/23/13/13/50e1a575-4cd7-497b-adf0-62cb5768eedb_0, enforce: true, limit: 1000, batch: 50, interval: 60s 23.01.2023 13:20:40.960 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished content fragments upgrade in 6m, slingJobId: 2023/1/23/13/13/50e1a575-4cd7-497b-adf0-62cb5768eedb_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Upgrade to version '1' succeeded.', errors=[], successCount=3781, failedCount=0, skippedCount=0}
-
Golden-publish logs, till exempel:
code language-shell 23.01.2023 12:35:05.150 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob This instance<ad1b399e-77be-408e-bc3f-57097498fddb> is the leader, will schedule the upgrade schedule job. 23.01.2023 12:35:05.161 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Scheduling content fragments upgrade from version 0 to 1, slingJobId: 2023/1/23/12/34/ad1b399e-77be-408e-bc3f-57097498fddb_0, enforce: true, limit: 1000, batch: 50, interval: 60s ... 23.01.2023 12:40:45.180 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished content fragments upgrade in 5m, slingJobId: 2023/1/23/12/34/ad1b399e-77be-408e-bc3f-57097498fddb_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Upgrade to version '1' succeeded.', errors=[], successCount=3781, failedCount=0, skippedCount=0}
-
Kunder som har aktiverat åtkomst till miljöloggar med Splunk kan använda exempelfrågan nedan för att övervaka uppgraderingsprocessen. Mer information om hur du aktiverar Splunk-loggning finns i Felsöka produktion och scen.
code language-splunk index=<indexName> sourcetype=aemerror aem_envId=<environmentId> msg="*com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished*" (aem_tier=golden-publish OR aem_tier=author) | table _time aem_tier pod_name msg | sort -_time desc
Var:
environmentId
- en identifierare av kundens miljö, till exempele1234
indexName
- ett kundindexnamn, samla inaemerror
händelser
Exempelutdata:
table 0-row-4 1-row-4 2-row-4 layout-auto tid aem_tier pod_name msg 2023-04-21 06:00:35.723 författare cm-p1234-e1234-aem-author-76d6dc4b79-8lsb5 [sling-threadpool-bb5da4dd-6b05-4230-93ea-1d5cd242e24f-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upsekretessen)] com.adobe.cq.dam.cfm.impl .upgrade.UpgradeJob Slutför uppgraderingen av innehållsfragment på 391m, slingJobId: 2023/4/20/23/16/db7963df-e267-489b-b69a-5930b0dadb333 7_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Uppgradering till version '1' lyckades.', errors=[], successCount=36756, failedCount=0, SkippedCount=0} 2023-04-21 06:05:48.207 gyllene-publicering cm-p1234-e1234-aem-golden-publish-64487c9c5-lvkv2 [sling-threadpool-284b9a9a-8454-461e-9bdb-44866c6ddfb1-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upsekretessing)] com.adobe.cq.dam.cfm.cfm.m.cfm.fm.cfm.m.m.cfm.m.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.fm.a impl.upgrade.UpgradeJob Slutför uppgradering av innehållsfragment i 211m, slingJobId: 2023/4/20/23/15/66c1690a-cdb7-4e66-bc52-90f394ddfc_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Uppgradering till version '1' lyckades.', errors=[], successCount=19557, failedCount=0, SkippedCount=0} -
-
Inaktivera uppdateringsproceduren.
note important IMPORTANT Det här steget krävs för att slutföra uppgraderingen. Återställ molnmiljövariabeln när uppdateringsproceduren har körts
CF_MIGRATION_ENABLED
till '0', för att utlösa återvinning av alla poder. -
table html-authored no-header table 0-row-8 1-row-8 layout-auto html-authored Namn Värde Standardvärde Tjänst Används Typ Anteckningar "CF_MIGRATION_ENABLED" "0" "0" Alla Variabel Inaktiverar(0) (eller Enables(!)=0)) utlöser migreringsjobb för innehållsfragment. note note NOTE Detta är viktigt för publiceringsnivån eftersom innehållsuppdateringen endast görs vid publicering i golden och när poderna återvinns är alla normala publiceringsrutor baserade på den gyllene publiceringen. Verifiera att uppdateringsproceduren har slutförts.
Du kan verifiera att uppdateringen har slutförts med hjälp av databaswebbläsaren i Cloud Managers utvecklarkonsol för att kontrollera data för innehållsfragment.
-
Innan den första fullständiga migreringen
cfGlobalVersion
egenskapen finns inte.
Därför finns den här egenskapen på JCR-noden/content/dam
med värdet1
, bekräftar att migreringen har slutförts. -
Du kan även kontrollera följande egenskaper för de enskilda innehållsfragmenten:
_strucVersion
ska ha värdet1
indexedData
struktur måste finnas
note note NOTE Proceduren uppdaterar innehållsfragment för författare- och publiceringsinstanser. Därför rekommenderar Adobe att du utför verifieringen via databaswebbläsaren för minst en författare och en Publish-instans.
-
Begränsningar limitations
Tänk på följande begränsningar:
-
Optimering av prestanda för GraphQL-filter är endast möjligt efter en fullständig uppdatering av alla dina innehållsfragment (vilket visas genom närvaron av
cfGlobalVersion
egenskap för JCR-noden/content/dam
) -
Om innehållsfragment importeras från ett innehållspaket (med
crx/de
) när uppdateringsproceduren har körts, beaktas inte dessa innehållsfragment i GraphQL-frågeresultat förrän uppdateringsproceduren körs igen.