CosmicWorks.Generator 3.0.0-preview.1

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

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

• CosmicWorks data generation CLI tool
• CosmicWorks.Data fictituous data library
• CosmicWorks.Models model library