ferretdb-quirks

Analyze FerretDB v2 MongoDB compatibility limitations and unsupported features.

1|Updated Feb 18, 2024
One-click install
npx skills add https://github.com/jhnhnck/attu-bot --skill ferretdb-quirks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ferretdb-quirks
Source: https://github.com/jhnhnck/attu-bot/tree/main/.claude/skills/ferretdb-quirks
Command: npx skills add https://github.com/jhnhnck/attu-bot --skill ferretdb-quirks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers and database administrators understand the limitations and divergences of FerretDB v2, ensuring accurate and safe integration with existing MongoDB-dependent workflows.

Core Features & Use Cases

  • Identify supported MongoDB features: Provides detailed insights into what aggregation, indexing, and query features are available or unsupported in FerretDB.
  • Troubleshoot footguns: Offers guidance on known issues like unimplemented transactions, change streams, or TTL indexes with integer timestamps.
  • Use Case: When adapting MongoDB scripts to FerretDB, users can consult this Skill to avoid unsupported operations like bulk writes or multi-document transactions, preventing runtime errors and data loss.

Quick Start

Ask the AI about FerretDB's support for transactions or index types to ensure compatibility before implementing database changes.

Frequently Asked Questions about ferretdb-quirks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Does FerretDB support multi-document transactions and change streams?

FerretDB lacks support for multi-document transactions and change streams. Developers must adapt MongoDB workflows to avoid these unimplemented features, preventing runtime errors and data loss when migrating database operations.

What are the limitations of FerretDB index support compared to MongoDB?

FerretDB index limitations include specific restrictions on index types and TTL index requirements, particularly regarding integer timestamps. Developers must verify index compatibility and use safe query patterns to avoid unsupported operations during database migration.

How do I migrate MongoDB scripts to FerretDB safely?

To migrate MongoDB scripts to FerretDB safely, analyze unsupported features like bulk writes and multi-document transactions, verify index restrictions, apply safe query patterns, and validate deployment compatibility to prevent runtime errors and data loss.

Why does my FerretDB TTL index fail with integer timestamps?

FerretDB TTL indexes have specific requirements and known divergences when using integer timestamps. This is a recognized quirk in MongoDB compatibility, requiring developers to adjust timestamp formats to ensure proper TTL index functionality.

Can I use bulk writes and unsupported aggregation features with FerretDB?

Bulk writes and certain aggregation features are unsupported in FerretDB. Developers should consult compatibility limitations to identify available query operations, apply safe query patterns, and avoid unsupported commands that cause deployment failures.

How do I verify MongoDB compatibility before deploying FerretDB?

Verify FerretDB compatibility by checking support for specific MongoDB features, identifying unimplemented transactions or change streams, reviewing index restrictions, and validating safe query patterns to ensure accurate integration with existing MongoDB-dependent workflows.