Hızlı Başlangıç: .NET için Azure SDK ile Tablo için Azure Cosmos DB kullanma
Bu hızlı başlangıçta.NET için Azure SDK'sını kullanarak temel bir Tablo için Azure Cosmos DB uygulaması dağıtacaksınız. Tablo için Azure Cosmos DB, uygulamaların yapılandırılmış tablo verilerini bulutta depolamasına olanak sağlayan şemasız bir veri deposudur. .NET için Azure SDK'sını kullanarak Azure Cosmos DB kaynağınızda tablo, satır oluşturma ve temel görevleri gerçekleştirme hakkında bilgi edinirsiniz.
API başvuru belgeleri | Kitaplık kaynak kodu | Paketi (NuGet) | Azure Geliştirici CLI
Önkoşullar
- Azure Geliştirici CLI
- Docker Desktop
- .NET 9.0
Azure hesabınız yoksa, başlamadan önce ücretsiz hesap oluşturun.
Projeyi başlatma
Tablo hesabı için Azure Cosmos DB oluşturmak ve kapsayıcılı örnek bir uygulama dağıtmak için Azure Geliştirici CLI'sini (azd) kullanın. Örnek uygulama örnek verileri yönetmek, oluşturmak, okumak ve sorgulamak için istemci kitaplığını kullanır.
Boş bir dizinde bir terminal açın.
Henüz kimlik doğrulaması yapmadıysanız kullanarak
azd auth loginAzure Geliştirici CLI'sinde kimlik doğrulamasından geçin. Tercih ettiğiniz Azure kimlik bilgilerini kullanarak CLI'da kimlik doğrulaması yapmak için araç tarafından belirtilen adımları izleyin.azd auth loginProjeyi başlatmak için kullanın
azd init.azd init --template cosmos-db-table-dotnet-quickstartBaşlatma sırasında benzersiz bir ortam adı yapılandırın.
Kullanarak
azd upAzure Cosmos DB hesabını dağıtın. Bicep şablonları ayrıca örnek bir web uygulaması dağıtır.azd upSağlama işlemi sırasında aboneliğinizi, istediğiniz konumu ve hedef kaynak grubunu seçin. Sağlama işleminin tamamlanmasını bekleyin. İşlem yaklaşık beş dakika sürebilir.
Azure kaynaklarınızın sağlanması tamamlandıktan sonra, çalışan web uygulamasının URL'si çıktıya eklenir.
Deploying services (azd deploy) (✓) Done: Deploying service web - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io> SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.Tarayıcıda web uygulamanıza gitmek için konsoldaki URL'yi kullanın. Çalışan uygulamanın çıkışını gözlemleyin.
İstemci kitaplığını yükleme
İstemci kitaplığı NuGet aracılığıyla paket olarak Azure.Data.Tables kullanılabilir.
Bir terminal açın ve klasöre
/src/webgidin.cd ./src/webHenüz yüklü değilse, kullanarak paketini
dotnet add packageyükleyinAzure.Data.Tables.dotnet add package Azure.Data.TablesGirdinin var olduğunu
Azure.Data.Tablesdoğrulamak için src/web/Microsoft.Samples.Cosmos.Table.Quickstart.Web.csproj dosyasını açın ve gözden geçirin.
Nesne modeli
| Veri Akışı Adı | Açıklama |
|---|---|
| TableServiceClient | Bu sınıf birincil istemci sınıfıdır ve hesap genelindeki meta verileri veya veritabanlarını yönetmek için kullanılır. |
| TableClient | Bu sınıf, hesaptaki bir tablonun istemcisini temsil eder. |
Kod örnekleri
Şablondaki örnek kod adlı cosmicworks-productsbir tablo kullanır. Tabloda cosmicworks-products ad, kategori, miktar, fiyat, benzersiz tanımlayıcı ve her ürün için satış bayrağı gibi ayrıntılar yer alır. Kapsayıcı, satır anahtarı olarak benzersiz bir tanımlayıcı ve bölüm anahtarı olarak kategori kullanır.
İstemcinin kimliğini doğrulama
Bu örnek, sınıfının yeni bir örneğini TableServiceClient oluşturur.
DefaultAzureCredential credential = new();
TableServiceClient serviceClient = new(
endpoint: new Uri("<azure-cosmos-db-table-account-endpoint>"),
credential
);
Tablo alma
Bu örnek, sınıfının yöntemini kullanarak GetTableClient sınıfının bir örneğini TableClient TableServiceClient oluşturur.
TableClient client = serviceClient.GetTableClient(
tableName: "<azure-cosmos-db-table-name>"
);
Varlık oluşturma
Tabloda yeni bir varlık oluşturmanın en kolay yolu arabirimini uygulayan ITableEntity bir sınıf oluşturmaktır. Ardından, bu tablo satırındaki veri sütunlarını doldurmak için sınıfına kendi özelliklerinizi ekleyebilirsiniz.
public record Product : ITableEntity
{
public required string RowKey { get; set; }
public required string PartitionKey { get; set; }
public required string Name { get; set; }
public required int Quantity { get; set; }
public required decimal Price { get; set; }
public required bool Clearance { get; set; }
public ETag ETag { get; set; } = ETag.All;
public DateTimeOffset? Timestamp { get; set; }
};
öğesini çağırarak TableClient.AddEntityAsync<T>sınıfını Product kullanarak tabloda bir varlık oluşturun.
Product entity = new()
{
RowKey = "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
PartitionKey = "gear-surf-surfboards",
Name = "Surfboard",
Quantity = 10,
Price = 300.00m,
Clearance = true
};
Response response = await client.UpsertEntityAsync<Product>(
entity: entity,
mode: TableUpdateMode.Replace
);
Varlık alma
yöntemini kullanarak TableClient.GetEntityAsync<T> bir tablodan belirli bir varlığı alabilirsiniz. Bu varlığın hızlı nokta okumasını partitionKey gerçekleştirmek için doğru satırı tanımlamak için ve rowKey parametresini sağlayın.
Response<Product> response = await client.GetEntityAsync<Product>(
rowKey: "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
partitionKey: "gear-surf-surfboards"
);
Sorgu varlıkları
Bir varlık ekledikten sonra, yöntemini kullanarak TableClient.Query<T> belirli bir filtreyle eşleşen tüm varlıkları almak için bir sorgu da çalıştırabilirsiniz. Bu örnek, sınıf gibi yazılan ITableEntity modelleri kullanmanın bir avantajı olan Dil Tümleşik Sorgu (LINQ) söz dizimini kullanarak ürünleri kategoriye Product göre filtreler.
string category = "gear-surf-surfboards";
AsyncPageable<Product> results = client.QueryAsync<Product>(
product => product.PartitionKey == category
);
Zaman uyumsuz döngü kullanarak sonuçların her sayfasında döngü yaparak sorgunun sayfalandırılmış sonuçlarını ayrıştırın.
List<Product> entities = new();
await foreach (Product product in results)
{
entities.Add(product);
}
Kaynakları temizleme
Örnek uygulamaya veya kaynaklara artık ihtiyacınız kalmadığında, ilgili dağıtımı ve tüm kaynakları kaldırın.
azd down