Snabbstart: Azure Cosmos DB för tabellbibliotek för .NET

GÄLLER FÖR: Bord

Den här snabbstarten visar hur du kommer igång med Azure Cosmos DB for Table från ett .NET-program. Azure Cosmos DB for Table är ett schemalöst datalager som gör att program kan lagra strukturerade tabelldata i molnet. Du lär dig hur du skapar tabeller, rader och utför grundläggande uppgifter i din Azure Cosmos DB-resurs med hjälp av Azure SDK för .NET

API-referensdokumentation Bibliotek källkodspaket | (NuGet) | Azure Developer CLI |

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• Azure Developer CLI
• Docker Desktop
• .NET 9.0

Initiera projektet

Använd Azure Developer CLI (azd) för att skapa ett Azure Cosmos DB för tabellkonto och distribuera ett containerbaserat exempelprogram. Exempelprogrammet använder klientbiblioteket för att hantera, skapa, läsa och fråga efter exempeldata.

1. Öppna en terminal i en tom katalog.

2. Om du inte redan är autentiserad autentiserar du till Azure Developer CLI med .azd auth login Följ stegen som anges av verktyget för att autentisera till CLI med dina önskade Azure-autentiseringsuppgifter.

   azd auth login
   

3. Använd azd init för att initiera projektet.

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

4. Under initieringen konfigurerar du ett unikt miljönamn.

5. Distribuera Azure Cosmos DB-kontot med .azd up Bicep-mallarna distribuerar också ett exempelwebbprogram.

   azd up
   

6. Under etableringsprocessen väljer du din prenumeration, önskad plats och målresursgrupp. Vänta tills etableringsprocessen har slutförts. Processen kan ta ungefär fem minuter.

7. När etableringen av dina Azure-resurser är klar inkluderas en URL till det webbprogram som körs i utdata.

   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. Använd URL:en i konsolen för att navigera till webbprogrammet i webbläsaren. Observera utdata från appen som körs.

   

Installera klientbiblioteket

Klientbiblioteket är tillgängligt via NuGet som Azure.Data.Tables paket.

1. Öppna en terminal och navigera till /src/web mappen.

   cd ./src/web
   

2. Om det inte redan är installerat installerar du Azure.Data.Tables paketet med .dotnet add package

   dotnet add package Azure.Data.Tables
   

3. Öppna och granska filen src/web/Microsoft.Samples.Cosmos.Table.Quickstart.Web.csproj för att verifiera att posten Azure.Data.Tables finns.

Objektmodell

Kodexempel

• Autentisera klienten
• Hämta en tabell
• Skapa ett objekt
• Hämta ett objekt
• Frågeobjekt

Exempelkoden i mallen använder en tabell med namnet cosmicworks-products. Tabellen cosmicworks-products innehåller information som namn, kategori, kvantitet, pris, en unik identifierare och en försäljningsflagga för varje produkt. Containern använder en unik identifierare* som radnyckel och kategori som partitionsnyckel.

Autentisera klienten

Det här exemplet skapar en ny instans av TableServiceClient klassen.

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

Hämta en tabell

Det här exemplet skapar en instans av TableClient klassen med GetTableClient hjälp av -metoden för TableServiceClient klassen.

TableClient client = serviceClient.GetTableClient(
    tableName: "<azure-cosmos-db-table-name>"
);

Skapa ett objekt

Det enklaste sättet att skapa ett nytt objekt i en tabell är att skapa en klass som implementerar ITableEntity gränssnittet. Du kan sedan lägga till dina egna egenskaper i klassen för att fylla i kolumner med data i den tabellraden.

public record Product : ITableEntity
{
    public string RowKey { get; set; } = $"{Guid.NewGuid()}";

    public string PartitionKey { get; set; } = String.Empty;

    public string Name { get; set; } = String.Empty;

    public int Quantity { get; set; } = 0;

    public decimal Price { get; set; } = 0.0m;

    public bool Clearance { get; set; } = false;

    public ETag ETag { get; set; } = ETag.All;

    public DateTimeOffset? Timestamp { get; set; }
};

Skapa ett objekt i samlingen med hjälp Product av klassen genom att anropa TableClient.AddEntityAsync<T>.

Product entity = new()
{
    RowKey = "68719518391",
    PartitionKey = "gear-surf-surfboards",
    Name = "Surfboard",
    Quantity = 10,
    Price = 300.00m,
    Clearance = true
};

Response response = await client.UpsertEntityAsync<Product>(
    entity: entity,
    mode: TableUpdateMode.Replace
);

Hämta ett objekt

Du kan hämta ett specifikt objekt från en tabell med hjälp av TableClient.GetEntityAsync<T> metoden . Ange parametrarna partitionKey och rowKey för att identifiera rätt rad för att utföra en snabbpunktsläsning av objektet.

Response<Product> response = await client.GetEntityAsync<Product>(
    rowKey: "68719518391",
    partitionKey: "gear-surf-surfboards"
);

Frågeobjekt

När du har infogat ett objekt kan du också köra en fråga för att hämta alla objekt som matchar ett visst filter med hjälp TableClient.Query<T> av metoden. Det här exemplet filtrerar produkter efter kategori med linq-syntax, vilket är en fördel med att använda typade ITableEntity modeller som Product klassen.

string category = "gear-surf-surfboards";

AsyncPageable<Product> results = client.QueryAsync<Product>(
    product => product.PartitionKey == category
);

Parsa de sidnumrerade resultaten av frågan genom att loopa igenom varje sida med resultat med hjälp av en asynkron loop.

List<Product> entities = new();
await foreach (Product product in results)
{
    entities.Add(product);
}

Rensa resurser

När du inte längre behöver exempelprogrammet eller resurserna tar du bort motsvarande distribution och alla resurser.

azd down

Relaterat innehåll

• Node.js snabbstart
• Snabbstart för Python
• Snabbstart för Java