.NET kullanarak Tablo için Azure Cosmos DB kullanmaya başlama

ŞUNLAR IÇIN GEÇERLIDIR: Masa

Bu makalede.NET SDK'sını kullanarak Tablo için Azure Cosmos DB'ye nasıl bağlanabileceğiniz gösterilmektedir. Bağlandıktan sonra, tablolar ve öğeler üzerinde işlemler gerçekleştirebilirsiniz.

Paket (NuGet) | Örnekler | API başvurusu | Kitaplık kaynak kodu | Geri Bildirim Ver |

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Tablo hesabı için Azure Cosmos DB. Tablo hesabı için bir API oluşturun.
• .NET 6.0 veya üzeri
• Azure Komut Satırı Arabirimi (CLI) veya Azure PowerShell

Projenizi ayarlama

.NET konsol uygulamasını oluşturma

konsol şablonuyla komutunu kullanarak dotnet new yeni bir .NET uygulaması oluşturun.

dotnet new console

komutunu kullanarak Azure.Data.Tables NuGet paketini içeri aktarındotnet add package.

dotnet add package Azure.Data.Tables

komutuyla dotnet build projeyi oluşturun.

dotnet build

Tablo için Azure Cosmos DB'ye bağlanma

Azure Cosmos DB Tablosu API'sine bağlanmak için sınıfının bir örneğini TableServiceClient oluşturun. Bu sınıf, tablolara karşı tüm işlemleri gerçekleştirmek için başlangıç noktasıdır. TableServiceClient sınıfını kullanarak Tablo hesabı api'sine bağlanmanın iki birincil yolu vardır:

• Tablo bağlantı dizesi için API ile bağlanma

bağlantı dizesi ile bağlanma

TableServiceClient için en yaygın oluşturucunun tek bir parametresi vardır:

Parametre	Örnek değer	Açıklama
connectionString	COSMOS_CONNECTION_STRING ortam değişkeni	Tablo hesabı için API'ye bağlantı dizesi

Hesap bağlantı dizesi alma

Azure CLI

1. az cosmosdb list Komutunu kullanarak kaynak grubunuzdaki ilk Azure Cosmos DB hesabının adını alın ve accountName kabuk değişkeninde depolayın.

   # Retrieve most recently created account name
   accountName=$(
       az cosmosdb list \
           --resource-group $resourceGroupName \
           --query "[0].name" \
           --output tsv
   )
   

2. komutuyla hesabın bağlantı dizesi listesinden BİRİnCİl BAĞLANTI DIZESİ'ni az-cosmosdb-keys-list bulun.

   az cosmosdb keys list \
       --resource-group $resourceGroupName \
       --name $accountName \
       --type "connection-strings" \
       --query "connectionStrings[?description == \`Primary Table Connection String\`] | [0].connectionString"
   

PowerShell

1. Kaynak grubunuzdaki Get-AzCosmosDBAccount ilk Azure Cosmos DB hesabının adını almak ve ACCOUNT_NAME kabuk değişkeninde depolamak için cmdlet'ini kullanın.

   # Retrieve most recently created account name
   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
   }
   $ACCOUNT_NAME = (
       Get-AzCosmosDBAccount @parameters |
           Select-Object -Property Name -First 1
   ).Name
   

2. cmdlet'ine sahip hesabın bağlantı dizesi listesinden BİRİnCİl BAĞLANTI DIZESİ'ni Get-AzCosmosDBAccountKey bulun.

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       Name = $ACCOUNT_NAME
       Type = "ConnectionStrings"
   }    
   Get-AzCosmosDBAccountKey @parameters |
       Select-Object -Property "Primary Table Connection String" -First 1    
   

.NET kodunuz içinde BİRİnCİl BAĞLANTI DIZESİ değerini kullanmak için, uygulamayı çalıştıran yerel makinede yeni bir ortam değişkeninde kalıcı hale getirmek.

Windows

$env:COSMOS_CONNECTION_STRING = "<cosmos-account-PRIMARY-CONNECTION-STRING>"

Linux / macOS

export COSMOS_CONNECTION_STRING="<cosmos-account-PRIMARY-CONNECTION-STRING>"

bağlantı dizesi ile TableServiceClient oluşturma

Tek parametre olarak ortam değişkeniyle COSMOS_CONNECTION_STRING TableServiceClient sınıfının yeni bir örneğini oluşturun.

// New instance of TableServiceClient class using a connection string
TableServiceClient client = new(
    connectionString: Environment.GetEnvironmentVariable("COSMOS_CONNECTION_STRING")!
);

Uygulamanızı derleme

Uygulamanızı oluştururken kodunuz öncelikli olarak dört tür kaynakla etkileşim kurar:

• Azure Cosmos DB verileriniz için benzersiz üst düzey ad alanı olan Tablo hesabı için API.

• Hesabınızdaki tek tek öğeler kümesini içeren tablolar.

• Tablonuzdaki tek bir öğeyi temsil eden öğeler.

Aşağıdaki diyagramda bu kaynaklar arasındaki ilişki gösterilmektedir.

En üstte bir Azure Cosmos DB hesabını gösteren hiyerarşik diyagram. Hesabın iki alt tablo düğümü vardır. Tablo düğümlerinden biri iki alt öğe içerir.

Her kaynak türü bir veya daha fazla ilişkili .NET sınıfı veya arabirimiyle temsil edilir. En yaygın türlerin listesi aşağıdadır:

Sınıf	Açıklama
TableServiceClient	Bu istemci sınıfı, Azure Cosmos DB hizmeti için istemci tarafı mantıksal gösterimi sağlar. İstemci nesnesi, hizmette istekleri yapılandırmak ve yürütmek için kullanılır.
TableClient	Bu istemci sınıfı, hizmette henüz var olabilen veya varolmayan bir tabloya başvurudur. Tabloya erişmeye veya ona karşı bir işlem gerçekleştirmeye çalıştığınızda tablo sunucu tarafında doğrulanır.
ITableEntity	Bu arabirim, tabloda oluşturulan veya tablodan sorgulanan öğeler için temel arabirimdir. Bu arabirim, Tablo için API'deki öğeler için tüm gerekli özellikleri içerir.
TableEntity	Bu sınıf, anahtar-değer çiftlerinin ITableEntity sözlüğü olarak arabiriminin genel bir uygulamasıdır.

Aşağıdaki kılavuzlarda, uygulamanızı derlemek için bu sınıfların her birinin nasıl kullanılacağı gösterilmektedir.

Kılavuz	Açıklama
Tablo oluştur	Tablo oluştur
Öğe oluşturma	Öğe oluşturma
Öğe okuma	Öğeleri okuma

Ayrıca bkz.

• Paket (NuGet)
• Örnekler
• API başvurusu
• Kitaplık kaynak kodu
• Geri BildirimDe bulunmak

Sonraki adımlar

Tablo hesabı için bir API'ye bağlandığınıza göre, tablo oluşturmak ve yönetmek için sonraki kılavuzu kullanın.

.NET kullanarak Tablo için Azure Cosmos DB'de tablo oluşturma