Aanbevolen procedures voor het wijzigen van databasetabellen

Dit artikel biedt tips en trucs voor het wijzigen van databasetabellen die door Adobe Commerce of modules van derden worden gemaakt. Begrijpen wanneer en hoe te om lijsten effectief te wijzigen helpt de levensvatbaarheid en stabiliteit op lange termijn van uw handelsplatform verzekeren.

Voor het migreren van Magento 1 en andere e-commerceplatforms of het werken met modules van de Adobe Commerce Marketplace kunt u extra gegevens toevoegen en opslaan. Uw eerste instinct zou kunnen zijn om een kolom aan een gegevensbestandlijst toe te voegen, of bestaande aan te passen. U moet echter een kern- Adobe Commerce tabel (of een tabel van een externe leverancier) alleen in beperkte situaties wijzigen.

Waarom Adobe aanbeveelt wijzigingen te vermijden

De belangrijkste reden om het wijzigen van kernlijsten te vermijden is dat Adobe Commerce onderliggende logica omvat die ruwe SQL vragen bevat. Wijzigingen in de structuur van de tabel kunnen leiden tot onverwachte bijwerkingen die moeilijk zijn op te lossen. De wijziging kan ook invloed hebben op bewerkingen met DDL (Data Definition Language) die onverwachte en onvoorspelbare gevolgen voor de prestaties hebben.

Een andere reden om te vermijden veranderend de structuur van de gegevensbestandlijst is dat uw veranderingen kwesties kunnen veroorzaken als het team van de kernontwikkeling of derdeontwikkelaars de structuur van hun gegevensbestandlijsten veranderen. Er zijn bijvoorbeeld een paar basistabellen voor databases met de naam additional_data . Dit is altijd een kolomtype text geweest. Om prestatieredenen kan het kernteam de kolom echter wijzigen in longtext . Dit type kolom is een alias voor JSON. Door in dit kolomtype om te zetten, worden er prestatiewinst en doorzoekbaarheid toegevoegd aan die kolom, die niet als text type bestaat. U kunt meer op dit onderwerp in JSON- gegevenstypelezen.

Weet wanneer gegevens moeten worden opgeslagen of verwijderd

Adobe raadt u aan eerst te bepalen of u deze gegevens moet opslaan. Als u gegevens verplaatst van een verouderd systeem, bespaart gegevens die u kunt verwijderen u tijd en moeite tijdens de migratie. (Er zijn manieren om gegevens te archiveren als het later moet worden betreden.) Om een goede beheerder van de toepassing en de prestaties te zijn, is het in orde om een verzoek uit te dagen om extra gegevens te bewaren. Uw doel is ervoor te zorgen dat het bewaren van de gegevens een vereiste is om een bedrijfsbehoefte te vervullen die niet een andere manier kan worden gevuld.

Oudere gegevens

Als uw project erfenisgegevens, zoals oude orden of klantenverslagen bevat, overweeg een alternatieve raadplegingsmethode. Bijvoorbeeld, als de zaken toegang tot de gegevens slechts voor occasionele verwijzing vereisen, overweeg uitvoerend een extern onderzoek van het oude gegevensbestand buiten het handelsplatform wordt ontvangen in plaats van migrerend oude gegevens aan Adobe Commerce.

Deze situatie zou vereisen dat de database naar een server wordt gemigreerd, waarbij een webinterface wordt aangeboden om de gegevens te lezen, of een training in het gebruik van MySQL Workbench of vergelijkbare tools. Als u deze gegevens niet in de nieuwe database opneemt, wordt de migratie versneld doordat het ontwikkelingsteam zich kan richten op de nieuwe site in plaats van problemen met de migratie van gegevens op te lossen.

Een andere verwante optie voor het houden van de gegevens extern aan handel maar het toestaan van u om het in echt te gebruiken - tijd zou andere hulpmiddelen, zoals het netwerk van GraphQL leveraging. Deze optie combineert verschillende gegevensbronnen en retourneert deze als één reactie.

U kunt bijvoorbeeld oude bestellingen van een externe database stitch samenvoegen, bijvoorbeeld de oude Magento 1-site die uit bedrijf is genomen. Dan gebruikend het net van GraphQL, toon hen als deel van de klantenorde geschiedenis. Deze oude bestellingen kunnen worden gecombineerd met de bestellingen uit uw huidige Adobe Commerce -omgeving.

Voor meer informatie over het gebruiken van API netwerk met GraphQL, zie wat API Netis ) en de Gateway van het Net van GraphQL.

Oudere gegevens migreren met extensiekenmerken

