{"id":"803e5d11-8091-4f4a-ae93-9b9d620c9473","shortId":"zbs2ES","kind":"skill","title":"azure-cosmos-java","tagline":"Azure Cosmos DB SDK for Java. NoSQL database operations with global distribution, multi-model support, and reactive patterns.","description":"# Azure Cosmos DB SDK for Java\n\nClient library for Azure Cosmos DB NoSQL API with global distribution and reactive patterns.\n\n## Installation\n\n```xml\n<dependency>\n    <groupId>com.azure</groupId>\n    <artifactId>azure-cosmos</artifactId>\n    <version>LATEST</version>\n</dependency>\n```\n\nOr use Azure SDK BOM:\n\n```xml\n<dependencyManagement>\n    <dependencies>\n        <dependency>\n            <groupId>com.azure</groupId>\n            <artifactId>azure-sdk-bom</artifactId>\n            <version>{bom_version}</version>\n            <type>pom</type>\n            <scope>import</scope>\n        </dependency>\n    </dependencies>\n</dependencyManagement>\n\n<dependencies>\n    <dependency>\n        <groupId>com.azure</groupId>\n        <artifactId>azure-cosmos</artifactId>\n    </dependency>\n</dependencies>\n```\n\n## Environment Variables\n\n```bash\nCOSMOS_ENDPOINT=https://<account>.documents.azure.com:443/\nCOSMOS_KEY=<your-primary-key>\n```\n\n## Authentication\n\n### Key-based Authentication\n\n```java\nimport com.azure.cosmos.CosmosClient;\nimport com.azure.cosmos.CosmosClientBuilder;\n\nCosmosClient client = new CosmosClientBuilder()\n    .endpoint(System.getenv(\"COSMOS_ENDPOINT\"))\n    .key(System.getenv(\"COSMOS_KEY\"))\n    .buildClient();\n```\n\n### Async Client\n\n```java\nimport com.azure.cosmos.CosmosAsyncClient;\n\nCosmosAsyncClient asyncClient = new CosmosClientBuilder()\n    .endpoint(serviceEndpoint)\n    .key(key)\n    .buildAsyncClient();\n```\n\n### With Customizations\n\n```java\nimport com.azure.cosmos.ConsistencyLevel;\nimport java.util.Arrays;\n\nCosmosClient client = new CosmosClientBuilder()\n    .endpoint(serviceEndpoint)\n    .key(key)\n    .directMode(directConnectionConfig, gatewayConnectionConfig)\n    .consistencyLevel(ConsistencyLevel.SESSION)\n    .connectionSharingAcrossClientsEnabled(true)\n    .contentResponseOnWriteEnabled(true)\n    .userAgentSuffix(\"my-application\")\n    .preferredRegions(Arrays.asList(\"West US\", \"East US\"))\n    .buildClient();\n```\n\n## Client Hierarchy\n\n| Class | Purpose |\n|-------|---------|\n| `CosmosClient` / `CosmosAsyncClient` | Account-level operations |\n| `CosmosDatabase` / `CosmosAsyncDatabase` | Database operations |\n| `CosmosContainer` / `CosmosAsyncContainer` | Container/item operations |\n\n## Core Workflow\n\n### Create Database\n\n```java\n// Sync\nclient.createDatabaseIfNotExists(\"myDatabase\")\n    .map(response -> client.getDatabase(response.getProperties().getId()));\n\n// Async with chaining\nasyncClient.createDatabaseIfNotExists(\"myDatabase\")\n    .map(response -> asyncClient.getDatabase(response.getProperties().getId()))\n    .subscribe(database -> System.out.println(\"Created: \" + database.getId()));\n```\n\n### Create Container\n\n```java\nasyncClient.createDatabaseIfNotExists(\"myDatabase\")\n    .flatMap(dbResponse -> {\n        String databaseId = dbResponse.getProperties().getId();\n        return asyncClient.getDatabase(databaseId)\n            .createContainerIfNotExists(\"myContainer\", \"/partitionKey\")\n            .map(containerResponse -> asyncClient.getDatabase(databaseId)\n                .getContainer(containerResponse.getProperties().getId()));\n    })\n    .subscribe(container -> System.out.println(\"Container: \" + container.getId()));\n```\n\n### CRUD Operations\n\n```java\nimport com.azure.cosmos.models.PartitionKey;\n\nCosmosAsyncContainer container = asyncClient\n    .getDatabase(\"myDatabase\")\n    .getContainer(\"myContainer\");\n\n// Create\ncontainer.createItem(new User(\"1\", \"John Doe\", \"john@example.com\"))\n    .flatMap(response -> {\n        System.out.println(\"Created: \" + response.getItem());\n        // Read\n        return container.readItem(\n            response.getItem().getId(),\n            new PartitionKey(response.getItem().getId()),\n            User.class);\n    })\n    .flatMap(response -> {\n        System.out.println(\"Read: \" + response.getItem());\n        // Update\n        User user = response.getItem();\n        user.setEmail(\"john.doe@example.com\");\n        return container.replaceItem(\n            user,\n            user.getId(),\n            new PartitionKey(user.getId()));\n    })\n    .flatMap(response -> {\n        // Delete\n        return container.deleteItem(\n            response.getItem().getId(),\n            new PartitionKey(response.getItem().getId()));\n    })\n    .block();\n```\n\n### Query Documents\n\n```java\nimport com.azure.cosmos.models.CosmosQueryRequestOptions;\nimport com.azure.cosmos.util.CosmosPagedIterable;\n\nCosmosContainer container = client.getDatabase(\"myDatabase\").getContainer(\"myContainer\");\n\nString query = \"SELECT * FROM c WHERE c.status = @status\";\nCosmosQueryRequestOptions options = new CosmosQueryRequestOptions();\n\nCosmosPagedIterable<User> results = container.queryItems(\n    query,\n    options,\n    User.class\n);\n\nresults.forEach(user -> System.out.println(\"User: \" + user.getName()));\n```\n\n## Key Concepts\n\n### Partition Keys\n\nChoose a partition key with:\n- High cardinality (many distinct values)\n- Even distribution of data and requests\n- Frequently used in queries\n\n### Consistency Levels\n\n| Level | Guarantee |\n|-------|-----------|\n| Strong | Linearizability |\n| Bounded Staleness | Consistent prefix with bounded lag |\n| Session | Consistent prefix within session |\n| Consistent Prefix | Reads never see out-of-order writes |\n| Eventual | No ordering guarantee |\n\n### Request Units (RUs)\n\nAll operations consume RUs. Check response headers:\n\n```java\nCosmosItemResponse<User> response = container.createItem(user);\nSystem.out.println(\"RU charge: \" + response.getRequestCharge());\n```\n\n## Best Practices\n\n1. **Reuse CosmosClient** — Create once, reuse throughout application\n2. **Use async client** for high-throughput scenarios\n3. **Choose partition key carefully** — Affects performance and scalability\n4. **Enable content response on write** for immediate access to created items\n5. **Configure preferred regions** for geo-distributed applications\n6. **Handle 429 errors** with retry policies (built-in by default)\n7. **Use direct mode** for lowest latency in production\n\n## Error Handling\n\n```java\nimport com.azure.cosmos.CosmosException;\n\ntry {\n    container.createItem(item);\n} catch (CosmosException e) {\n    System.err.println(\"Status: \" + e.getStatusCode());\n    System.err.println(\"Message: \" + e.getMessage());\n    System.err.println(\"Request charge: \" + e.getRequestCharge());\n    \n    if (e.getStatusCode() == 409) {\n        System.err.println(\"Item already exists\");\n    } else if (e.getStatusCode() == 429) {\n        System.err.println(\"Rate limited, retry after: \" + e.getRetryAfterDuration());\n    }\n}\n```\n\n## Reference Links\n\n| Resource | URL |\n|----------|-----|\n| Maven Package | https://central.sonatype.com/artifact/com.azure/azure-cosmos |\n| API Documentation | https://azuresdkdocs.z19.web.core.windows.net/java/azure-cosmos/latest/index.html |\n| Product Docs | https://learn.microsoft.com/azure/cosmos-db/ |\n| Samples | https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples |\n| Performance Guide | https://learn.microsoft.com/azure/cosmos-db/performance-tips-java-sdk-v4-sql |\n| Troubleshooting | https://learn.microsoft.com/azure/cosmos-db/troubleshoot-java-sdk-v4-sql |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["azure","cosmos","java","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-azure-cosmos-java","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/azure-cosmos-java","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34928 github stars · SKILL.md body (7,533 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T18:50:29.817Z","embedding":null,"createdAt":"2026-04-18T21:32:17.851Z","updatedAt":"2026-04-24T18:50:29.817Z","lastSeenAt":"2026-04-24T18:50:29.817Z","tsv":"'/artifact/com.azure/azure-cosmos':517 '/azure-samples/azure-cosmos-java-sql-api-samples':531 '/azure/cosmos-db/':527 '/azure/cosmos-db/performance-tips-java-sdk-v4-sql':536 '/azure/cosmos-db/troubleshoot-java-sdk-v4-sql':540 '/java/azure-cosmos/latest/index.html':522 '/partitionkey':212 '1':241,403 '2':411 '3':420 '4':429 '409':494 '429':452,502 '5':441 '6':450 '7':462 'access':437 'account':157 'account-level':156 'action':553 'affect':425 'alreadi':497 'api':37,518 'applic':142,410,449,547 'arrays.aslist':144 'ask':591 'async':101,181,413 'asynccli':107,232 'asyncclient.createdatabaseifnotexists':184,199 'asyncclient.getdatabase':188,208,215 'authent':78,82 'azur':2,5,24,33,48,53,59,68 'azure-cosmo':47,67 'azure-cosmos-java':1 'azure-sdk-bom':58 'azuresdkdocs.z19.web.core.windows.net':521 'azuresdkdocs.z19.web.core.windows.net/java/azure-cosmos/latest/index.html':520 'base':81 'bash':72 'best':401 'block':289 'bom':55,61,62 'bound':356,361 'boundari':599 'buildasynccli':114 'buildclient':100,149 'built':458 'built-in':457 'c':307 'c.status':309 'cardin':336 'care':424 'catch':479 'central.sonatype.com':516 'central.sonatype.com/artifact/com.azure/azure-cosmos':515 'chain':183 'charg':399,490 'check':389 'choos':330,421 'clarif':593 'class':152 'clear':566 'client':30,89,102,123,150,414 'client.createdatabaseifnotexists':174 'client.getdatabase':178,299 'com.azure':46,57,66 'com.azure.cosmos.consistencylevel':119 'com.azure.cosmos.cosmosasyncclient':105 'com.azure.cosmos.cosmosclient':85 'com.azure.cosmos.cosmosclientbuilder':87 'com.azure.cosmos.cosmosexception':475 'com.azure.cosmos.models.cosmosqueryrequestoptions':294 'com.azure.cosmos.models.partitionkey':229 'com.azure.cosmos.util.cosmospagediterable':296 'concept':327 'configur':442 'connectionsharingacrossclientsen':135 'consist':350,358,364,368 'consistencylevel':133 'consistencylevel.session':134 'consum':387 'contain':197,221,223,231,298 'container.createitem':238,395,477 'container.deleteitem':282 'container.getid':224 'container.queryitems':317 'container.readitem':252 'container.replaceitem':272 'container/item':166 'containerrespons':214 'containerresponse.getproperties':218 'content':431 'contentresponseonwriteen':137 'core':168 'cosmos':3,6,25,34,49,69,73,76,94,98 'cosmosasynccli':106,155 'cosmosasynccontain':165,230 'cosmosasyncdatabas':161 'cosmoscli':88,122,154,405 'cosmosclientbuild':91,109,125 'cosmoscontain':164,297 'cosmosdatabas':160 'cosmosexcept':480 'cosmositemrespons':393 'cosmospagediter':315 'cosmosqueryrequestopt':311,314 'creat':170,194,196,237,248,406,439 'createcontainerifnotexist':210 'criteria':602 'crud':225 'custom':116 'data':343 'databas':12,162,171,192 'database.getid':195 'databaseid':204,209,216 'db':7,26,35 'dbrespons':202 'dbresponse.getproperties':205 'default':461 'delet':280 'describ':554,570 'direct':464 'directconnectionconfig':131 'directmod':130 'distinct':338 'distribut':16,40,341,448 'doc':524 'document':291,519 'documents.azure.com:443':75 'doe':243 'e':481 'e.getmessage':487 'e.getrequestcharge':491 'e.getretryafterduration':508 'e.getstatuscode':484,493,501 'east':147 'els':499 'enabl':430 'endpoint':74,92,95,110,126 'environ':70,582 'environment-specif':581 'error':453,471 'even':340 'eventu':378 'execut':549 'exist':498 'expert':587 'flatmap':201,245,260,278 'frequent':346 'gatewayconnectionconfig':132 'geo':447 'geo-distribut':446 'getcontain':217,235,301 'getdatabas':233 'getid':180,190,206,219,254,258,284,288 'github.com':530 'github.com/azure-samples/azure-cosmos-java-sql-api-samples':529 'global':15,39 'guarante':353,381 'guid':533 'handl':451,472 'header':391 'hierarchi':151 'high':335,417 'high-throughput':416 'immedi':436 'import':65,84,86,104,118,120,228,293,295,474 'input':596 'instal':44 'item':440,478,496 'java':4,10,29,83,103,117,172,198,227,292,392,473 'java.util.arrays':121 'john':242 'john.doe@example.com':270 'john@example.com':244 'key':77,80,96,99,112,113,128,129,326,329,333,423 'key-bas':79 'lag':362 'latenc':468 'latest':50 'learn.microsoft.com':526,535,539 'learn.microsoft.com/azure/cosmos-db/':525 'learn.microsoft.com/azure/cosmos-db/performance-tips-java-sdk-v4-sql':534 'learn.microsoft.com/azure/cosmos-db/troubleshoot-java-sdk-v4-sql':538 'level':158,351,352 'librari':31 'limit':505,558 'lineariz':355 'link':510 'lowest':467 'mani':337 'map':176,186,213 'match':567 'maven':513 'messag':486 'miss':604 'mode':465 'model':19 'multi':18 'multi-model':17 'my-appl':140 'mycontain':211,236,302 'mydatabas':175,185,200,234,300 'never':371 'new':90,108,124,239,255,275,285,313 'nosql':11,36 'oper':13,159,163,167,226,386 'option':312,319 'order':376,380 'out-of-ord':373 'output':576 'overview':557 'packag':514 'partit':328,332,422 'partitionkey':256,276,286 'pattern':23,43 'perform':426,532 'permiss':597 'polici':456 'pom':64 'practic':402 'prefer':443 'preferredregion':143 'prefix':359,365,369 'product':470,523 'purpos':153 'queri':290,304,318,349 'rate':504 'reactiv':22,42 'read':250,263,370 'refer':509 'region':444 'request':345,382,489 'requir':595 'resourc':511 'respons':177,187,246,261,279,390,394,432 'response.getitem':249,253,257,264,268,283,287 'response.getproperties':179,189 'response.getrequestcharge':400 'result':316 'results.foreach':321 'retri':455,506 'return':207,251,271,281 'reus':404,408 'review':588 'ru':398 'rus':384,388 'safeti':598 'sampl':528 'scalabl':428 'scenario':419 'scope':569 'sdk':8,27,54,60 'see':372 'select':305 'serviceendpoint':111,127 'session':363,367 'skill':545,561 'skill-azure-cosmos-java' 'source-sickn33' 'specif':583 'stale':357 'status':310,483 'stop':589 'string':203,303 'strong':354 'subscrib':191,220 'substitut':579 'success':601 'support':20 'sync':173 'system.err.println':482,485,488,495,503 'system.getenv':93,97 'system.out.println':193,222,247,262,323,397 'task':565 'test':585 'throughout':409 'throughput':418 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':574 'tri':476 'troubleshoot':537 'true':136,138 'unit':383 'updat':265 'url':512 'us':146,148 'use':52,347,412,463,543,559 'user':240,266,267,273,322,324,396 'user.class':259,320 'user.getid':274,277 'user.getname':325 'user.setemail':269 'useragentsuffix':139 'valid':584 'valu':339 'variabl':71 'version':63 'west':145 'within':366 'workflow':169,551 'write':377,434 'xml':45,56","prices":[{"id":"e5f3f103-767e-43e2-8f9d-97ec37cbfb63","listingId":"803e5d11-8091-4f4a-ae93-9b9d620c9473","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:32:17.851Z"}],"sources":[{"listingId":"803e5d11-8091-4f4a-ae93-9b9d620c9473","source":"github","sourceId":"sickn33/antigravity-awesome-skills/azure-cosmos-java","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-java","isPrimary":false,"firstSeenAt":"2026-04-18T21:32:17.851Z","lastSeenAt":"2026-04-24T18:50:29.817Z"}],"details":{"listingId":"803e5d11-8091-4f4a-ae93-9b9d620c9473","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"azure-cosmos-java","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34928,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"a72058f3d4406a4b7e652365afd390ce08870cea","skill_md_path":"skills/azure-cosmos-java/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-java"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"azure-cosmos-java","description":"Azure Cosmos DB SDK for Java. NoSQL database operations with global distribution, multi-model support, and reactive patterns."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/azure-cosmos-java"},"updatedAt":"2026-04-24T18:50:29.817Z"}}