Mintaadatkészletek a Cosmos DB-ben a Microsoft Fabricben

  • A következőre érvényes:: ✅ Cosmos DB in Microsoft Fabric

A Microsoft Fabric Cosmos DB adatbázis-számítási feladatai beépített mintaadatkészleteket biztosítanak a NoSQL-adatbázisminták megismeréséhez, megismeréséhez és kísérletezéséhez. Ez az adatkészlet egy olyan e-kereskedelmi forgatókönyvet jelöl, amelyben termékek és ügyfélértékelések láthatóak, bemutatva, hogy a különböző entitástípusok hogyan léteznek egy tárolóban.

Két mintaadatkészlet érhető el:

  • Standard mintaadatok: Alapvető e-kereskedelmi adatok termékekkel és felülvizsgálatokkal
  • Vektormintaadatok: Továbbfejlesztett verzió, amely az OpenAI text-embedding-ada-002 modellel létrehozott 1536 dimenziós vektorbeágyazást tartalmaz szemantikai keresési forgatókönyvekhez.

Adatkészletek áttekintése

Mindkét mintaadatkészlet ugyanazokat az e-kereskedelmi adatokat tartalmazza két dokumentumtípussal.

  • Termékdokumentumok (docType: "product") – Egyedi termékek, amelyek neve, leírása, készlete, aktuális ára és az adott termék árelőzményeinek beágyazott tömbje.
  • Dokumentumok áttekintése (docType: "review") – A termékekhez kapcsolódó ügyfélértékelések és minősítések a következőn keresztül: productId

A vektorminta adatkészlete a standard mintaadatkészleten alapul. A vektoradatkészlet termékdokumentumai egy további vectors tulajdonságot tartalmaznak, amely 1536 dimenziós beágyazást tartalmaz a szemantikai keresési képességekhez.

Megjegyzés:

Mindkét adatkészletet, valamint egy további adatkészletet is megtalálhatja az OpenAI text-embedding-3-large modellel létrehozott, 512 dimenzióra kiterjedő vektorokkal együtt a Cosmos DB Mintaadatkészlet mappában a Fabric - Minták adattárában.

Dokumentumséma

Termékdokumentum sémája

A termékdokumentumok részletes információkat tartalmaznak az e-kereskedelmi katalógus egyes elemeiről:

Ingatlan Típus Leírás
id string A termék egyedi azonosítója GUID formátumban
docType string Dokumentumtípus azonosítója, mindig "product"
productId string Termékazonosító, ugyanaz, mint id a termékdokumentumok esetében
name string Termék megjelenített neve
description string Részletes termékleírás
categoryName string Termékkategória (pl. "Számítógépek, laptopok", "Média", "Tartozékok")
inventory number A jelenleg raktáron lévő tételek száma
firstAvailable string A termék elérhetővé váltásának dátuma (ISO 8601 formátum)
currentPrice number Aktuális eladási ár
priceHistory array Árváltozási objektumok tömbje date és price mezőkkel
priceHistory[].date string Az árváltozás dátuma és időpontja ISO 8601 formátumban
priceHistory[].price number Ár a megadott napon
vectors array Csak vektormintaadatok – 1536 dimenziós vektorbeágyazás

Dokumentumséma áttekintése

A dokumentumok áttekintése az ügyfelek visszajelzéseit és a termékekre vonatkozó értékeléseket tartalmazza:

Ingatlan Típus Leírás
id string A véleményezés egyedi azonosítója GUID formátumban
docType string Dokumentumtípus azonosítója, mindig "review"
productId string Hivatkozás a id vizsgált termékre
categoryName string Termékkategória (a vizsgált terméktől örökölt)
customerName string A felülvizsgálatot megíró ügyfél neve
reviewDate string A felülvizsgálat elküldésének dátuma (ISO 8601 formátum)
stars number Az ügyfél által adott értékelés (1-5 skálázás)
reviewText string Az ügyfél írásos véleményezése

Megjegyzés:

A Cosmos DB automatikusan létrehozza az összes dokumentum rendszertulajdonságait (_rid, _self, _etag, _attachments, ) _ts.

Megjegyzés:

Az ISO 8601 formátumról további információt a nemzetközi dátum- és időszabványban talál. A GUID formátummal kapcsolatos további információkért tekintse meg az univerzálisan egyedi azonosítókat.

Példadokumentumok

Az alábbi példák mindkét mintaadatkészlet dokumentumainak szerkezetét mutatják be.

Példa a standard termékdokumentumra

{
  "id": "ae449848-3f15-4147-8eee-fe76cfcc6bb4",
  "docType": "product",
  "productId": "ae449848-3f15-4147-8eee-fe76cfcc6bb4",
  "name": "EchoSphere Pro ANC-X900 Premium Headphones",
  "description": "EchoSphere Pro ANC-X900 Premium Headphones deliver immersive sound with advanced 40mm drivers and Adaptive Hybrid Active Noise Cancellation. Bluetooth 5.3 ensures seamless connectivity.",
  "categoryName": "Accessories, Premium Headphones",
  "inventory": 772,
  "firstAvailable": "2024-01-01T00:00:00",
  "currentPrice": 454.87,
  "priceHistory": [
    {
      "date": "2024-01-01T00:00:00",
      "price": 349.0
    },
    {
      "date": "2024-08-01T00:00:00",
      "price": 363.0
    },
    {
      "date": "2025-04-01T00:00:00",
      "price": 408.14
    },
    {
      "date": "2025-08-01T00:00:00",
      "price": 454.87
    }
  ]
}

Példa vektorizált termékdokumentumra