Als u bepaalt dat de erfenisgegevens migratie vereisen, of dat de nieuwe gegevens in Adobe Commerce moeten worden bewaard, adviseert de Adobe gebruikend uitbreidingsattributen. Het gebruik van extensiekenmerken voor het opslaan van aanvullende gegevens biedt de volgende voordelen:

Twee voorbeelden van opslaglocaties zijn databasetabellen en Redis . Bij het kiezen van een locatie moet u rekening houden met de vraag of een locatie een extra complexiteit veroorzaakt of van invloed is op de prestaties.

Andere alternatieven overwegen

Als ontwikkelaar is het van essentieel belang om altijd te overwegen om gereedschappen te gebruiken buiten uw Adobe Commerce -omgeving, zoals GraphQL mesh en Adobe App Builder. Deze hulpmiddelen kunnen u helpen toegang tot de gegevens behouden maar hebben geen invloed op de kernhandelstoepassing of zijn onderliggende gegevensbestandlijsten. Met deze aanpak maakt u uw gegevens beschikbaar via een API. Vervolgens voegt u een gegevensbron toe aan uw App Builder-configuratie. Gebruikend het Net van GraphQL, kunt u die gegevensbronnen combineren en één enkele reactie produceren zoals vermeld in erfenisgegevens.

Voor extra details op het net van GraphQL, zie {de Gateway van het Net van 0} GraphQL 🔗 . Voor informatie over de Adobe App Builder, zie Introducerend App Builder.

Een kerntabel of tabel van derden wijzigen

Als u besluit om gegevens op te slaan door een kern Adobe Commerce - of derdesmodule databasetabel te wijzigen, moet u de volgende richtlijnen gebruiken om de invloed op de stabiliteit en prestaties te minimaliseren.

Aanbevolen procedures voor het wijzigen van een externe databasetabel

De Adobe raadt u aan deze stappen te volgen wanneer u een kolom toevoegt aan een kerndatabasetabel of een tabel van derden:

Mogelijke effecten

Het toevoegen van een kolom aan een extern gegevensbestand kan uw Adobe Commerce project op de volgende manieren beïnvloeden:

Manieren om het wijzigen van kerntabellen te vermijden

U kunt vermijden wijzigend Adobe Commerce gegevensbestandlijsten door uitbreidingsattributente gebruiken. Een ander alternatief is een speciale kolom (additional_data) te gebruiken die op een paar kernlijsten wordt gevonden om gegevens op te slaan en het in JSON-Gecodeerde formaat op te slaan.

Gegevens opslaan in een gegevenskolom die met JSON is gecodeerd

Sommige kerntabellen hebben een additional_data -kolom die JSON-gecodeerde gegevens bevat. Deze kolom biedt een native manier om extra gegevens in één veld toe te wijzen. Met deze methode vermijdt u het toevoegen van een tabel voor kleine, eenvoudige gegevenselementen die informatie voor gegevensherwinning zonder zoekopdracht opslaan. De kolom additional_data is gewoonlijk alleen beschikbaar op itemniveau, niet voor het volledige aanhalingsteken of de volledige volgorde.

Hier volgen voorbeelden van tabellen met de kolom en structuur voor de kolom additional_data .

MariaDB [main]> DESCRIBE quote_item additional_data;
+-----------------+------+------+-----+---------+-------+
| Field           | Type | Null | Key | Default | Extra |
+-----------------+------+------+-----+---------+-------+
| additional_data | text | YES  |     | NULL    |       |
+-----------------+------+------+-----+---------+-------+
1 row in set (0.001 sec)


MariaDB [main]> DESCRIBE sales_order_item additional_data;
+-----------------+------+------+-----+---------+-------+
| Field           | Type | Null | Key | Default | Extra |
+-----------------+------+------+-----+---------+-------+
| additional_data | text | YES  |     | NULL    |       |
+-----------------+------+------+-----+---------+-------+
1 row in set (0.001 sec)

In versies 2.4.3, 2.4.4 en 2.4.5 zijn er tien tabellen die de kolom additional_data hebben.

MariaDB [magento]> SELECT DISTINCT TABLE_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE COLUMN_NAME IN ('additional_data') AND TABLE_SCHEMA='main';
+------------------------+
| TABLE_NAME             |
+------------------------+
| sales_shipment_item    |
| sales_creditmemo_item  |
| sales_invoice_item     |
| catalog_eav_attribute  |
| sales_order_payment    |
| quote_address_item     |
| quote_payment          |
| quote_item             |
| magento_reward_history |
| sales_order_item       |
+------------------------+
10 rows in set (0.020 sec)