azurecosmos

Cloud Databasebackend/azurecosmos

Azure Cosmos DB is Microsoft's globally distributed, multi-model database service. It provides low-latency, elastic scale, and comprehensive SLAs for throughput, latency, availability, and consistency.

📦 Installation

go get github.com/azrod/kivigo/backend/azurecosmos

Requires an active Azure Cosmos DB account. You can create a free tier account on Azure Portal.

Dependencies

• Azure Cosmos DB account
• Valid connection string or account key
• Network connectivity to Azure

✨ Features

✅Basic Operations

✅Batch Operations

✅Health Checks

✅Global Distribution

✅Multiple Consistency Levels

✅Automatic Scaling

✅SLA Guarantees

✅Multi-Model Support

🚀 Usage

Configuration

package main

import (
  "github.com/azrod/kivigo"
  "github.com/azrod/kivigo/backend/azurecosmos"
)

func main() {
  // Configuration with connection string
  opt := azurecosmos.NewOptions()
  opt.ConnectionString = "AccountEndpoint=<https://your-account.documents.azure.com:443/;AccountKey=your-key>;"
  opt.DatabaseName = "kivigo"
  opt.ContainerName = "keyvalue"

  // Optional: Configure consistency level
  opt.ConsistencyLevel = azurecosmos.SessionConsistency
  
  // Optional: Configure request options
  opt.RequestOptions = azurecosmos.RequestOptions{
      RequestUnitsPerSecond: 400,
      PartitionKey:         "/id",
  }
  
  // Create backend
  kvStore, err := azurecosmos.New(opt)
  if err != nil {
      panic(err)
  }
  defer kvStore.Close()
  
  // Create client
  client, err := kivigo.New(kvStore)
  if err != nil {
      panic(err)
  }
}

Basic Usage

package main

import (
  "context"
  "fmt"
  "log"

  "github.com/azrod/kivigo"
  "github.com/azrod/kivigo/backend/azurecosmos"
)

type UserProfile struct {
  ID       string `json:"id"`
  Name     string `json:"name"`
  Email    string `json:"email"`
  Location string `json:"location"`
}

func main() {
  // Setup
  opt := azurecosmos.NewOptions()
  opt.ConnectionString = "AccountEndpoint=<https://your-account.documents.azure.com:443/;AccountKey=your-key>;"
  opt.DatabaseName = "kivigo"
  opt.ContainerName = "profiles"

  kvStore, err := azurecosmos.New(opt)
  if err != nil {
      log.Fatal(err)
  }
  defer kvStore.Close()
  
  client, err := kivigo.New(kvStore)
  if err != nil {
      log.Fatal(err)
  }
  
  ctx := context.Background()
  
  // Store user profile
  profile := UserProfile{
      ID:       "user-123",
      Name:     "Alice Johnson",
      Email:    "alice@example.com",
      Location: "Seattle, WA",
  }
  
  err = client.Set(ctx, "profile:user-123", profile)
  if err != nil {
      log.Fatal(err)
  }
  
  // Retrieve user profile
  var retrievedProfile UserProfile
  err = client.Get(ctx, "profile:user-123", &retrievedProfile)
  if err != nil {
      log.Fatal(err)
  }
  
  fmt.Printf("Profile: %+v\n", retrievedProfile)
  
  // List keys with prefix
  keys, err := client.List(ctx, "profile:")
  if err != nil {
      log.Fatal(err)
  }
  
  fmt.Printf("Profile Keys: %v\n", keys)
}

Health Check

package main

import (
  "context"
  "log"
  "time"

  "github.com/azrod/kivigo/backend/azurecosmos"
)

func main() {
  opt := azurecosmos.NewOptions()
  opt.ConnectionString = "AccountEndpoint=<https://your-account.documents.azure.com:443/;AccountKey=your-key>;"
  opt.DatabaseName = "kivigo"
  opt.ContainerName = "keyvalue"

  kvStore, err := azurecosmos.New(opt)
  if err != nil {
      log.Fatal(err)
  }
  defer kvStore.Close()
  
  ctx := context.Background()
  
  // Simple health check
  err = kvStore.Health(ctx)
  if err != nil {
      log.Printf("Azure Cosmos DB unhealthy: %v", err)
      return
  }
  
  log.Println("Azure Cosmos DB is healthy")
  
  // Periodic health monitoring with circuit breaker pattern
  ticker := time.NewTicker(30 * time.Second)
  defer ticker.Stop()
  
  consecutiveFailures := 0
  maxFailures := 3
  
  for {
      select {
      case <-ticker.C:
          if err := kvStore.Health(ctx); err != nil {
              consecutiveFailures++
              log.Printf("Health check failed (%d/%d): %v", consecutiveFailures, maxFailures, err)
              
              if consecutiveFailures >= maxFailures {
                  log.Println("Circuit breaker opened - service unavailable")
                  return
              }
          } else {
              consecutiveFailures = 0
              log.Println("Health check passed")
          }
      case <-ctx.Done():
          return
      }
  }
}

Batch Operations

package main

import (
  "context"
  "fmt"
  "log"

  "github.com/azrod/kivigo"
  "github.com/azrod/kivigo/backend/azurecosmos"
)

func main() {
  opt := azurecosmos.NewOptions()
  opt.ConnectionString = "AccountEndpoint=<https://your-account.documents.azure.com:443/;AccountKey=your-key>;"
  opt.DatabaseName = "kivigo"
  opt.ContainerName = "keyvalue"

  kvStore, err := azurecosmos.New(opt)
  if err != nil {
      log.Fatal(err)
  }
  defer kvStore.Close()
  
  client, err := kivigo.New(kvStore)
  if err != nil {
      log.Fatal(err)
  }
  
  ctx := context.Background()
  
  // Batch set multiple documents
  batchData := map[string]interface{}{
      "product:1": map[string]interface{}{"name": "Laptop", "price": 999.99, "category": "electronics"},
      "product:2": map[string]interface{}{"name": "Phone", "price": 599.99, "category": "electronics"},
      "product:3": map[string]interface{}{"name": "Book", "price": 19.99, "category": "education"},
  }
  
  err = client.BatchSet(ctx, batchData)
  if err != nil {
      log.Fatal(err)
  }
  
  // Batch get multiple documents
  keys := []string{"product:1", "product:2", "product:3"}
  results, err := client.BatchGet(ctx, keys)
  if err != nil {
      log.Fatal(err)
  }
  
  for key, value := range results {
      fmt.Printf("%s: %v\n", key, value)
  }
  
  // Batch delete
  err = client.BatchDelete(ctx, keys)
  if err != nil {
      log.Fatal(err)
  }
  
  fmt.Println("Batch operations completed successfully")
}

📝 Notes

• Azure Cosmos DB charges based on Request Units (RUs) consumed
• Consider using session consistency for most applications to balance performance and consistency
• Partition key design is crucial for performance - choose a key with good distribution
• Use batch operations to reduce RU consumption for multiple operations
• Monitor your RU consumption in Azure Portal to optimize costs
• Consider using autoscale throughput for unpredictable workloads
• The free tier provides 1000 RU/s and 25GB storage at no cost

🔗 Additional Resources

• Azure Cosmos DB Documentation
• Cosmos DB Go SDK
• Partitioning and Performance
• Request Units and Pricing