Bästa tillvägagångssätt för att ändra databastabeller

I den här artikeln beskrivs de bästa sätten att ändra databastabeller som har skapats av Adobe Commerce eller tredjepartsmoduler. Genom att förstå när och hur ni effektivt ändrar tabeller kan ni säkerställa långsiktig lönsamhet och stabilitet på er handelsplattform.

Om du migrerar från Magento 1 och andra e-handelsplattformar, eller arbetar med moduler från Adobe Commerce Marketplace, kan du behöva lägga till och spara extra data. Den första instansen kan vara att lägga till en kolumn i en databastabell eller att justera en befintlig kolumn. Du bör dock endast ändra ett huvudregister för Adobe Commerce (eller ett register för tredjepartsleverantör) i begränsade situationer.

Varför Adobe rekommenderar att man undviker ändringar

Det främsta skälet till att undvika att ändra huvudtabeller är att Adobe Commerce innehåller underliggande logik som innehåller råa SQL-frågor. Ändringar i tabellstrukturen kan orsaka oväntade biverkningar som är svåra att felsöka. Ändringen kan också påverka DDL-åtgärder (Data Definition Language) som kan ge oväntade och oförutsägbara effekter på prestandan.

Ett annat skäl till att undvika att ändra databastabellens struktur är att dina ändringar kan orsaka problem om huvudutvecklingsteamet eller tredjepartsutvecklare ändrar strukturen i sina databastabeller. Det finns till exempel några viktiga databastabeller som har en kolumn som heter additional_data. Detta har alltid varit en text-kolumntyp. Huvudteamet kan dock av prestandaskäl ändra kolumnen till longtext. Den här kolumntypen är ett alias för JSON. Genom att konvertera till den här kolumntypen läggs prestandavinster och sökbarhet till i den kolumnen, som inte finns som en text-typ. Du kan läsa mer om det här avsnittet i JSON-datatypen.

Ha koll på när data ska sparas eller tas bort

Adobe rekommenderar att du först avgör om du behöver spara dessa data eller inte. Om du flyttar data från ett äldre system sparar alla data som du kan ta bort både tid och arbete under migreringen. (Det finns olika sätt att arkivera data om de behöver användas senare.) För att programmet och prestandan ska bli en bra fördel kan det vara bra att bestrida en begäran om att spara extra data. Målet är att säkerställa att sparandet av data är ett krav för att uppfylla ett affärsbehov som inte kan uppfyllas på ett annat sätt.

Äldre data

Om projektet innehåller äldre data, t.ex. gamla order eller kundposter, bör du överväga en alternativ sökmetod. Om företaget till exempel kräver åtkomst till data endast för tillfälliga referenser bör du implementera en extern sökning av den gamla databasen som ligger utanför handelsplattformen i stället för att migrera gamla data till Adobe Commerce.

Detta kräver att databasen migreras till en server, antingen med ett webbgränssnitt för att läsa data, eller kanske utbildning i användningen av MySQL Workbench eller liknande verktyg. Genom att dessa data utelämnas från den nya databasen går migreringen snabbare eftersom utvecklingsteamet kan fokusera på den nya webbplatsen i stället för att felsöka datamigreringsproblem.

Ett annat relaterat alternativ för att göra data externa för e-handel, men som gör det möjligt att använda dem i realtid, är att utnyttja andra verktyg, som GraphQL-nät. Det här alternativet kombinerar olika datakällor och returnerar dem som ett enda svar.

Du kan till exempel stitch kombinera gamla order från en extern databas, kanske den gamla Magento 1-webbplatsen som är avställd. Visa dem sedan som en del av kundens orderhistorik med GraphQL-nät. Dessa gamla order kan kombineras med beställningarna från din nuvarande Adobe Commerce-miljö.

Mer information om hur du använder API-nät med GraphQL finns i Vad är API-nät) och GraphQL Mesh Gateway.

Migrera äldre data med tilläggsattribut

Om du anser att äldre data kräver migrering eller att nya data måste sparas i Adobe Commerce rekommenderar Adobe att du använder tilläggsattribut. Att använda tilläggsattribut för att spara ytterligare data ger följande fördelar:

Två exempel på lagringsplatser är databastabeller och Redis. Det viktigaste att tänka på när du väljer en plats är om platsen medför extra komplexitet eller påverkar prestandan.

Överväg andra alternativ

Som utvecklare är det viktigt att alltid överväga att använda verktyg utanför din Adobe Commerce-miljö, till exempel GraphQL-nät och Adobe App Builder. De här verktygen kan hjälpa dig att behålla åtkomsten till data men påverkar inte centrala e-handelsprogrammet eller dess underliggande databastabeller. Med den här metoden kan du visa data via ett API. Sedan lägger du till en datakälla i din App Builder-konfiguration. Med GraphQL Mesh kan du kombinera dessa datakällor och skapa ett enda svar som nämns i äldre data.

Mer information om GraphQL-nät finns i GraphQL Mesh Gateway. Mer information om Adobe App Builder finns i Introduktion till App Builder.

Ändra en bastabell eller tredjepartstabell

Om du bestämmer dig för att lagra data genom att ändra databastabellen för kärnmodulen Adobe Commerce eller en tredjepartsmodul använder du följande riktlinjer för att minimera påverkan på stabilitet och prestanda.

Bästa tillvägagångssätt för att ändra en extern databastabell

Adobe rekommenderar att du följer de här stegen när du lägger till en kolumn i en huvuddatabastabell eller en tredjepartstabell:

Potentiella effekter

Om du lägger till en kolumn i en extern databas kan det påverka ditt Adobe Commerce-projekt på följande sätt:

Olika sätt att undvika att ändra huvudtabeller

Du kan undvika att ändra Adobe Commerce databastabeller genom att använda tilläggsattribut. Ett annat alternativ är att använda en särskild kolumn (additional_data) som finns i några huvudtabeller för att lagra data och spara dem i JSON-kodat format.

Spara data i en JSON-kodad datakolumn

Vissa huvudtabeller har en additional_data-kolumn som innehåller JSON-kodade data. I den här kolumnen finns ett inbyggt sätt att mappa ytterligare data i ett fält. Med den här metoden undviker du att lägga till en tabell för små, enkla dataelement som lagrar information för datahämtning utan sökkrav. Kolumnen additional_data är vanligtvis bara tillgänglig på objektnivå, inte för hela offerten eller ordningen.

Här är exempel på tabeller som har kolumnen och strukturen för kolumnen 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)

I versionerna 2.4.3, 2.4.4 och 2.4.5 finns det tio tabeller som har kolumnen additional_data.

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)