82 строки
4.4 KiB
Markdown
82 строки
4.4 KiB
Markdown
[](https://www.nuget.org/packages/Microsoft.Azure.Cosmos)
|
|
[](https://www.nuget.org/packages/Microsoft.Azure.Cosmos)
|
|
|
|
# Microsoft Azure Cosmos DB .NET SDK Version 3
|
|
|
|
This client library enables client applications to connect to Azure Cosmos DB for NoSQL. Azure Cosmos DB is a globally distributed, multi-model database service. For more information, refer to https://azure.microsoft.com/services/cosmos-db/.
|
|
|
|
```csharp
|
|
CosmosClient client = new CosmosClient("https://mycosmosaccount.documents.azure.com:443/", "mysupersecretkey");
|
|
Database database = await client.CreateDatabaseIfNotExistsAsync("MyDatabaseName");
|
|
Container container = await database.CreateContainerIfNotExistsAsync(
|
|
"MyContainerName",
|
|
"/partitionKeyPath",
|
|
400);
|
|
|
|
// Create an item
|
|
dynamic testItem = new { id = "MyTestItemId", partitionKeyPath = "MyTestPkValue", details = "it's working", status = "done" };
|
|
ItemResponse<dynamic> createResponse = await container.CreateItemAsync(testItem);
|
|
|
|
// Query for an item
|
|
using (FeedIterator<dynamic> feedIterator = container.GetItemQueryIterator<dynamic>(
|
|
"select * from T where T.status = 'done'"))
|
|
{
|
|
while (feedIterator.HasMoreResults)
|
|
{
|
|
FeedResponse<dynamic> response = await feedIterator.ReadNextAsync();
|
|
foreach (var item in response)
|
|
{
|
|
Console.WriteLine(item);
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Install via [Nuget.org](https://www.nuget.org/packages/Microsoft.Azure.Cosmos/)
|
|
|
|
`Install-Package Microsoft.Azure.Cosmos`
|
|
|
|
For available versions, see [SDK versioning](./docs/versioning.md).
|
|
|
|
## Useful links
|
|
|
|
- [Get Started APP](https://docs.microsoft.com/azure/cosmos-db/sql-api-get-started)
|
|
- [GitHub samples](https://github.com/Azure/azure-cosmos-dotnet-v3/tree/master/Microsoft.Azure.Cosmos.Samples)
|
|
- [SDK Best practices](https://docs.microsoft.com/azure/cosmos-db/sql/best-practice-dotnet)
|
|
- [MultiMaster samples](https://github.com/markjbrown/azure-cosmosdb-dotnet/tree/master/samples/MultiMaster)
|
|
- [Resource Model of Azure Cosmos DB Service](https://docs.microsoft.com/azure/cosmos-db/sql-api-resources)
|
|
- [Cosmos DB Resource URI](https://docs.microsoft.com/rest/api/documentdb/documentdb-resource-uri-syntax-for-rest)
|
|
- [Partitioning](https://docs.microsoft.com/azure/cosmos-db/partition-data)
|
|
- [Introduction to Azure Cosmos DB for NoSQL queries](https://docs.microsoft.com/azure/cosmos-db/sql-api-sql-query)
|
|
- [SDK API](https://docs.microsoft.com/dotnet/api/microsoft.azure.cosmos?view=azure-dotnet)
|
|
- [Using emulator](https://github.com/Azure/azure-documentdb-dotnet/blob/master/docs/documentdb-nosql-local-emulator.md)
|
|
- [Capture traces](https://github.com/Azure/azure-documentdb-dotnet/blob/master/docs/documentdb-sdk_capture_etl.md)
|
|
- [Release notes](https://github.com/Azure/azure-cosmos-dotnet-v3/blob/master/changelog.md)
|
|
- [Diagnose and troubleshooting](https://docs.microsoft.com/azure/cosmos-db/troubleshoot-dot-net-sdk)
|
|
|
|
## Microsoft Open Source Code of Conduct
|
|
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
|
|
|
Resources:
|
|
|
|
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
|
|
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
|
|
- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns
|
|
|
|
|
|
## Contributing
|
|
|
|
For details on contributing to this repository, see the [contributing guide](CONTRIBUTING.md).
|
|
|
|
This project welcomes contributions and suggestions. Most contributions require you to agree to a
|
|
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
|
|
the rights to use your contribution. For details, visit https://cla.microsoft.com.
|
|
|
|
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
|
|
a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
|
|
provided by the bot. You will only need to do this once across all repos using our CLA.
|
|
|
|
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
|
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
|
|
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
|