Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
Doctrine: Co dělat,
když entity nestačí?
@ProchazkaFilip
#makeCodeNotWar
Co si povíme?
● minimum využití databáze každého Doctrinisty
● batch operace
● rozšiřování DQL
● metody hydratace
● native...
Minimum využití databáze
každého Doctrinisty
Minimum využití databáze každého Doctrinisty
● Co za vás dělá Doctrine
○ indexy pro vazby a primární klíče
○ vzdálené klíč...
Indexy a vzdálené klíče
class User {
/**
* @ORMId()
* @ORMColumn(type="uuid")
*/
private $id;
class Order {
/**
* @ORMMany...
Unique indexy
class User {
/**
* @ORMColumn(type="string", unique=true)
*/
private $email;
Nejjednodušší způsob, jak získa...
Unique indexy
/**
* @ORMEntity()
* @ORMTable(name="order_item_rating",
* uniqueConstraints={
* @ORMUniqueConstraint(name="...
Unique indexy: vkládání a race conditions
● Opravdu to potřebujete řešit?
○ >90% aplikacím stačí check přes repository pře...
Vlastní datový typ
class UuidType extends Type {
const NAME = 'uuid';
function getName() { return self::NAME; }
function g...
Vlastní datový typ: komentáře ve schématu
class SomethingBasedOnStringType extends StringType {
function requiresSQLCommen...
Vlastní datový typ: konverze na úrovni DB
class GeometryType extends Type {
function canRequireSQLConversion() : bool;
fun...
Vlastní datový typ: registrace
doctrine:
dbal:
types:
uuid:
class: RamseyUuidDoctrineUuidType
Zdroj: ramsey/uuid-doctrine
...
Vlastní datový typ: použití
/**
* @ORMId()
* @ORMColumn(type="uuid")
*/
private $id;
CREATE TABLE "user" (
id UUID NOT NUL...
Logika v databázi
vs
Logika v modelu
Premature optimization is the root of all evil ~ Donald Knuth
O tom, jestli patří log...
Batch operace
Batch operace s DQL
“UPDATE/DELETE statements are ported directly into a Database statement and
therefore bypass any locki...
Batch operace s DQL
● Zkuste nejprve chytřejší způsoby iterace nad výsledkem
○ ORMQuery::iterate();
○ Stránkování
● Raději...
Batch operace s DQL
$select = $em->createQueryBuilder()
->addSelect('orderItem.price')
->from(OrderItem::class, 'orderItem...
Batch operace s DQL
UPDATE "order"
SET total_price = (
SELECT SUM(o0_.price) AS dctrn__1
FROM order_item o0_
WHERE o0_.ord...
Batch operace s DBAL
● $connection->prepare('UPDATE ...');
● $connection->createQueryBuilder();
Občas se nejde vyhnout pou...
Rozšiřování DQL
Rozšiřování DQL
● TreeWalker - může modifikovat AST
● output SqlWalker - generuje samotný SQL dotaz
● vlastní funkce
TreeW...
Rozšiřování DQL: limitace
● Gramatika je jasně definovaná, není možné to nijak ohackovat
● Tree Walker může modifikovat vý...
Rozšiřování DQL: co jde
Kam nemůže DQL
SELECT order.finishedTime IS NULL AS something
FROM ...;
Tam musí funkce
SELECT IS_...
Rozšiřování DQL: vlastní funkce
class IsNull extends FunctionNode {
private $expression;
public function getSql(SqlWalker ...
SELECT employee,
AVG(salary) OVER (PARTITION BY employee.department) AS avgSalary
FROM MyEmployee employee;
SELECT employe...
Rozšiřování DQL: existující knihovny
● oro/doctrine-extensions (MySQL, PostgreSQL)
● opsway/doctrine-dbal-postgresql (Post...
Ukázka, jak jedna z knihoven řeší speciální operátory v PostgreSQL.
Hydratace
Druhy hydratace
● entity
○ ORMQuery::getResult();
● scalar + entity (mixed results)
○ ORMQuery::getResult();
● array - vyt...
Native queries
$rsm = new ResultSetMappingBuilder($em);
$rsm->addRootEntityFromClassMetadata(OrderItem::class, 'order_item...
Shrnutí: co si z toho odnést?
● Logika v modelu dokud to jenom trochu jde
● Nebát se využívat hojně vlastní typy
● Rozšiřo...
Dotazy?
Díky za pozornost!
@ProchazkaFilip
#makeCodeNotWar
Díky za pozornost!
@ProchazkaFilip
#makeCodeNotWar
Upcoming SlideShare
Loading in …5
×

of

Doctrine: co dělat, když entity nestačí Slide 1

YouTube videos are no longer supported on SlideShare

View original on YouTube

Doctrine: co dělat, když entity nestačí Slide 3 Doctrine: co dělat, když entity nestačí Slide 4 Doctrine: co dělat, když entity nestačí Slide 5 Doctrine: co dělat, když entity nestačí Slide 6 Doctrine: co dělat, když entity nestačí Slide 7 Doctrine: co dělat, když entity nestačí Slide 8 Doctrine: co dělat, když entity nestačí Slide 9 Doctrine: co dělat, když entity nestačí Slide 10 Doctrine: co dělat, když entity nestačí Slide 11 Doctrine: co dělat, když entity nestačí Slide 12 Doctrine: co dělat, když entity nestačí Slide 13 Doctrine: co dělat, když entity nestačí Slide 14 Doctrine: co dělat, když entity nestačí Slide 15 Doctrine: co dělat, když entity nestačí Slide 16 Doctrine: co dělat, když entity nestačí Slide 17 Doctrine: co dělat, když entity nestačí Slide 18 Doctrine: co dělat, když entity nestačí Slide 19 Doctrine: co dělat, když entity nestačí Slide 20 Doctrine: co dělat, když entity nestačí Slide 21 Doctrine: co dělat, když entity nestačí Slide 22 Doctrine: co dělat, když entity nestačí Slide 23 Doctrine: co dělat, když entity nestačí Slide 24 Doctrine: co dělat, když entity nestačí Slide 25 Doctrine: co dělat, když entity nestačí Slide 26 Doctrine: co dělat, když entity nestačí Slide 27 Doctrine: co dělat, když entity nestačí Slide 28 Doctrine: co dělat, když entity nestačí Slide 29 Doctrine: co dělat, když entity nestačí Slide 30 Doctrine: co dělat, když entity nestačí Slide 31 Doctrine: co dělat, když entity nestačí Slide 32 Doctrine: co dělat, když entity nestačí Slide 33 Doctrine: co dělat, když entity nestačí Slide 34 Doctrine: co dělat, když entity nestačí Slide 35 Doctrine: co dělat, když entity nestačí Slide 36
Upcoming SlideShare
Kdyby/Redis
Next
Download to read offline and view in fullscreen.

0 Likes

Share

Download to read offline

Doctrine: co dělat, když entity nestačí

Download to read offline

Ukážeme si, že Doctrine není jenom ORMko a kdy jít o vrstvu níž. Jak DQL naučit věci, které v základu neumí, ale vaše databáze ano. A pár dalších tipů, jak nemít z databáze úplně hloupé úložiště.

Related Books

Free with a 30 day trial from Scribd

See all

Related Audiobooks

Free with a 30 day trial from Scribd

See all
  • Be the first to like this

Doctrine: co dělat, když entity nestačí

  1. 1. Doctrine: Co dělat, když entity nestačí? @ProchazkaFilip #makeCodeNotWar
  2. 2. Co si povíme? ● minimum využití databáze každého Doctrinisty ● batch operace ● rozšiřování DQL ● metody hydratace ● native queries #makeCodeNotWar
  3. 3. Minimum využití databáze každého Doctrinisty
  4. 4. Minimum využití databáze každého Doctrinisty ● Co za vás dělá Doctrine ○ indexy pro vazby a primární klíče ○ vzdálené klíče ● Co si musíte pohlídat sami ○ unique indexy ○ vlastní typy Pokud se bavíme o nedělání hloupého úložiště z databáze, tak logicky chceme využívat funkce co databáze nabízí. Takový úplný základ jsou indexy a vzdálené klíče. O trochu pokročilejší jsou pak unikátní klíče a vlastní datové typy.
  5. 5. Indexy a vzdálené klíče class User { /** * @ORMId() * @ORMColumn(type="uuid") */ private $id; class Order { /** * @ORMManyToOne(targetEntity=User::class) * @ORMJoinColumn(nullable=false) */ private $user; IDčko musíme entitě dát vždy, jinak ji Doctrine nepřijme - tím získáme primární klíče. Když pak děláme vazby pomocí *ToMany nebo *ToOne vazeb, generuje nám Doctrine i vzdálené klíče, k nim indexy a klidně i many to many tabulky.
  6. 6. Unique indexy class User { /** * @ORMColumn(type="string", unique=true) */ private $email; Nejjednodušší způsob, jak získat unique klíče, je použít unique vlastnost annotace Column. Doctrine nám pak vygeneruje adektávní schéma.
  7. 7. Unique indexy /** * @ORMEntity() * @ORMTable(name="order_item_rating", * uniqueConstraints={ * @ORMUniqueConstraint(name="order_item_rating_x_unique", columns={ * "order_item_id", "user_id" * }) * } * ) */ class OrderItemRating Malinko složitější je pak udělat unikátní klíče nad vícero sloupci.
  8. 8. Unique indexy: vkládání a race conditions ● Opravdu to potřebujete řešit? ○ >90% aplikacím stačí check přes repository před flushem ○ >90% aplikací nikdy nenaroste natolik, aby to byl skutečný problém ● Pokud to opravdu opravdu potřebujete řešit ○ kdyby/doctrine ... NonLockingUniqueInserter ○ ^ brzy i samostatně, jako kdyby/doctrine-nonlocking-unique-inserter ○ ^ Symfony friendly ❤ ○ ^ sledujte issue kdyby/doctrine#238 S unikátními klíči souvisí řešení race conditions. EntityManager se při flushnutí entity, která poruší unique index, kompletně zamkne a není možné s ním dál pracovat. Pro 90% aplikací stačí prostý check repozitářem, že takový záznam v databázi neexistuje. Pokud to však opravu potřebujete řešit, koukněte na issue https://github.com/Kdyby/Doctrine/issues/238, kde se řeší rozdělení Kdyby/Doctrine na framework-agnostic balíčky. Brzy totiž vznikne například kdyby/doctrine- nonlocking-unique-inserter, který tento problém řeší.
  9. 9. Vlastní datový typ class UuidType extends Type { const NAME = 'uuid'; function getName() { return self::NAME; } function getSQLDeclaration( array $fieldDeclaration, AbstractPlatform $platform); function convertToPHPValue( $value, AbstractPlatform $platform); function convertToDatabaseValue( $value, AbstractPlatform $platform); Zdroj: ramsey/uuid-doctrine Pěkný příklad vlastního typu je UuidType z balíčku ramsey/uuid-doctrine. Viz http://docs.doctrine-project.org/en/latest/cookbook/custom-mapping-types.html
  10. 10. Vlastní datový typ: komentáře ve schématu class SomethingBasedOnStringType extends StringType { function requiresSQLCommentHint( AbstractPlatform $platform) : bool // … $platform->markDoctrineTypeCommented(Type::getType($type)); U vlastních typů je nutné řešit, aby byly správně oanotovány v databázi, protože jinak Doctrine neumí správně diffnout co se změnilo. Pokud však typ označíme, jakože se má komentovat, Doctrine si do komentáře sloupečku tabulky uloží jak se ten typ jmenuje a bude schéma diffovat správně.
  11. 11. Vlastní datový typ: konverze na úrovni DB class GeometryType extends Type { function canRequireSQLConversion() : bool; function convertToDatabaseValueSQL( $sqlExpr, AbstractPlatform $platform); function convertToPHPValueSQL( $sqlExpr, $platform); Pokud budete potřebovat pokročilou konverzi binárních dat už na úrovni databáze, slouží k tomu tyto metody.
  12. 12. Vlastní datový typ: registrace doctrine: dbal: types: uuid: class: RamseyUuidDoctrineUuidType Zdroj: ramsey/uuid-doctrine Ukázka registrace vlastního typu v Symfony.
  13. 13. Vlastní datový typ: použití /** * @ORMId() * @ORMColumn(type="uuid") */ private $id; CREATE TABLE "user" ( id UUID NOT NULL, email VARCHAR(255) DEFAULT NULL -- atd ); COMMENT ON COLUMN "user".id IS '(DC2Type:uuid)'; Při použití uuid typu na sloupci id se vygeneruje podobné schéma, jako je v pravo.
  14. 14. Logika v databázi vs Logika v modelu Premature optimization is the root of all evil ~ Donald Knuth O tom, jestli patří logika do databáze nebo do modelu můžeme klidně dál vést svaté války, ale v momentě kdy si jednu z cest zvolíte, měli byste ji co nejstriktněji dodržovat. Já volím logiku v modelu a to znamená, že logice v databázi se budu vyhýbat dokud to bude možné.
  15. 15. Batch operace
  16. 16. Batch operace s DQL “UPDATE/DELETE statements are ported directly into a Database statement and therefore bypass any locking scheme, events and do not increment the version column. Entities that are already loaded into the persistence context will NOT be synced with the updated database state. It is recommended to call EntityManager#clear() and retrieve new instances of any affected entity.” ~ Dokumentace Dávejte si pozor, pokud píšete SQL, ale i DQL update a delete dotazy, protože Doctrine nemá jak kontrolovat zamykání a nemá jak poznat, které entity obnovit v paměti. Pokud tedy něco takového pustíte, je doporučováno následně vyčistit entity z paměti a načíst si je znovu.
  17. 17. Batch operace s DQL ● Zkuste nejprve chytřejší způsoby iterace nad výsledkem ○ ORMQuery::iterate(); ○ Stránkování ● Raději DQL update, než SQL update ● Neumí JOINy :( Předtím než se uchýlíme k DQL updatu, tak je vhodné nejprve zkusit, jestli by nestačilo udělat nějakou chytřejší iteraci nad daty. Buď tedy nějaké custom stránkování výsledků, nebo použití metody iterate(), která umí hydratovat entity postupně a snižujeme tím šanci, že nám dojde paměť, ikdyž potřebujeme zpracovat miliony entit. Jedna z nevýhod ale je, že UPDATE ani DELETE neumí JOIN.
  18. 18. Batch operace s DQL $select = $em->createQueryBuilder() ->addSelect('orderItem.price') ->from(OrderItem::class, 'orderItem') ->andWhere('orderItem.order = theOrder.id'); $update = $em->createQueryBuilder() ->update(Order::class, 'theOrder') ->set('theOrder.totalPrice', sprintf('(%s)', $select)) ->getQuery(); Ovšem to že neumí JOINy se dá celkem snadno řešit pomocí subselectů.
  19. 19. Batch operace s DQL UPDATE "order" SET total_price = ( SELECT SUM(o0_.price) AS dctrn__1 FROM order_item o0_ WHERE o0_.order_id = order.id ) Výraz na minulém slidu by měl vygenerovat SQL podobné tomuto.
  20. 20. Batch operace s DBAL ● $connection->prepare('UPDATE ...'); ● $connection->createQueryBuilder(); Občas se nejde vyhnout použití SQL na batch operace a pokud to opravdu dává smysl, tak není důvod kvůli tomu skřípat zuby. Práci by vám mohl usnadnit chudší bratříček DibiFluent, tedy QueryBuilder v DBAL.
  21. 21. Rozšiřování DQL
  22. 22. Rozšiřování DQL ● TreeWalker - může modifikovat AST ● output SqlWalker - generuje samotný SQL dotaz ● vlastní funkce TreeWalker umí modifikovat načtenou strukturu DQL dotazu do stromu objektů, které ho reprezentují (AST) a modifikovat jej. Output SqlWalker umí převést AST na SQL a když si tento výchozí podědíte, můžete si změnit způsob jakým se výsledné SQL z AST DQLka skládá.
  23. 23. Rozšiřování DQL: limitace ● Gramatika je jasně definovaná, není možné to nijak ohackovat ● Tree Walker může modifikovat výsledné AST, ale opět nezmění gramatiku ● SqlWalker to nemá jak zachránit
  24. 24. Rozšiřování DQL: co jde Kam nemůže DQL SELECT order.finishedTime IS NULL AS something FROM ...; Tam musí funkce SELECT IS_NULL(order.finishedTime) AS something FROM ...; Funkce je ovšem možné doplnit téměř kamkoliv a chybějící syntax tedy ve výsledku není problém, protože identickou funkcionalitu snadno doplníme.
  25. 25. Rozšiřování DQL: vlastní funkce class IsNull extends FunctionNode { private $expression; public function getSql(SqlWalker $sqlWalker) { return $sqlWalker->walkArithmeticPrimary($this->expression) . ' IS NULL'; } public function parse(Parser $parser) { $parser->match(Lexer::T_IDENTIFIER); $parser->match(Lexer::T_OPEN_PARENTHESIS); $this->expression = $parser->ArithmeticPrimary(); $parser->match(Lexer::T_CLOSE_PARENTHESIS); } Vlastní funkce do DQL musí mít minimálně metodu parse(), která tokeny v DQL převede na node v AST a funkci getSql() která zpracovaný node převede na SQL.
  26. 26. SELECT employee, AVG(salary) OVER (PARTITION BY employee.department) AS avgSalary FROM MyEmployee employee; SELECT employee, WINDOW_OVER(AVG(salary), employee.department) AS avgSalary FROM MyEmployee employee; SELECT employee, WINDOW(AVG(salary) OVER (PARTITION BY employee.department)) AS avgSalary FROM MyEmployee employee; Rozšiřování DQL: komplexnější syntaxe První ukázka AFAIK není možná docílit, protože mění syntaxi DQL, druhá a třetí ale je, protože naše speciální syntax je obalená do custom funkce.
  27. 27. Rozšiřování DQL: existující knihovny ● oro/doctrine-extensions (MySQL, PostgreSQL) ● opsway/doctrine-dbal-postgresql (PostgreSQL) ● beberlei/DoctrineExtensions (MySQL, Oracle) ● syslogic/doctrine-json-functions (MySQL) ● další na: https://packagist.org/search/?q=dql Pár zajímavých balíčků, kde jsou již naimplementovány užitečné funkce do DQL.
  28. 28. Ukázka, jak jedna z knihoven řeší speciální operátory v PostgreSQL.
  29. 29. Hydratace
  30. 30. Druhy hydratace ● entity ○ ORMQuery::getResult(); ● scalar + entity (mixed results) ○ ORMQuery::getResult(); ● array - vytvoří strukturu jako pro entity a tu vrátí ○ ORMQuery::getArrayResult(); ● scalar - přejmenuje sloupce na fieldy a přetypuje ○ ORMQuery::getScalarResult(); Né vždy je potřeba hydratovat entity, když bych z nich zase mapoval hned pole, protože je chci jen číst. Dávejte si ale pozor na vracení výsledků z databáze rovnou jako struktury z API, změnou entit a nebo dotazu si tak snadno rozbijete kompatibilitu API.
  31. 31. Native queries $rsm = new ResultSetMappingBuilder($em); $rsm->addRootEntityFromClassMetadata(OrderItem::class, 'order_item') $connection->createQueryBuilder() ->addSelect($rsm->generateSelectClause()) ->from(...) $em->createNativeQuery($sql, $rsm) Pokud potřebujete opravdu složité filtrační dotazy, které ale chcete zpracovávat jako entity, můžete použít Native Queries, které umožňují napsat libovolné SQL a převést výsledek na entity, stejně jako by to dělala Doctrine.
  32. 32. Shrnutí: co si z toho odnést? ● Logika v modelu dokud to jenom trochu jde ● Nebát se využívat hojně vlastní typy ● Rozšiřování DQL je snadné ● Doctrine není určená na batch operace Kam dál? ● Youtube kanál “Nette Framework” > search “Doctrine”
  33. 33. Dotazy?
  34. 34. Díky za pozornost! @ProchazkaFilip #makeCodeNotWar
  35. 35. Díky za pozornost! @ProchazkaFilip #makeCodeNotWar

Ukážeme si, že Doctrine není jenom ORMko a kdy jít o vrstvu níž. Jak DQL naučit věci, které v základu neumí, ale vaše databáze ano. A pár dalších tipů, jak nemít z databáze úplně hloupé úložiště.

Views

Total views

1,559

On Slideshare

0

From embeds

0

Number of embeds

4

Actions

Downloads

10

Shares

0

Comments

0

Likes

0

×