Magento 2.1 ee content staging

© 2016 Magento, Inc. Page | 1

2.1 EE Content

Staging Technical

overview


Software Architect at Magento

Anton Kaplya


Agenda

• What is Content Staging

• How Content Staging works

• How to work with Content Staging


Magento StagingScheduling data changes for ecommerce

entities


What is Content Staging

• Scheduling data changes

• Instant Preview

• Automatic changes deployment



Magento Content Staging


Magento Content Staging


Magento Staging Dashboard


Magento Content Staging Preview


Supported Entities • Products & Categories

• CMS Pages & Blocks

• Cart Price Rules

• Catalog Rule


How Content Staging works


MVCC

• Multiversion Concurrency Control

• InnoDB transaction engine is built upon MVCC

• Copy on change



MVCC

1 100 150 200

A

50 MAX

A'A''

BB'

C


How MVCC influences Magento• Entity may have several representations in main table

• Creation time

• Expiration time


Assumptions & Agreements

• We use UNIX_TIMESTAMP as a pointer for versions

• Default value for creation time is 1

• Default for value expiration time is MAX INT


Table structure

CREATE TABLE entity_table (

row_id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,

entity_id UNSIGNED NOT NULL,

created_in BIGINT UNSIGNED NOT NULL,

updated_in BIGINT UNSIGNED NOT NULL,

...

PRIMARY KEY ( row_id),

KEY ix_entity_id ( entity_id),

KEY ix_created_in ( created_in),

KEY ix_updated_in ( updated_in)

) ENGINE=InnoDB;


Example

SELECT

e.row_id, e.entity_id, e.created_in,

e.updated_in, v.value

FROM catalog_product_entity e

JOIN catalog_product_entity_varchar v

ON v.row_id = e.row_id AND v.attribute_id = 73

WHERE e.entity_id = 1;


Creation of new entity

+--------+-----------+------------+------------+-----------+

| row_id | entity_id | created_in | updated_in | value |

+--------+-----------+------------+------------+-----------+

| 1 | 1 | 1 | 2147483647 | Green Car |

+--------+-----------+------------+------------+-----------+


Create a new version for entity

+--------+-----------+------------+------------+-----------+


+--------+-----------+------------+------------+-----------+

| 1 | 1 | 1 | 1474829340 | Green Car |

| 2 | 1 | 1474829340 | 2147483647 | Blue Car |

+--------+-----------+------------+------------+-----------+


Create several future versions

+--------+-----------+------------+------------+-----------+


+--------+-----------+------------+------------+-----------+

| 1 | 1 | 1 | 1474829340 | Green Car |

| 2 | 1 | 1474829340 | 1474988880 | Blue Car |

| 3 | 1 | 1474988880 | 1475161680 | Red Car |

| 4 | 1 | 1475161680 | 2147483647 | Blue Car |

+--------+-----------+------------+------------+-----------+


How select works


How select works

WHERE (created_in <= 125 AND updated_in > 125)

+--------+-----------+------------+------------+

| row_id | entity_id | created_in | updated_in |

+--------+-----------+------------+------------+

| 1 | 1 | 1 | 100 |

| 2 | 1 | 100 | 200 |

| 3 | 1 | 200 | 2147483647 |

| 4 | 2 | 1 | 150 |

| 5 | 2 | 150 | 2147483647 |

| 6 | 3 | 1 | 2147483647 |

+--------+-----------+------------+------------+


How SELECT works (Query)

SELECT e.row_id, e.entity_id,

e.created_in, e.updated_in, v.value

FROM catalog_product_entity e

JOIN catalog_product_entity_varchar v ON v.row_id = e.row_id

AND v.attribute_id = 73

WHERE e.entity_id = 1

AND (e.created_in <= 1474828140

AND updated_in > 1474828140

);


How SELECT works (Data)

+--------+-----------+------------+------------+-----------+


+--------+-----------+------------+------------+-----------+

| 1 | 1 | 1 | 1474829340 | Green Car |

+--------+-----------+------------+------------+-----------+

| 2 | 1 | 1474829340 | 2147483647 | Blue Car |

+--------+-----------+------------+------------+-----------+


How to work with

Content StagingShort notice for extension developers


Content Staging & Code Compatibility• Magento API supports data versioning

• Collection API supports data versioning

• Magento\Db\Select except case with attribute table join;


How to query values from attribute table• Do not use direct SQLs

• If you do not have other choice


Example: how to query attributes from table

$metadata = $pool->getMetadata(ProductInterface::class);

$linkField = $this->metadata->getLinkField();

$connection->select()

->from(['e' => $entityTable], ['e.entity_id']);

->join(

['a' => $attributeTable],

'a.' . $linkField . ' = e.' . $linkField

);


Summary

• Scheduling data changes

• Instant Preview

• Automatic changes deployment


Q&A