コンテンツにスキップ
Omnio-js
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

絞り込んで一覧する

メタデータ条件でオブジェクトを絞り込み、カーソルでページを取得します。

一覧の基本

listObjects はキーの昇順でオブジェクトを返します。既定の件数は 100 件です。

const page = await omnio.listObjects({ limit: 20 });

for (const item of page.items) {
  console.log(item.key.key);
}

console.log(page.nextCursor); // 続きがない場合は null

続きを取得する

nextCursor をそのまま次の呼び出しに渡します。

let cursor: string | null = null;
const all = [];

do {
  const page = await omnio.listObjects({ limit: 100, cursor });

  all.push(...page.items);
  cursor = page.nextCursor;
} while (cursor !== null);

カーソルは先頭からの件数を表します。ページを取得している間にオブジェクトが追加・削除されると、項目が重複したり飛ばされたりすることがあります。厳密なスナップショットが必要なときは、一覧の取得中に書き込まないでください。

タグで絞り込む

// タグを 1 つ含む
await omnio.listObjects({ filter: { tags: "important" } });

// すべてのタグを含む
await omnio.listObjects({ filter: { tags: { hasEvery: ["work", "2026"] } } });

// いずれかのタグを含む
await omnio.listObjects({ filter: { tags: { hasSome: ["red", "blue"] } } });

// タグが空
await omnio.listObjects({ filter: { tags: { isEmpty: true } } });

タグの順序は比較に影響しません。

コンテンツタイプで絞り込む

await omnio.listObjects({
  filter: { contentType: "image/jpeg" },
});

await omnio.listObjects({
  filter: {
    contentType: {
      startsWith: "image/",
      not: "image/svg+xml",
    },
  },
});

contentType は保存時に小文字へ正規化されます。絞り込み条件の値も小文字として扱われます。

サイズと日時で絞り込む

await omnio.listObjects({
  filter: {
    size: { gte: 1024, lt: 10 * 1024 * 1024 },
    createdAt: { gte: new Date("2026-01-01T00:00:00Z") },
    updatedAt: { lt: "2026-12-31T23:59:59Z" },
  },
});

日時は ISO 8601 文字列か Date で指定します。サイズの比較には数値か bigint を使えます。

全文検索で絞り込む

fullText は説明文とキーに対する部分一致です。単語に分割したり、順位を付けたりはしません。

await omnio.listObjects({
  filter: { fullText: "夕日" },
});

大文字と小文字の区別はデータベースによって異なります。SQLite は ASCII の範囲で大文字と小文字を区別せず、PostgreSQL は ILIKE を使います。

レコードタイプで絞り込む

await omnio.listObjects({
  filter: { recordType: "UPDATE_METADATA" },
});

recordType は "CREATE"、"UPDATE_METADATA"、"DELETE" のいずれかです。ただし削除済みのレコードは常に一覧から除外されるため、"DELETE" を指定しても結果は空です。

複数の条件を組み合わせる

同じフィールドに複数の条件を指定した場合は、すべてを満たす必要があります。異なるフィールドの条件もすべて組み合わされます。

await omnio.listObjects({
  filter: {
    contentType: { startsWith: "image/" },
    tags: { hasEvery: ["public", "2026"] },
    size: { lte: 5 * 1024 * 1024 },
    createdAt: { gte: new Date("2026-01-01") },
  },
});

searchObjects の filter も同じ形式です。ベクトルの類似度を計算する前に候補を絞り込みます。

await omnio.searchObjects({
  query: { text: "海辺の写真" },
  topK: 10,
  filter: {
    contentType: { startsWith: "image/" },
    tags: { has: "public" },
  },
});

次に読む

条件の正確な型と意味はメタデータによる絞り込みを参照してください。

このページは役に立ちましたか?