Skip to main content
Servers Are Up
Virtual Datacenter
PricingFree Tools
Sign inBrowse catalog
Servers Are Up
Virtual Datacenter
PricingFree Tools
Sign inBrowse catalog

Loading…

Servers Are Up

Your apps, automation and data on hardware we own. Build a private stack with predictable capacity and access through your dashboard, API or SSH.

SLA with service creditsOwned hardwareUS-based

Make room for your next idea

Explore the capacity, apps and access options that fit your workload. Check current availability and your total before you buy.

Sign up freeView Pricing

Products

  • Linux VPS
  • Windows VPS
  • Cloud & SaaS Services
  • Cloud Storage (Azure)
  • Virtual Datacenter
  • AI & Agent Hosting
  • Containers
  • Instant Apps
  • Software Platforms
  • Network builder
  • Game Servers
  • Pricing

Resources

  • Free Network Tools
  • 2026 Pricing Benchmark
  • Live SVG Badges
  • Latency & Speed Test
  • Guides & Tutorials
  • Documentation
  • API Reference
  • MCP Server
  • CLI & SDKs
  • OpenAPI & llms.txt
  • Use Cases
  • Free Migration
  • Uptime & Reliability
  • Datacenter
  • System Status
  • Network
  • Provider Comparisons Hub
  • Compare Providers

Company

  • About Us
  • Enterprise
  • Security Architecture
  • Trust Center
  • Blog
  • FAQ
  • Compliance
  • Startup Program
  • Open-Source Sponsorship
  • Press & Media Kit
  • Referral Program
  • Help Center
  • Contact Us
© Servers Are Up
TermsPrivacySLARefund PolicyDPAAcceptable Use
Service information
Docs
  • Documentation Hub
  • Choose a Product
    VMs, Containers & Cloud
  • First Linux Server
    SSH, Firewall & Apps
  • Windows Server 2025
    BYOL & Remote Desktop
  • Remote Access
  • Troubleshooting
  • FAQ
  • All Product Guides
    29 Step-by-Step Guides
  • Cloud & SaaS Catalog
    112 Cloud & SaaS Offerings
  • Azure Cloud Storage
    Hot/Cool/Archive & WORM
  • Resource Manager & RBAC
    Groups, Tags & Locks
  • Multi-Model Cloud DB
    JSONB, SQL & pgvector
  • Cloud Identity & ZTNA
    OIDC, SCIM & PIM
  • Key Vault & KMS
    Secrets & Envelope Keys
  • Cloud SIEM, SOAR & DLP
    Posture & Threat Response
  • API Gateway & Cloud DNS
    Edge WAF & DNS Zones
  • Serverless, Workflows & IoT
    Functions, Queues & DAGs
  • SaaS, Governance & Vault
    Budgets & Off-Host GRS
  • Build Web Apps with AI
  • Next.js and React
  • TypeScript and Node.js
  • npm and Tooling
  • Data and APIs
  • Deploy and Operate
  • Tutorials
  • Infrastructure
  • Automation & Regions
  • API Overview
  • API v1 Reference
    Endpoints & 23 Scopes
  • MCP Server
    129 AI Agent Tools
  • Swagger / OpenAPI 3.1
  • API Playground
  • Versioning & Sunset
  • API Token Security
    Authentication & Tokens
  • Instances API
    Compute Resources
  • Networking API
    Networks & Ports
  • Storage API Availability
    Volumes & Backups
  • Webhooks & Events
    Event Notifications
  • Rate Limits & Best Practices
    Throttling & Retries
  • sau CLI Reference
    34 Commands (v0.2)
  • Browser Web CLI
  • SDKs
  • Infrastructure as Code
    Terraform & Ansible
  • Code Examples
  • CLI & SDK Guides
  • Security Guides
  • Security at a Glance
  • Zero Trust Architecture
  • Live Trust Center
  • Compliance
Need help?

Loading documentation...

Documentation/products

Deploy Multi-Model Cloud Databases for JSON, Vector AI and SQL

Provision serverless JSONB document, pgvector RAG and key-value databases with tunable consistency, key rotation and 100K free RUs.

Intermediate
18 min
Updated 2026-11-12

