[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6FD13DN8SHVGGCTRQCWRGTW":3,"skill-same:01M6FD13DN8SHVGGCTRQCWRGTW":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":22,"linkOnly":23,"markdownContent":24,"markdownBody":24,"frontMatter":25,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M6FD13DN8SHVGGCTRQCWRGTW","azure-cosmos-java",null,"ComeOnOliver\u002Fskillshub","ComeOnOliver","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F43215937?v=4","01M6E5JNFECJAAVFE0W7SMWWD2","Haoran Shu","01M6E5JNNDQS7AJZDYFQ8TPZCK",66,"MIT","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fmicrosoft\u002Fskills\u002Fazure-cosmos-java\u002FSKILL.md",[],[18,19,20,21],"azure","azure cosmos java","java","cosmos","2026-11-10 10:12:30",false,"# 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\u003Cdependency>\n    \u003CgroupId>com.azure\u003C\u002FgroupId>\n    \u003CartifactId>azure-cosmos\u003C\u002FartifactId>\n    \u003Cversion>LATEST\u003C\u002Fversion>\n\u003C\u002Fdependency>\n```\n\nOr use Azure SDK BOM:\n\n```xml\n\u003CdependencyManagement>\n    \u003Cdependencies>\n        \u003Cdependency>\n            \u003CgroupId>com.azure\u003C\u002FgroupId>\n            \u003CartifactId>azure-sdk-bom\u003C\u002FartifactId>\n            \u003Cversion>{bom_version}\u003C\u002Fversion>\n            \u003Ctype>pom\u003C\u002Ftype>\n            \u003Cscope>import\u003C\u002Fscope>\n        \u003C\u002Fdependency>\n    \u003C\u002Fdependencies>\n\u003C\u002FdependencyManagement>\n\n\u003Cdependencies>\n    \u003Cdependency>\n        \u003CgroupId>com.azure\u003C\u002FgroupId>\n        \u003CartifactId>azure-cosmos\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n```\n\n## Environment Variables\n\n```bash\nCOSMOS_ENDPOINT=https:\u002F\u002F\u003Caccount>.documents.azure.com:443\u002F\nCOSMOS_KEY=\u003Cyour-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` \u002F `CosmosAsyncClient` | Account-level operations |\n| `CosmosDatabase` \u002F `CosmosAsyncDatabase` | Database operations |\n| `CosmosContainer` \u002F `CosmosAsyncContainer` | Container\u002Fitem operations |\n\n## Core Workflow\n\n### Create Database\n\n```java\n\u002F\u002F Sync\nclient.createDatabaseIfNotExists(\"myDatabase\")\n    .map(response -> client.getDatabase(response.getProperties().getId()));\n\n\u002F\u002F 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\", \"\u002FpartitionKey\")\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\u002F\u002F Create\ncontainer.createItem(new User(\"1\", \"John Doe\", \"john@example.com\"))\n    .flatMap(response -> {\n        System.out.println(\"Created: \" + response.getItem());\n        \u002F\u002F 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        \u002F\u002F 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        \u002F\u002F 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\u003CUser> 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\u003CUser> 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:\u002F\u002Fcentral.sonatype.com\u002Fartifact\u002Fcom.azure\u002Fazure-cosmos |\n| API Documentation | https:\u002F\u002Fazuresdkdocs.z19.web.core.windows.net\u002Fjava\u002Fazure-cosmos\u002Flatest\u002Findex.html |\n| Product Docs | https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fcosmos-db\u002F |\n| Samples | https:\u002F\u002Fgithub.com\u002FAzure-Samples\u002Fazure-cosmos-java-sql-api-samples |\n| Performance Guide | https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fcosmos-db\u002Fperformance-tips-java-sdk-v4-sql |\n| Troubleshooting | https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fcosmos-db\u002Ftroubleshoot-java-sdk-v4-sql |\n",{},"main","def8531e65114c0fca8fb8551c1871ee0eed705c","skills\u002Fmicrosoft\u002Fskills\u002Fazure-cosmos-java",24,"https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub","https:\u002F\u002Fskillshub.wtf","https:\u002F\u002Fgithub.com\u002FComeOnOliver","AI & Blockchain Engineer\r\n","2026-06-24 22:07:19",{"source":7,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add ComeOnOliver\u002Fskillshub --skill azure-cosmos-java",{"tool":41,"command":42},"bunx","bunx skills add ComeOnOliver\u002Fskillshub --skill azure-cosmos-java",{"tool":44,"command":45},"pnpm","pnpm dlx skills add ComeOnOliver\u002Fskillshub --skill azure-cosmos-java","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fmicrosoft\u002Fskills\u002Fazure-cosmos-java\u002FSKILL.md",true,[],[50,64,74,83,89,96],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":60,"publishedAt":22},"01M6FKJN13GMG4KY57J3QD8GY5","model-hierarchy-skill","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzscole\u002Fmodel-hierarchy-skill\u002Fmodel-hierarchy-skill\u002FSKILL.md",[55],{"categoryNo":56,"categoryName":57,"taxonomyType":58,"taxonomyTypeDesc":59},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[61,62,63],"model","model hierarchy","model hierarchy skill",{"skillNo":65,"name":66,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":70,"publishedAt":22},"01M6FKJJJ6GCAMR4PPPRD12M5X","zoom-mcp","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-mcp\u002FSKILL.md",[69],{"categoryNo":56,"categoryName":57,"taxonomyType":58,"taxonomyTypeDesc":59},[71,72,73],"MCP","zoom","zoom mcp",{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":22},"01M6FKJE3KYT3KPEZMEEHYKA6K","zoom-apps-sdk","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[80,81,82,72],"sdk","zoom apps sdk","apps",{"skillNo":84,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":22},"01M6FKJ9EDH9Q5VWDF8HAJRSP0","windows","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwindows\u002FSKILL.md",[],[85],{"skillNo":90,"name":91,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":95,"publishedAt":22},"01M6FKJ666BEEFC3AE9GJ72Q93","whiteboard","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwhiteboard\u002FSKILL.md",[94],{"categoryNo":56,"categoryName":57,"taxonomyType":58,"taxonomyTypeDesc":59},[91],{"skillNo":97,"name":98,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":22},"01M6FKJ21WFCDGTJQ2Q91T9DVW","websockets","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwebsockets\u002FSKILL.md",[],[98]]