Prácticas recomendadas para modificar tablas de base de datos

Este artículo proporciona prácticas recomendadas para modificar tablas de base de datos creadas por Adobe Commerce o módulos de terceros. Comprender cuándo y cómo modificar tablas de forma eficaz ayuda a garantizar la viabilidad y estabilidad a largo plazo de su plataforma de comercio.

Migración desde Magento 1 y otras plataformas de comercio electrónico, o trabajar con módulos de Adobe Commerce Marketplace, puede requerir agregar y guardar datos adicionales. Su primer instinto podría ser agregar una columna a una tabla de la base de datos o ajustar una existente. Sin embargo, solo debe modificar un núcleo Adobe Commerce (o tabla de proveedores de terceros) en situaciones limitadas.

Por qué el Adobe recomienda evitar las modificaciones

El motivo principal para evitar la modificación de las tablas principales es que Adobe Commerce incluye una lógica subyacente que contiene consultas SQL sin procesar. Los cambios en la estructura de la tabla pueden producir efectos adversos inesperados que son difíciles de solucionar. El cambio también puede afectar a las operaciones de DDL (lenguaje de definición de datos), lo que provoca efectos inesperados e impredecibles en el rendimiento.

Otro motivo para evitar cambiar la estructura de la tabla de la base de datos es que los cambios pueden causar problemas si el equipo de desarrollo principal o los desarrolladores de terceros cambian la estructura de sus tablas de base de datos. Por ejemplo, hay algunas tablas de bases de datos principales que tienen una columna denominada additional_data. Esto siempre ha sido un text tipo de columna. Sin embargo, por motivos de rendimiento, el equipo principal podría cambiar la columna a longtext. Este tipo de columna es un alias para JSON. Al convertir a este tipo de columna, se agregan mejoras de rendimiento y capacidad de búsqueda a esa columna, que no existe como text escriba. Puede obtener más información sobre este tema en Tipo de datos JSON.

Saber cuándo guardar o quitar datos

El Adobe recomienda determinar primero si es necesario guardar estos datos. Si mueve datos de un sistema heredado, cualquier dato que pueda eliminar le ahorrará tiempo y esfuerzo durante la migración. (Hay formas de archivar los datos si es necesario acceder a ellos más adelante). Para ser un buen administrador de la aplicación y el rendimiento, está bien retar una solicitud para guardar datos adicionales. Su objetivo es garantizar que guardar los datos sea un requisito para satisfacer una necesidad empresarial que no se puede rellenar de otra manera.

Datos heredados

Si el proyecto contiene datos heredados, como pedidos antiguos o registros de clientes, considere un método de búsqueda alternativo. Por ejemplo, si la empresa requiere acceso a los datos solo para referencia ocasional, considere implementar una búsqueda externa de la antigua base de datos alojada fuera de la plataforma de comercio en lugar de migrar los datos antiguos a Adobe Commerce.

Esta situación requeriría que la base de datos se migrara a un servidor, ofreciendo ya sea una interfaz web para leer los datos, o quizás capacitación en el uso de MySQL Workbench o herramientas similares. Excluir estos datos de la nueva base de datos acelera la migración, ya que permite al equipo de desarrollo centrarse en el nuevo sitio en lugar de solucionar los problemas de migración de datos.

Otra opción relacionada para mantener los datos externos al comercio pero que le permite utilizarlos en tiempo real sería aprovechar otras herramientas, como GraphQL mesh. Esta opción combina diferentes fuentes de datos y las devuelve como una sola respuesta.

Por ejemplo, puede stitch junto a los pedidos antiguos de una base de datos externa, tal vez el sitio antiguo de Magento 1 que se ha retirado del mercado. A continuación, utilizando GraphQL mesh, muéstrelos como parte del historial de pedidos de los clientes. Estos pedidos antiguos se pueden combinar con los pedidos actuales Adobe Commerce entorno.

Para obtener más información sobre el uso de API mesh con GraphQL, consulte ¿Qué es API Mesh?) and GraphQL Mesh Gateway.

Migración de datos heredados con atributos de extensión

Si determina que los datos heredados requieren migración o que es necesario guardar nuevos datos en Adobe Commerce, el Adobe recomienda utilizar atributos de extensión. El uso de atributos de extensión para guardar datos adicionales ofrece las siguientes ventajas:

Dos ejemplos de ubicaciones de almacenamiento son las tablas de base de datos y Redis. Las cosas clave que hay que tener en cuenta al elegir una ubicación son si la ubicación presenta una complejidad adicional o afecta al rendimiento.

Considerar otras alternativas

Como desarrollador, es vital considerar siempre el uso de herramientas fuera de su Adobe Commerce entorno, como GraphQL mesh y App Builder de Adobe. Estas herramientas pueden ayudarle a conservar el acceso a los datos, pero no afectan a la aplicación principal de comercio ni a sus tablas de base de datos subyacentes. Con este enfoque, expone sus datos a través de una API. A continuación, agregue una fuente de datos a la configuración del Generador de aplicaciones. Con GraphQL Mesh, puede combinar esas fuentes de datos y producir una única respuesta como se menciona en datos heredados.

Para obtener más información sobre GraphQL mesh, consulte GraphQL Mesh Gateway. For information about the Adobe App Builder, see Introducing App Builder.

Modificación de una tabla principal o de una tabla de terceros

Si decide almacenar datos mediante la modificación de un núcleo Adobe Commerce Para la tabla de bases de datos de módulos de terceros, utilice las siguientes directrices para minimizar el impacto en la estabilidad y el rendimiento.

Prácticas recomendadas para modificar una tabla de base de datos externa

Adobe recomienda seguir estos pasos cuando agregue una columna a una tabla de la base de datos principal o a una tabla de terceros:

Impactos potenciales

Añadir una columna a una base de datos externa puede afectar al proyecto de Adobe Commerce de las siguientes maneras:

Formas de evitar la modificación de tablas principales

Puede evitar modificar las tablas de la base de datos de Adobe Commerce utilizando atributos de extensión. Otra alternativa es utilizar una columna especial (additional_data) en algunas tablas principales para almacenar datos y guardarlos en formato con codificación JSON.

Guardar datos en una columna de datos con codificación JSON

Algunas tablas principales tienen un additional_data que contiene datos codificados en JSON. Esta columna ofrece una forma nativa de asignar datos adicionales en un campo. El uso de este método evita agregar una tabla para elementos de datos pequeños y simples que almacenan información para la recuperación de datos sin un requisito de búsqueda. El additional_data La columna solo está disponible en el nivel de artículo, no para toda la oferta o el pedido.

Estos son ejemplos de tablas que tienen la columna y la estructura para la variable additional_data columna.

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)

En las versiones 2.4.3, 2.4.4 y 2.4.5 hay diez tablas que tienen la columna 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)