Deploy Ready-to-Run Infrastructure in Seconds

Linux VMs from $6/mo · Pooled Virtual Datacenters from $12/mo · Use code WELCOME20 for 20% off your first order.

Browse ServersView Pricing

Commands checked on 2026-11-12 with SAU Multi-Model Cloud Database v1.7, pgvector, sau CLI 0.2.0.

What you will have at the end

You will have a managed SAU Multi-Model Cloud Database instance on Home > Cloud databases (/dashboard/cloud-db)—supporting serverless JSONB document collections, pgvector cosine-similarity embeddings for AI Retrieval-Augmented Generation (RAG), and low-latency key-value lookups—configured with tunable consistency, optimistic ETag concurrency, zero-downtime dual-key rotation, and 100,000 Request Units (RU) per month included free ($0.25 per 1M RU thereafter).

Before you start

  • A Servers Are Up account signed in at /dashboard.
  • A Personal Access Token with cloud:read and cloud:write scopes (Account settings > API keys at /account/api-keys).
  • sau CLI v0.2.0 or curl + jq to insert documents, run vector queries, and inspect RU consumption.

Steps

1. Provision a Document, Vector AI, or Key-Value database

Open Home > Cloud databases (/dashboard/cloud-db) and click Create database, or provision from the terminal with sau cosmosdb create:

  1. Choose your engine model:
    • DOCUMENT_NOSQL: Schema-flexible JSONB collections with indexed property filters and ETag optimistic locking.
    • VECTOR_AI: JSON documents paired with dense floating-point embedding vectors (embeddings: number[]) for RAG semantic search.
    • KEY_VALUE: Sub-millisecond point reads and TTL-capable state storage for sessions, rate counters, and agent memory.
  2. Select your consistency level (STRONG, BOUNDED_STALENESS, SESSION [default], or EVENTUAL).
# Create a Vector AI database for RAG document chunks
sau cosmosdb create rag-knowledge-db --model VECTOR_AI --consistency SESSION

# List your active Multi-Model Cloud Databases
sau cosmosdb list -o table

Save the returned id (for example cdb_01j...) for subsequent document and vector operations.

2. Upsert JSON documents and vector embeddings

Insert or update items in named collections using sau cosmosdb item-upsert or POST /api/v1/cosmos. Every mutation returns the consumed requestUnits (RU) and a fresh etag version string:

# Upsert a structured document via sau CLI
sau cosmosdb item-upsert YOUR_DATABASE_ID "doc-pricing-faq" \
  '{"title":"Cloud Storage Pricing","category":"storage","summary":"250 GiB plan starts at $9/mo hosted via Microsoft Azure."}' \
  --collection "kb_chunks"

# Upsert a document with an embedding vector via REST API v1
curl -fsSL -X POST "https://serversareup.com/api/v1/cosmos" \
  -H "Authorization: Bearer sau_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "upsert-item",
    "databaseId": "YOUR_DATABASE_ID",
    "collectionName": "kb_chunks",
    "itemKey": "doc-worm-locks",
    "document": {
      "title": "Immutable WORM Retention",
      "category": "security",
      "text": "Time-bound WORM locks protect compliance blobs up to 10 years."
    },
    "embedding": [0.12, -0.04, 0.88, 0.31, -0.19, 0.45, 0.09, 0.62]
  }' | jq .

To prevent lost updates when two workers modify the same order or session document concurrently, pass "ifMatchEtag": "<previous-etag>" in your upsert-item payload; stale writes fail cleanly with 412 Precondition Failed instead of clobbering newer state.

3. Query collections and run cosine-similarity RAG searches

Query JSON collections from the CLI or run hybrid metadata + cosine vector searches over HTTP:

# Query all items in a collection via CLI
sau cosmosdb items-query YOUR_DATABASE_ID --collection kb_chunks -o json

# Run a vector similarity search for RAG context retrieval
curl -fsSL -X POST "https://serversareup.com/api/v1/cosmos" \
  -H "Authorization: Bearer sau_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "vector-search",
    "databaseId": "YOUR_DATABASE_ID",
    "collectionName": "kb_chunks",
    "queryVector": [0.11, -0.05, 0.86, 0.29, -0.18, 0.44, 0.10, 0.60],
    "topK": 3
  }' | jq .

