モノリズムの時代に、 それはシンプルで小さい(4バイト)と自然に分類されたものでしたが、分散型システム、マイクロサービス、競争の激しいAPIに向かって進むにつれて、インテルIDはその裂け穴を示し始めた。それはビジネスインテリジェンス(競合相手があなたのボリュームを推測できる)を漏らし、データベースの合併/シェアディングを複雑にし、新しいオブジェクトのアイデンティティティを知るためにデータベースへのツーリングが必要だ。 id INT AUTO_INCREMENT ほとんどの開発者が止まると、 彼らはこのコンポーネントが提供する建築の深さを欠いている。このガイドでは、私たちは高度な実装を探索します。 Symfony 7.3 では、データベースの断片化、カーソルベースのページ化、および決定主義的なアイデンティパワーを解決するために、基本的な生成を超えています。 “let’s just use UUID v4” symfony/uid インストール&前提条件 We are using (最新の 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アプリで最も一般的なミスは、 Aとして . UUID v4 primary key タグ: Index Fragmentation UUID v4 は完全にランダムです. ランダム ID を MySQL/PostgreSQL クラスターインデックス (B-Tree) に挿入すると、データベースは常に新しいページをインデックスの「中間」に挿入するためにツリーを再バランスしなければなりません。 テーブルが伸びるにつれ、殺しのパフォーマンスを挿入します。 massive page splitting and fragmentation ソリューション: UUID v7 UUID v7 (RFC 9562 で標準化され、Symfony 7.x で完全にサポートされている) は、 ランダムなデータで、これが 彼らは、自動増加整数のようにB木の末尾に挿入しますが、UUIDのユニーク性と分散性を保持します。 Unix timestamp (millisecond precision) strictly monotonic 実施 教義を信頼するな。 マジックは、しばしばデフォルトで v4 に設定されます。代わりに、ビルダー内の ID を初期化します. This creates a “Persistence Ignorant” entity where the ID is available before the flush. @GeneratedValueについて @GeneratedValueについて //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 を使用するように構成します。 2位 IDごとにストレージスペース ‘uuid’ CHAR(36) BINARY(16) BINARY(16) save 55% 検証 
 
 
 
 移行を生成する: php bin/console make:migration SQL を確認してください. 列を定義する必要があります。 テスト スクリプトを実行して 10 個のエンティティを作成します. Check the DB; the IDs should be sequentially increasing (the first characters will be identical). ULIDs による高パフォーマンスの Pagination ページ利用 そして データベースは、ページ100に到達するために数千行を数え、捨てなければならない。 , but this usually requires a unique, sortable column (such as タイムスタンプは、2つのイベントが同じマイクロ秒で起こる可能性があるため、リスクがあります。 OFFSET LIMIT Keyset Pagination (Cursor-based) created_at 128 ビット互換性のある識別子 ソリューション ULIDs (Universally Unique Lexicographically Sortable Identifier) lexicographically 戦略 We will use a ULIDs は分類可能な文字列であるため、我々 は単に言うことができます: ULID as the primary key 「ID > [Last Seen ULID] の 10 件を教えてください」 //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万ページかに関係なく。 Why this matters? O(1) Idempotence & Deterministic IDs(UUID v5) 分散型システム(例えば、CQRSまたはEvent Sourcing)では、同じメッセージを2回(少なくとも1回配信)受信する場合があります。 デリケート(A given a そしてA (入力文字列)、常に同じ UUID を生成します。 UUID v5 Namespace Name シナリオ:CSVから製品をインポートする SKU が含まれる古いシステムから製品をインポートしているが UUID がない場合は、インポート スクリプトを 2 回実行する場合、複数の行を作成するのではなく、既存の「アイデンティティ」を更新することを確認する必要があります。 //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: Shortening UIDs for Humans(ユーザのためのユーザIDの短縮) トップ > ( )は URL で醜い。YouTube は Base64/Base58 を使用しています。Symfony Uid は、 (ビットコインスタイル、0/O、I/lなどの曖昧な文字なし) . 123e4567-e89b-12d3-a456–426614174000 Base58 Base32 We can create a 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 バイト バイナリ 最適化ストア タイトルは「BukQLMwS8W5g32」です。 API リクエスト:クライアントは BukQLMwS8W5g32 を送信し、Symfony はデータベース クエリの正しい UUID に戻します。 タイトル : Mocking the Unpredictable UUIDsのテストは、知られざるほど難しく、なぜなら ミリ秒ごとに変化します. 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() ベンチマーク パフォーマンスの影響を示すために vs ランダム ID は、データベースに常に B-Tree インデックスを再バランスをとるように強制し、Monotonic ID は最後に付属します。 UUID v7 (Monotonic) UUID v4 (Random) This benchmark requires: 
 
 
 PhpBench がインストールされている (composer require — dev phpbench/phpbench) 実行中の MySQL/MariaDB インスタンス(.env で定義) このファイルを作成する at このスクリプトは、データベース接続を取得するために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 = <<<SQL
            CREATE TABLE IF NOT EXISTS $tableName (
                id BINARY(16) NOT NULL,
                payload VARCHAR(255),
                PRIMARY KEY(id)
            ) ENGINE=InnoDB; 
SQL;
        $this->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 < 5000; $i++) {
            $id = $isV7 ? (new UuidV7())->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」(データを移動するための高価な操作)を引き起こし、遅延のピークを引き起こします。 結論 長い間、開発者はデータベース識別子を単純な実装の詳細として扱ってきた。 習慣の外や、 私たちが目にしたように、この選択は、アプリケーションの断片化、ページ化速度、および分散された統合性に深い影響を及ぼします。 AUTO_INCREMENT UUID v4 Symfony 7.3 と Uid コンポーネントで、私たちはもはや妥協する必要はありません。 ☆☆☆☆☆☆☆☆☆ 整数(UUID v7)のうち、我々は ストレッチタイムスタンプ(ULID)を露出せず、当社のフロントエンドと通信できます。 フォーマット(Base58)は、私たちのストレージを厳密にバイナリーで保持します。 distributed uniqueness insert performance cursor-based pagination human-friendly これらの近代的な標準に切り替えることは、成長するSymfonyアプリケーションで実行できる最高のROI反応の1つです。 より良いシステムを構築しよう 私は高性能のシンフォニーアーキテクチャ、ドクトリンのインテリアル、および分散パターンについて定期的に書いています。 あなたのLegacy Stack: UUID v7 
 
 
 私と連絡する: https://www.linkedin.com/in/matthew-mochalkin/ 議論: インデックス分断に関するあなたの経験について、以下のコメントを落としてください。 https://www.linkedin.com/in/matthew-mochalkin/ コミュニケーションを保ち、基準を押し上げていきましょう。

Read My Stories

このオーディオは、ストーリーの元の言語で制作されています。

The Quiet Bottleneck in Your Symfony App: Fragmented Indexes and Random UUIDs(あなたのシンフォニーアプリの静かなボトルネック:断片化されたインデックスとランダム UUID)

About Author

コメント

ラベル

この記事は

Related Stories

ユニークなエコシステムを支えるビットコインUTXOのモデル

ワークフローを10倍に向上させる方法: 必須アプリ17選

Claude Sonnet 3.5 システムプロンプトの漏洩: 法医学的分析

Telegram: クリプト島と本土を結ぶ橋

ユニークなエコシステムを支えるビットコインUTXOのモデル

ワークフローを10倍に向上させる方法: 必須アプリ17選

Claude Sonnet 3.5 システムプロンプトの漏洩: 法医学的分析

Telegram: クリプト島と本土を結ぶ橋

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps