Skip to content

readme.md

Latest commit

 

History

History
125 lines (104 loc) · 3.4 KB

readme.md

File metadata and controls

125 lines (104 loc) · 3.4 KB

CosmicWorks.Generator data seeding library

CosmicWorks is an open source set of tools and libraries to generate data quickly for your proof of concept or sample applications.

Overview

Populates an Azure Cosmos DB for NoSQL container with fictiuous data generated using CosmicWorks.Data.

💡 The CosmicWorks sample data is partially derived from AdventureWorksLT.

Usage

using Microsoft.Samples.Cosmos.NoSQL.CosmicWorks.Data;
using Microsoft.Samples.Cosmos.NoSQL.CosmicWorks.Generator;
using Microsoft.Samples.Cosmos.NoSQL.CosmicWorks.Generator.Services;
using Microsoft.Samples.Cosmos.NoSQL.CosmicWorks.Models;

ConnectionOptions options = new()
{
    Type = ConnectionType.MicrosoftEntra,
    Credential = "<azure-cosmos-db-nosql-account-endpoint>"
};

{
    // Seed "products" database
    CosmosDataGenerator<Product> generator = new(
        new ProductsDataSource(),
        new CosmosDataService<Product>(
            new CosmosClientService()
        )
    );

    await generator.GenerateAsync(
        options: options,
        databaseName: "cosmicworks",
        containerName: "products",
        count: 1000,
        disableHierarchicalPartitionKeys: false,
        onItemCreate: (product) => Console.WriteLine($"[NEW PRODUCT]\t{product}")
    );
}

{
    // Seed "employees" database
    CosmosDataGenerator<Product> generator = new(
        new ProductsDataSource(),
        new CosmosDataService<Product>(
            new CosmosClientService()
        )
    );

    await generator.GenerateAsync(
        options: options,
        databaseName: "cosmicworks",
        containerName: "employees",
        count: 200,
        disableHierarchicalPartitionKeys: false,
        onItemCreate: (employee) => Console.WriteLine($"[NEW EMPLOYEE]\t{employee}")
    );
}

Data generated

Description
Employees Creates a container with fictiuous employee items and hierarchical partitoining based on /company, /department, and then /territory.
Products Creates a container with fictiuous product items and hierarchical partitoining based on /category.name and /category.subCategory.name.

Sample data

Here's samples of the JSON data created using this tool with system-properties omitted:

Employees

{
  "name": {
    "first": "Karolina",
    "last": "Rocha"
  },
  "addresses": [
    {
      "name": "Headquarters",
      "street": "1234 Oak Street",
      "city": "Redmond",
      "state": "WA",
      "zipCode": "23052",
      "type": "work"
    }
  ],
  "company": "Adventure Works",
  "department": "Marketing",
  "emailAddress": "karolina@adventure-works.com",
  "phoneNumber": "425-555-0164",
  "territory": "Brazil",
  "type": "employee"
}

Products

{
  "name": "Taillights - Battery-Powered",
  "description": "Affordable light for safe night riding - uses 3 AAA batteries",
  "category": "Accessories",
  "subCategory": "Lights",
  "sku": "LT-T990",
  "tags": [
    "Accessories",
    "Lights"
  ],
  "price": 918.85,
  "quantity": 100,
  "clearance": false
}

Related