4. Rotate primary/secondary database keys with zero downtime

Each Multi-Model Cloud Database issues both a Primary Key and a Secondary Key:

  1. Switch your running application to the Secondary Key in Automation > App config & messaging (/dashboard/app-config) or Access > Key vault & KMS (/dashboard/key-vault).
  2. Rotate keys (sau cosmosdb keys-rotate YOUR_DATABASE_ID), verify app health, and store the new Primary Key in Key Vault.

Check that it works

Verify your stored item count, consistency setting, and cumulative Request Unit consumption on /dashboard/cloud-db or via the API:

curl -fsSL "https://serversareup.com/api/v1/cosmos?databaseId=YOUR_DATABASE_ID" \
  -H "Authorization: Bearer sau_your_token_here" | jq '{
    database: .database | {id, name, engineModel, consistencyLevel, totalRuConsumed},
    itemCount: (.items | length)
  }'

Check Operations > Governance & FinOps (/dashboard/governance) (sau governance show) to see your CLOUD_DB_RU meter usage against your free 100,000 RU/mo allowance.

What can go wrong

  • 412 Precondition Failed on upsert-item. Another worker updated the item after you read its etag. Re-fetch the item, re-apply your business delta, and retry with the latest etag.
  • Vector similarity scores return 0 or dimension mismatch. Ensure every document in a single collection uses embeddings generated by the same embedding model and vector dimension (for example 768 or 1536 floats)—never mix two different embedding models inside one collection.
  • Accidental sau cosmosdb delete blocked with 409 Conflict. A CanNotDelete lock is active on the database or its Resource Group (sau lock list -o table).

Good practice

  • Partition logical workloads by collectionName (kb_chunks, chat_sessions, job_checkpoints) and attach a CanNotDelete lock (sau lock create ...) to every production database immediately after creation.
  • Choose STRONG consistency for financial balances and inventory counters, SESSION consistency for user-facing web apps and chat history, and EVENTUAL for high-throughput telemetry or analytics caches.
  • Register production databases in Operations > Backup & recovery vault (/dashboard/recovery-vault) for scheduled immutable recovery points.

Where to go next

  • Store AES-256-GCM secrets and rotate keys in Key Vault
  • Purchase Azure-backed cloud storage with WORM locks and SAS
  • Organize resources with groups, tags, locks and RBAC

Related Articles

Create a scoped API key and send your first v1 request

Read more

Route APIs with Edge WAF, rate limits and Cloud DNS

Read more

Purchase Azure-backed cloud storage with WORM locks and SAS

Read more

Frequently Asked Questions

What does the Deploy Multi-Model Cloud Databases for JSON, Vector AI and SQL documentation guide cover?
Provision serverless JSONB document, pgvector RAG and key-value databases with tunable consistency, key rotation and 100K free RUs. It is rated intermediate difficulty (18 min) and applies to Servers Are Up infrastructure and workflows.
Can I manage or automate these steps through the Servers Are Up dashboard, REST API v1, or MCP server?
Yes. Every Servers Are Up server includes browser-based SSH, WebRDP, and VNC console access in the dashboard, plus programmatic control via the REST API v1 (/api/v1) and hosted Model Context Protocol server (/api/mcp/v1) using a scoped Personal Access Token.

Need hands-on help with Deploy Multi-Model Cloud Databases for JSON, Vector AI and SQL?

Every Servers Are Up virtual machine and container includes an integrated HTML5 browser-based SSH, RDP, and VNC console in your dashboard, default-off inbound firewall rules with per-IP allow-lists, and full programmatic control via REST API v1 and Model Context Protocol (MCP). Explore our Virtual Datacenter Plans or reach out to Servers Are Up Support.

Was this article helpful?

On this page

What you will have at the endBefore you startSteps1. Provision a Document, Vector AI, or Key-Value database2. Upsert JSON documents and vector embeddings3. Query collections and run cosine-similarity RAG searches4. Rotate primary/secondary database keys with zero downtimeCheck that it worksWhat can go wrongGood practiceWhere to go next