Flutter Mimir는 Flutter 애플리케이션을 위한 반응형 NoSQL 데이터베이스로, 강력한 오타 유연성 있는 전체 텍스트 검색과 선언적 쿼리 구문을 제공합니다. 실시간 데이터 동기화와 여러 플랫폼에서 효율적인 로컬 저장을 가능하게 합니다. 직관적인 API와 내장된 검색 기능을 통해 동적 데이터 세트를 관리하는 것을 간소화하면서도 성능과 반응성을 유지합니다. 빠르고 검색 가능한 반응형 데이터 처리가 필요한 앱에 적합합니다.
사용 사례
실시간 메모 앱
검색 가능한 작업 관리자
콘텐츠 중심 모바일 앱
오프라인 우선 애플리케이션
개인화된 추천 시스템
주요 기능
오타를 수용하는 전체 텍스트 검색
선언적 쿼리 구문
반응형 데이터 업데이트
크로스 플랫폼 지원
로컬 지속 저장소
적합한 대상
반응형 앱을 개발하는 개발자
강력한 검색 기능이 필요한 앱
오프라인 데이터 지속성을 필요로 하는 프로젝트
간단한 NoSQL 통합을 원하는 팀
동적 콘텐츠를 가진 플러터 앱
고려 사항
새로운 쿼리 패턴을 배워야 할 수 있습니다
대규모 데이터 세트는 성능에 영향을 미칠 수 있습니다
성숙한 데이터베이스와 비교해 문서가 제한적임
복잡한 관계 연산에 적합하지 않습니다
초기 설정에서는 구성 조정이 필요할 수 있습니다
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
A batteries-included NoSQL database for Dart & Flutter based on an embedded
Meilisearch instance.
Features
🔎 Typo tolerant and relevant full-text search with no extra configuration needed
🔥 Blazingly fast search and reads (written in Rust)
🤝 Flutter friendly with a super easy-to-use API (see demo below!)
With Flutter, you can get started with as little as:
// Get an "index" to store our moviesfinal instance = awaitMimir.defaultInstance;
final index = instance.getIndex('movies');
// Add movies to our indexawait index.addDocuments(myMovies);
// Perform a search!final results = await index.search(query: 'jarrassic par'); // returns Jurassic Park!
A collection of commonly used APIs ready for copy-paste into your application.
Note: unless otherwise stated, all asynchronous methods exposed in Mimir are fallible
and synchronous methods are infallible.
The methods are fail-fast, so you should be aware of any issues early on during development.
Getting & Creating an Index
// With Flutter (flutter_mimir)final instance = awaitMimir.defaultInstance;
// Dart-only (just mimir)final instance = awaitMimir.getInstance(path: instanceDirectory);
// Get an index (creates one lazily if not already created)final index = instance.getIndex('movies');
// Or, specify some default settings and open the index eagerly// If you have some settings you want to specify in advance, use openIndex!final index = await instance.openIndex('movies', primaryKey: 'CustomIdField');
Configuring an Index
await index.updateSettings(
// The primary key (PK) is the "ID field" of documents added to mimir.// When null, it is automatically inferred for you, but sometimes you may// need to specify it manually. See the Important Caveats section for more.
primaryKey: null,
// Fields in documents that are included in full-text search.// Use null, the default, to search all fields
searchableFields: <String>[],
// Fields in documents that can be queried/filtered by.// You probably don't need to change this; it is automatically// updated for you.
filterableFields: <String>[],
// Fields in documents that can be sorted by in searches/queries.// You probably don't need to change this; it is automatically// updated for you.
sortableFields: <String>[],
// The ranking rules of this index, see:// https://docs.meilisearch.com/reference/api/settings.html#ranking-rules
rankingRules: <String>[],
// The stop words of this index, see:// https://docs.meilisearch.com/reference/api/settings.html#stop-words
stopWords: <String>[],
// A list of synonyms to link words with the same meaning together.// Note: in most cases, you probably want to add synonyms both ways, like below:
synonyms: <Synonyms>[
(
word: 'automobile',
synonyms: ['vehicle'],
),
(
word: 'vehicle',
synonyms: ['automobile'],
),
],
// Whether to enable typo tolerance in searches.
typosEnabled: true,
// The minimum size of a word that can have 1 typo.// See minWordSizeForTypos.oneTypo here:// https://docs.meilisearch.com/reference/api/settings.html#typo-tolerance-object
minWordSizeForOneTypo: 5,
// The minimum size of a word that can have 2 typos.// See minWordSizeForTypos.twoTypos here:// https://docs.meilisearch.com/reference/api/settings.html#typo-tolerance-object
minWordSizeForTwoTypos: 9,
// Words that disallow typos. See disableOnWords here:// https://docs.meilisearch.com/reference/api/settings.html#typo-tolerance-object
disallowTyposOnWords: <String>[],
// Fields that disallow typos. See disableOnAttributes here:// https://docs.meilisearch.com/reference/api/settings.html#typo-tolerance-object
disallowTyposOnFields: <String>[],
);
Manipulating Documents
// Adding documents (replaces any documents with the same id)await index.addDocument(document);
await index.addDocuments(documents);
// Replacing all documentsawait index.setDocuments(documents);
// Deleting documentsawait index.deleteDocument(id);
await index.deleteDocuments(ids);
await index.deleteAllDocuments();
// Getting documents (not querying--see next section!)final docOrNull = await index.getDocument(someId);
final allDocs = await index.getAllDocuments();
final allDocsStream = index.documents;
Searching/Querying
// Getting a stream of results (very useful in Flutter!)// Same arguments as index.search; see belowfinal documentsStream = index.searchStream(...);
// Performing a search/query (using movies here)!final movies = index.search(
// The string to use for full-text search. Can be user-supplied.// To do a regular database query without full-text search, leave this null.
query: 'some wordz with typoes to saerch for',
// The filter used to filter results in a full-text search or query.// See the next section; this is a very handy feature in mimir.// Set to null to not filter out any documents.
filter: Mimir.where('director', isEqualTo: 'Alfred Hitchcock'),
// The fields to sort by (in ascending or descending order).// Can be left as null to sort by relevance (to the query text)!
sortBy: [
// Sort by year, newest to oldestSortBy.desc('year'),
// In case 2+ documents share the same year, sort by increasing profit nextSortBy.asc('profit'),
],
// If you want to limit the number of results you get, use the resultsLimit.// Defaults to null, which means return all matches.
resultsLimit: null,
// Defaults to null, see https://docs.meilisearch.com/reference/api/search.html#matching-strategy
matchingStrategy: null,
);
Filtering Search/Query Results
Here are the methods you need to be aware of:
Mimir.or(subFilters) creates an "or" filter (like ||) of the sub-filters
Mimir.and(subFilters) creates an "and" filter (like &&) of the sub-filters
Mimir.not(subFilter) creates a "not" filter (like !someCondition) of the sub-filter
Mimir.where(condition) creates a single filter from a given condition.
The above can be composed together to create powerful, declarative queries!
Say our Dart boolean logic is (formatted to show intent):