{
    "id": "ae449848-3f15-4147-8eee-fe76cfcc6bb4",
    "docType": "product",
    "productId": "ae449848-3f15-4147-8eee-fe76cfcc6bb4",
    "name": "EchoSphere Pro ANC-X900 Premium Headphones",
    "description": "EchoSphere Pro ANC-X900 Premium Headphones deliver immersive sound with advanced 40mm drivers and Adaptive Hybrid Active Noise Cancellation. Bluetooth 5.3 ensures seamless connectivity.",
    "categoryName": "Accessories, Premium Headphones",
    "inventory": 772,
    "firstAvailable": "2024-01-01T00:00:00",
    "currentPrice": 454.87,
    "priceHistory": [
      {
        "date": "2024-01-01T00:00:00",
        "price": 349.0
      },
      {
        "date": "2025-08-01T00:00:00",
        "price": 454.87
      }
    ],
    "vectors": [
      -0.02783808670938015,
      0.011827611364424229,
      -0.04711977392435074,
      // ... (1536 dimensions total)
      0.04251981899142265
    ]
}

A dokumentum példa áttekintése

Mindkét mintaadatkészletben azonosak az áttekintő dokumentumok.

{
  "id": "fa799013-1746-4a7f-bd0f-2a95b2b76481",
  "docType": "review",
  "productId": "e847e069-d0f9-4fec-b42a-d37cd5b2f536",
  "categoryName": "Accessories, Premium Headphones",
  "customerName": "Emily Rodriguez",
  "reviewDate": "2025-03-02T00:00:00",
  "stars": 5,
  "reviewText": "Excellent sound quality! Premium build! This EchoSphere Pro ANC-X900 exceeded hopes."
}

A mintaadatok használata

Mindkét mintaadatkészlet segít az adatok lekérdezésében, szűrésében és összesítésében a Cosmos DB-ben. A vegyes dokumentumtípusok valósághű forgatókönyveket biztosítanak a különböző használati esetekhez.

Standard mintaadat-forgatókönyvek

  • Kapcsolódó adatok összekapcsolása: Felülvizsgálatok csatolása termékekhez a következő használatával: productId
  • Kategóriaelemzés: Termékek és vélemények lekérdezése a következő szerint: categoryName
  • Elemzés áttekintése: Az ügyfelek visszajelzési mintáinak és minősítéseinek vizsgálata

Gyakori lekérdezési minták

Az összes termék lekérése egy kategóriában:

SELECT *
FROM c
WHERE 
  c.docType = "product" AND 
  c.categoryName = "Computers, Laptops"

Vélemények lekérése egy adott termékről:

SELECT *
FROM c
WHERE 
  c.docType = "review" AND 
  c.productId = "77be013f-4036-4311-9b5a-dab0c3d022be"

Vektormintás adatforgatókönyvek

  • Szemantikai hasonlóság keresése: Hasonló tulajdonságokkal rendelkező termékek keresése vektoros beágyazások használatával
  • Tartalomalapú javaslatok: Termékjavaslatok létrehozása a leírás hasonlósága alapján
  • Hibrid lekérdezések: A hagyományos szűrők kombinálása vektoros hasonlósággal a továbbfejlesztett eredmények érdekében

JSON-sémák

Az alábbi JSON-sémák mindkét mintaadatkészlet dokumentumainak szerkezetét írják le. Ezekkel a sémákkal ellenőrizheti vagy hozhat létre hasonló adatokat saját Cosmos DB-számítási feladataihoz.

Standard termékdokumentumséma

{
  "type": "object",
  "properties": {
    "id": { "type": "string" },
    "docType": { "type": "string" },
    "productId": { "type": "string" },
    "name": { "type": "string" },
    "description": { "type": "string" },
    "categoryName": { "type": "string" },
    "inventory": { "type": "number" },
    "firstAvailable": { "type": "string" },
    "currentPrice": { "type": "number" },
    "priceHistory": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": { "type": "string" },
          "price": { "type": "number" }
        },
        "required": ["date", "price"]
      }
    }
  },
  "required": [
    "id", "docType", "productId", "name", "description", "categoryName", "inventory", "firstAvailable", "currentPrice", "priceHistory"
  ]
}

Vektoralapú termékdokumentum-séma

{
  "type": "object",
  "properties": {
    "id": { "type": "string" },
    "docType": { "type": "string" },
    "productId": { "type": "string" },
    "name": { "type": "string" },
    "description": { "type": "string" },
    "categoryName": { "type": "string" },
    "inventory": { "type": "number" },
    "firstAvailable": { "type": "string" },
    "currentPrice": { "type": "number" },
    "priceHistory": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": { "type": "string" },
          "price": { "type": "number" }
        },
        "required": ["date", "price"]
      }
    },
    "vectors": {
      "type": "array",
      "items": { "type": "number" },
      "minItems": 1536,
      "maxItems": 1536
    }
  },
  "required": [
    "id", "docType", "productId", "name", "description", "categoryName", "inventory", "firstAvailable", "currentPrice", "priceHistory", "vectors"
  ]
}

Dokumentumséma áttekintése

{
  "type": "object",
  "properties": {
    "id": { "type": "string" },
    "docType": { "type": "string", "const": "review" },
    "productId": { "type": "string" },
    "categoryName": { "type": "string" },
    "customerName": { "type": "string" },
    "reviewDate": { "type": "string" },
    "stars": { "type": "number" },
    "reviewText": { "type": "string" }
  },
  "required": [
    "id", "docType", "productId", "categoryName", "customerName", 
    "reviewDate", "stars"
  ]
}

Kapcsolódó tartalom

  • Last updated on