Таны Симфони-ийн програмын тийрэлтэт бутлуур: Фрагментийн индекс, хязгааргүй UUIDs

Monolithic эрт нь, Энэ нь хялбар, жижиг (4 байт) бөгөөд байтугай хуваалцсан юм. Гэхдээ бид дистрибутирован систем, микрослужб, өндөр өрсөлдөөнтэй API-ийг харахын тулд, целой ID-ийг харах эхэлсэн. Энэ нь бизнесийн шинжлэх ухааны тоноглогдсон юм (конкуренторууд таны хүчдэлийн мэдрэмж болно), энэ нь мэдээллийн санг цуглуулах / хуваалцах нь хязгаарлагддаг бөгөөд энэ нь шинэ зүйлсийг мэдэхийн тулд мэдээллийн санд харах хэрэгтэй. id INT AUTO_INCREMENT Бүтээгдэхүүний ихэнх програмууд нь тэд энэ компонент санал болгож буй архитектур уян хатан хязгаарладаг. Энэ гарын авлагад бид in Symfony 7.3, moving beyond basic generation to tackle database fragmentation, cursor-based pagination and deterministic idempotency. “let’s just use UUID v4” symfony/uid Сургалтын & шаардлага Бид ашиглаж байна (Модерны 7.x шинж чанарыг хангахын тулд) . Symfony 7.3 Doctrine ORM 3 Ямар ч Дараа нь дараах зангуудыг харуулж байна. Бид строго хэрэглэдэг Энэ нь . composer.json symfony/uid Doctrine integration composer require symfony/uid symfony/doctrine-bridge doctrine/orm Бүтээгдэхүүний үзүүлэлт: UUID v7 Шинэ Symfony апп-ийн найдвартай алдаа нь Энэ нь . UUID v4 primary key Эдүүлбэр: Index Fragmentation UUID v4 нь бүрэн хязгаарлагдмал юм. Та хязгаарлагдмал ID-ийг MySQL / PostgreSQL clustered индекс (B-Tree) руу суулгах үед, өгөгдлийн сан нь шинэ хуудас индексний "сүүлд" суулгах хэрэгтэй. Энэ нь , Тавтай морилно уу, Тавтай морилно уу, Тавтай морилно уу. massive page splitting and fragmentation Албан ёсны: UUID v7 UUID v7 (RFC 9562-д стандартизирован, Symfony 7.x-д бүрэн дэмждэг) хязгаарлагдмал өгөгдөл. Энэ нь тэд Тэд B-Tree-ийн эцэст дээр, автомашины нэмэлт цэцэрлэг шиг, харин UUID-ийн өвөрмөц байдал, хуваалцсан байгалийн хадгалж байна. Unix timestamp (millisecond precision) strictly monotonic Үйлчилгээ Доктрин дээр итгэхгүй Маги, энэ нь ихэвчлэн v4 дээр суурилсан юм. Үнэндээ, конструкторын ID-ийг эхлэх. Энэ нь ID-ийг flush-ээс өмнө боломжтой бөгөөд "Persistence Ignorant" суурь үүсгэдэг. @GeneratedЦентрал @GeneratedЦентрал //src/Entity/Transaction.php namespace App\Entity; use Doctrine\ORM\Mapping as ORM; use Symfony\Component\Uid\Uuid; use Symfony\Component\Uid\UuidV7; #[ORM\Entity] #[ORM\Table(name: 'transactions')] class Transaction { #[ORM\Id] #[ORM\Column(type: 'uuid', unique: true)] private Uuid $id; #[ORM\Column(type: 'string', length: 255)] private string $status; public function __construct(string $status) { // Explicitly generate v7 for time-ordered performance $this->id = new UuidV7(); $this->status = $status; } public function getId(): Uuid { return $this->id; } // ... getters and setters } Доктрины төрөл: автоматаар конвертийг боловсруулах. Үнэндээ, энэ нь (Хэвлэсэн) эсвэл (Эффектив) таны платформ тохиргооны дагуу. Өндөр томъёо системд үргэлж Doctrine-ийг ашиглахын тулд тохируулах Өнгөрсөн ID нь хадгалах газар. ‘uuid’ CHAR(36) BINARY(16) BINARY(16) save 55% Баримтлал Арилжаа үүсгэх: php bin/console make:migration SQL-ийг шалгах. Та ширээний тодорхойлолт үзнэ үү. DB-ийг шалгана уу; ID-ийг цуглуулж байх ёстой (Дараа нь эхний хэлбэр нь идентич байх болно). ULIDs ашиглан High-Performance Pagination Сайтын ашиглах Нөхцөл Бүтээгдэхүүний өгөгдөл нь хуваалцаж, хуваалцаж, хуваалцаж, хуваалцаж болно. , гэхдээ энэ нь ихэвчлэн тусгай, соролтгүй ширхэг хэрэгтэй ( TimeStamps нь ризиктай, учир нь хоёр үйл явдлыг тавтай морилноор нэг микросекунд хийж болно. OFFSET LIMIT Keyset Pagination (Cursor-based) created_at 128-битын харьцууламжтай ID нь Үнэгүй ULIDs (Universally Unique Lexicographically Sortable Identifier) lexicographically Стратегийн Бид A . ULIDs нь сортируудтай шугам бөгөөд бид зүгээр л хэлж чадна: ULID as the primary key "Идэвхжүүлэх 10 зүйлс нь ID > [Last Seen ULID]" //src/Entity/EventLog.php namespace App\Entity; use Doctrine\ORM\Mapping as ORM; use Symfony\Component\Uid\Ulid; #[ORM\Entity(repositoryClass: \App\Repository\EventLogRepository::class)] class EventLog { #[ORM\Id] #[ORM\Column(type: 'ulid', unique: true)] private Ulid $id; #[ORM\Column(type: 'text')] private string $payload; public function __construct(string $payload) { $this->id = new Ulid(); $this->payload = $payload; } public function getId(): Ulid { return $this->id; } } //src/Repository/EventLogRepository.php namespace App\Repository; use App\Entity\EventLog; use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository; use Doctrine\Persistence\ManagerRegistry; use Symfony\Component\Uid\Ulid; class EventLogRepository extends ServiceEntityRepository { public function __construct(ManagerRegistry $registry) { parent::__construct($registry, EventLog::class); } /** * @return EventLog[] */ public function findAfterCursor(?Ulid $cursor, int $limit = 20): array { $qb = $this->createQueryBuilder('e') ->orderBy('e.id', 'ASC') ->setMaxResults($limit); if ($cursor) { // Efficient index seek $qb->andWhere('e.id > :cursor') ->setParameter('cursor', $cursor->toBinary()); // Note: Depending on your DB type setup, you might pass the object or binary. // The symfony bridge usually handles the object, but explicit binary prevents ambiguity. } return $qb->getQuery()->getResult(); } } Энэ асуултууд нь Primary Key индекс дээр шууд удаан. Энэ нь Комплекс, Хэрэв та хуудас 1 эсвэл хуудас 1,000,000 байна. Why this matters? O(1) Idempotence & Deterministic IDs (UUID v5) Хэвлэсэн системд (жишээ нь, CQRS, Event Sourcing), танд ихэвчлэн хоёр удаа (түүнээс дээш нэг удаа хүргэх) нэг и-мэйл хүлээн авах болно. Та импортын үйл явцыг боловсруулсан бүх удаа хатуу ID үүсгэдэг бол та дубликат үүсгэдэг. Энэ нь deterministic юм. A А (Input string), энэ нь хэзээ ч нэг UUID үүсгэдэг. UUID v5 Namespace Name Сценарий: CSV-ээс бүтээгдэхүүний импортын Та SKU-ийг, харин UUID-ийг агуулсан эртний системээс бүтээгдэхүүнийг импортын байна. Та импортын скрипт хоёр удаа ажиллуулахын тулд дупликат жагсаалтыг үүсгэхгүй, одоогийн "идэвхжүүлэлт" шинэчлэхыг хүсэж байна. //src/Service/ProductIdGenerator.php namespace App\Service; use Symfony\Component\Uid\Uuid; class ProductIdGenerator { // A random UUID v4 constant serving as our private Namespace // Generated once via `php bin/console uuid:generate` private const PRODUCT_NAMESPACE = 'd2e294c8-3829-410e-8baf-7359a58f7051'; public function generateForSku(string $sku): Uuid { // v5 uses SHA-1 hashing to ensure uniqueness based on input return Uuid::v5(Uuid::fromString(self::PRODUCT_NAMESPACE), $sku); } } Usage in a Command: // Inside a command or service $sku = 'WIDGET-ABC-123'; $deterministicId = $this->idGenerator->generateForSku($sku); // $deterministicId will ALWAYS be '...' for SKU 'WIDGET-ABC-123' // You can now safely use: // $em->getReference(Product::class, $deterministicId); Vanity URLs: Эрэгтэйчүүдэд зориулсан UIDs shortening Эдүүлбэр ( ) URL-ийн богино юм. YouTube Base64/Base58 ашигладаг. Symfony Uid нь суурилсан дэмжлэгтэй байна (Bitcoin хэлбэр, 0 / O, I / l гэх мэт хязгааргүй хэлбэр) болон . 123e4567-e89b-12d3-a456–426614174000 Base58 Base32 Бид үүсгэдэг Энэ нь JSON хариу илгээх үед UID-ийг Base58-д автоматаар конвертуулдаг, асуултуудыг хүлээн авах үед UUID-ийг өгдөг. Symfony Serializer Normalizer // src/Serializer/UuidBase58Normalizer.php namespace App\Serializer; use Symfony\Component\Serializer\Normalizer\DenormalizerInterface; use Symfony\Component\Serializer\Normalizer\NormalizerInterface; use Symfony\Component\Uid\Uuid; use Symfony\Component\DependencyInjection\Attribute\Autowire; class UuidBase58Normalizer implements NormalizerInterface, DenormalizerInterface { public function normalize(mixed $object, ?string $format = null, array $context = []): string|array { /** @var Uuid $object */ return $object->toBase58(); } public function supportsNormalization(mixed $data, ?string $format = null, array $context = []): bool { return $data instanceof Uuid; } public function denormalize(mixed $data, string $type, ?string $format = null, array $context = []): Uuid { // Automatically handle incoming Base58 strings back to UUID objects return Uuid::fromBase58($data); } public function supportsDenormalization(mixed $data, string $type, ?string $format = null, array $context = []): bool { return is_string($data) && is_a($type, Uuid::class, true); } public function getSupportedTypes(?string $format): array { return [ Uuid::class => true, ]; } } The Result: Базар: 16 байтын бинар нь optimized Store. API Ангилал: {“id”: “BukQLMwS8W5g32”} (Хэвч, copy-pasteable). API Request: Клиент BukQLMwS8W5g32 илгээж, Symfony энэ нь өгөгдлийн асуултанд зөв UUID-д хувиргадаг. Тест: Непредсказуемаар ялах UUID-ийг туршиж мэдэгддэг хэцүү байдаг, учир нь Миллисекунд өөрчилж байна. Symfony 7 нь Энэ нь шийдэх. Uuid::v7() MockUuidFactory // tests/Service/TransactionTest.php namespace App\Tests\Service; use PHPUnit\Framework\TestCase; use Symfony\Component\Uid\Factory\MockUuidFactory; use Symfony\Component\Uid\Uuid; use Symfony\Component\Uid\UuidV7; class TransactionTest extends TestCase { public function testItGeneratesPredictableIds(): void { // Define a sequence of IDs the factory should return $expectedId1 = Uuid::fromString('018e69c0-1c00-7c22-b9d6-5c4d00000001'); $expectedId2 = Uuid::fromString('018e69c0-1c00-7c22-b9d6-5c4d00000002'); $factory = new MockUuidFactory([$expectedId1, $expectedId2]); // In your real service, you would inject UuidFactory and use it // $service = new TransactionService($factory); // Simulating usage: $id1 = $factory->create(); $id2 = $factory->create(); $this->assertTrue($id1->equals($expectedId1)); $this->assertTrue($id2->equals($expectedId2)); } } Энэ үйл ажиллагаа нь таны програмын кодд хийхын тулд, та Таны үйлчилгээг ашиглах бол Хэрэв та нарийн туршилтын шаардлагатай бол. Symfony\Component\Uid\Factory\UuidFactory new UuidV7() Бенчмарк Бүтээгдэхүүний үр дүнтэй үр нөлөө нь Нөхцөл , бид өгөгдлийн "Page Splitting" нөлөө хэмнэх хэрэгтэй. Хязгаарлалт ID нь өгөгдлийн B-Tree индекс нь үргэлжлүүлэхийн тулд буцаж, Monotonic ID нь эцсийн дээр холбогдсон. UUID v7 (Monotonic) UUID v4 (Random) This benchmark requires: PhpBench суулгах (composer require — dev phpbench/phpbench). Ажлын MySQL/MariaDB инстанц (.env-д тодорхойлогдсон). Энэ файлыг үүсгэхийн тулд Энэ скрипт Symfony Kernel-ийг суулгахын тулд өгөгдлийн холболт авахын тулд суулгах, хавтгай дөрвөлжин байлгах, дараа нь зэвэрдэггүй суулгах хурдыг хэмнэх болно. benchmark/UuidInsertBench.php // benchmark/UuidInsertBench.php namespace App\Benchmark; use App\Kernel; use Doctrine\DBAL\Connection; use PhpBench\Attributes as Bench; use Symfony\Component\Dotenv\Dotenv; use Symfony\Component\Uid\Uuid; use Symfony\Component\Uid\UuidV7; #[Bench\BeforeMethods('setUp')] #[Bench\AfterMethods('tearDown')] class UuidInsertBench { private Connection $connection; private Kernel $kernel; public function setUp(): void { // Bootstrap Symfony to get the DB connection require_once __DIR__ . '/../vendor/autoload.php'; (new Dotenv())->bootEnv(__DIR__ . '/../.env'); $this->kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']); $this->kernel->boot(); $this->connection = $this->kernel->getContainer()->get('doctrine.dbal.default_connection'); // distinct tables to isolate index behavior $this->createTable('bench_uuid_v4'); $this->createTable('bench_uuid_v7'); // Seed with initial data to ensure the index has depth // Fragmentation issues only appear when the table isn't empty $this->seedTable('bench_uuid_v4', false); $this->seedTable('bench_uuid_v7', true); } /** * Scenario: Insert into a fragmented index (Random IDs) */ #[Bench\Revs(100)] #[Bench\Iterations(5)] public function benchInsertV4(): void { $uuid = Uuid::v4()->toBinary(); $this->connection->executeStatement( 'INSERT INTO bench_uuid_v4 (id, payload) VALUES (:id, :payload)', ['id' => $uuid, 'payload' => 'benchmark_payload'] ); } /** * Scenario: Insert into a sorted index (Monotonic IDs) */ #[Bench\Revs(100)] #[Bench\Iterations(5)] public function benchInsertV7(): void { $uuid = new UuidV7(); // Explicitly V7 $this->connection->executeStatement( 'INSERT INTO bench_uuid_v7 (id, payload) VALUES (:id, :payload)', ['id' => $uuid->toBinary(), 'payload' => 'benchmark_payload'] ); } private function createTable(string $tableName): void { $sql = connection->executeStatement($sql); // Truncate to ensure clean state per run if needed, // though for this test growing the table is part of the stress test. $this->connection->executeStatement("TRUNCATE TABLE $tableName"); } private function seedTable(string $tableName, bool $isV7): void { // Pre-fill 5,000 rows to create an initial B-Tree structure $sql = "INSERT INTO $tableName (id, payload) VALUES (:id, 'seed_data')"; $stmt = $this->connection->prepare($sql); for ($i = 0; $i toBinary() : Uuid::v4()->toBinary(); $stmt->bindValue('id', $id); $stmt->executeQuery(); } } public function tearDown(): void { $this->connection->executeStatement('DROP TABLE IF EXISTS bench_uuid_v4'); $this->connection->executeStatement('DROP TABLE IF EXISTS bench_uuid_v7'); } } Running the Benchmark: Таны терминал дээр дараах орлогдсон: # Allow 2GB memory for the seeding process if necessary php -d memory_limit=2G vendor/bin/phpbench run benchmark/UuidInsertBench.php --report=default Interpreting Results: Та энэ нь харьцуулахад харьцуулахад харьцуулахад харьцуулахад харьцуулахад харьцуулахад харьцуулана уу: +-----------------+-------+---------+----------+----------+---------+ | subject | revs | mem_peak| mode | mean | stdev | +-----------------+-------+---------+----------+----------+---------+ | benchInsertV4 | 100 | 14.20Mb | 850.12μs | 910.45μs | 55.12μs | | benchInsertV7 | 100 | 14.20Mb | 520.40μs | 535.10μs | 12.05μs | +-----------------+-------+---------+----------+----------+---------+ Хэрэв та энэ хамгийн бага дундаж хугацаатай бөгөөд маш их . Key Takeaway: benchInsertV7 lower standard deviation (stdev) Үзүүлэлт: V7 хурдан байна, учир нь мэдээллийн сан нь зүгээр л B-Tree-ийн богинонд хуудсууд хуудсууд. Stdev: V4 нь хязгаарлагдмал юм. Гэсэн хэдий ч энэ нь "хязгаарлагдмал" газруудыг харуулдаг боловч ихэвчлэн энэ нь "Page Split" -ийг үүсгэдэг (Дараа нь өгөгдлийн хоорондоо дамжуулах хязгаарлагдмал үйл ажиллагаа). Баримтлал Урт хугацааны турш, хөгжүүлэгчид мэдээллийн сан ID-ийг хялбар имплементацийн тодорхойлолт болгон ач холбогдолтой байна. out of habit or Бид үзсэн хэдий ч, энэ сонголт таны аппын фрагментаци, хуудсууд хурд, дистрибутировангүй байдал дээр уян хатан нөлөөтэй байдаг. AUTO_INCREMENT UUID v4 Symfony 7.3 болон Uid бүрэлдэхүүн хэсэг нь бид илүү компромис хийх хэрэгтэйгүй. Бид нь UID нь бүрэн тоо (UUID v7). Бид хязгаарлагдмал цаг хугацааны хэв маяг (ULID) харуулсангүйгээр. Бид бидэнтэй холбоо барина уу формат (Base58) бидний хадгаламжийн строго бинаргүй байлгах. distributed uniqueness insert performance cursor-based pagination human-friendly Эдгээр орчин үеийн стандартад өөрчлөх нь Symfony-ийн өсөлтийн хэрэглээнд хийж чадах хамгийн өндөр ROI-ийн рефакторүүдийн нэг юм. Энэ нь кодыг бага зардалтай боловч мэдээллийн сан, API-ийн хэрэгцээг зарладаг. Бид илүү сайн систем бий болгох Би тогтмол High-Performance Symfony архитектур, Доктрины интернал, дистрибутированные паттерны талаар бичдэг. Хэрэв та харьцуулахад харьцуулахад харьцуулана уу, эсвэл имплементийн талаар асуулт байгаа бол Таны Legacy Stack дээр: UUID v7 Холбоо барих: https://www.linkedin.com/in/matthew-mochalkin/ Сэтгэгдэл: Индекс фрагментацид талаар таны туршлагатай доор унтраах. https://www.linkedin.com/in/matthew-mochalkin/ Бид холбоо барина уу, стандарт дээр дарна уу.