Hızlı Başlangıç: .NET için Azure SDK ile Tablo için Azure Cosmos DB kullanma

• .NET
• Python
• Node.js
• Java
• Git

Önemli

99,999% kullanılabilirlik hizmet düzeyi sözleşmesi (SLA), anında otomatik ölçeklendirme ve birden çok bölgede otomatik yük devretme ile yüksek ölçekli senaryolar için bir veritabanı çözümü mü arıyorsunuz? NoSQL için Azure Cosmos DB'ye göz önünde bulundurun.

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 | Paket (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.

1. Boş bir dizinde bir terminal açın.

2. Henüz kimlik doğrulaması yapmadıysanız, azd auth login kullanarak Azure Geliştirici CLI'da kimlik doğrulaması yapın. Tercih ettiğiniz Azure kimlik bilgilerini kullanarak CLI'da kimlik doğrulaması yapmak için araç tarafından belirtilen adımları izleyin.

   azd auth login
   

3. Projeyi başlatmak için kullanın azd init .

   azd init --template cosmos-db-table-dotnet-quickstart
   

4. Başlatma sırasında benzersiz bir ortam adı yapılandırın.

5. azd up kullanarak Azure Cosmos DB hesabını dağıtın. Bicep şablonları ayrıca örnek bir web uygulamasını dağıtır.

   azd up
   

6. Sağ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.

7. 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.
   

8. Tarayıcıda web uygulamanıza gitmek için konsoldaki URL'yi kullanın. Çalışan uygulamanın çıktısını gözlemleyin.

İstemci kitaplığını yükleme

İstemci kitaplığı, Azure.Data.Tables paketi olarak NuGet aracılığıyla kullanılabilir.

1. Bir terminal açın ve klasöre /src/web gidin.

   cd ./src/web
   

2. Henüz yüklü değilse, Azure.Data.Tables paketini dotnet add package kullanarak yükleyin.

   dotnet add package Azure.Data.Tables
   

3. Girdinin dosyasını açın ve gözden geçirin.

Kitaplıkları içeri aktarma

Uygulama kodunuza Azure.Identity ve Azure.Data.Tables ad alanlarını dahil edin.

using Azure.Identity;

using Azure.Data.Tables;

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

• İstemcinin kimliğini doğrulama
• Tablo alma
• Varlık oluşturma
• Bir varlık al
• Sorgu varlıkları

Şablondaki örnek kod, cosmicworks-products adlı bir 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, TableServiceClient sınıfının yeni bir örneğini oluşturur.

DefaultAzureCredential credential = new();

TableServiceClient serviceClient = new(
    endpoint: new Uri("<azure-cosmos-db-table-account-endpoint>"),
    credential
);

Masa satın al

Bu örnek, TableClient sınıfının GetTableClient yöntemini kullanarak TableServiceClient sınıfının bir örneğini 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; }
};

Tabloda bir varlık oluşturmak için Product sınıfını kullanarak TableClient.AddEntityAsync<T> öğesini çağırın.

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
);

Bir varlık edin

yöntemini kullanarak TableClient.GetEntityAsync<T> bir tablodan belirli bir varlığı alabilirsiniz. partitionKey ve rowKey parametrelerini sağlayarak bu varlığın hızlı nokta okumasını gerçekleştirmek için doğru satırı belirleyin.

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, ITableEntity gibi sınıflandırılmış modeller kullanmanın bir avantajı olan Dil Tümleşik Sorgu (LINQ) söz dizimini kullanarak ürünleri Product kategoriye 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

İlgili içerik

• Node.js Hızlı Başlangıç
• Python Hızlı Başlangıcı
• Java Hızlı Başlangıcı
• Hızlı Başlangıç'a gidin