Aracılığıyla paylaş

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

  • Şunlara uygulanır: ✅ Table

Bu hızlı başlangıçta, Node.js için Azure SDK'sını kullanarak tablo için temel bir 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. Node.js 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 | Kütüphane kaynak kodu | Paket (npm) | Azure Geliştirici CLI

Önkoşullar

  • Azure Geliştirici CLI
  • Docker Desktop
  • Node.js 22 veya üzeri

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 Developer CLI'de 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-nodejs-quickstart

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

  5. tr-TR: azd up kullanarak Azure Cosmos DB hesabını dağıtın. Bicep şablonları ayrıca örnek bir web uygulaması 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 çıkışını gözlemleyin.

Çalışan web uygulamasının ekran görüntüsü.

Çalışan web uygulamasının ekran görüntüsü.

İstemci kitaplığını yükleme

İstemci kitaplığı npm aracılığıyla paket olarak @azure/data-tables kullanılabilir.

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

    cd ./src/ts

  2. Henüz yüklü değilse, @azure/data-tables paketini npm install kullanarak yükleyin.

    npm install --save @azure/data-tables

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

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

    cd ./src/js

  2. Henüz yüklü değilse, @azure/data-tables paketini npm install kullanarak yükleyin.

    npm install --save @azure/data-tables

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

Kitaplıkları içeri aktarma

DefaultAzureCredential, TableServiceClientve TableClient türlerini uygulama kodunuz içine aktarın.

import { DefaultAzureCredential } from '@azure/identity';
import { TableServiceClient, TableClient } from '@azure/data-tables';

Tüm gerekli türleri uygulama kodunuz içine aktar.

import { DefaultAzureCredential, TokenCredential } from '@azure/identity';
import { TableServiceClient, TableClient, TableEntityResult, GetTableEntityResponse, TableEntityResultPage, TableEntityQueryOptions } from '@azure/data-tables';

Nesne modeli

İsim Açıklama
TableServiceClient Bu tür birincil istemci türüdür ve hesap genelindeki meta verileri veya veritabanlarını yönetmek için kullanılır.
TableClient Bu tür, hesaptaki bir tablonun istemcisini temsil eder.

Kod örnekleri

Şablondaki örnek kod, cosmicworks-products adında 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 türünün yeni bir örneğini oluşturur.

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

const credential = new DefaultAzureCredential();

let client = new TableServiceClient("<azure-cosmos-db-table-account-endpoint>", credential);

Tablo alma

Bu örnek, TableClient türünün GetTableClient işlevini kullanarak TableServiceClient türünün bir örneğini oluşturur.

let table: TableClient = new TableClient("<azure-cosmos-db-table-account-endpoint>", "<azure-cosmos-db-table-name>", credential);

let table = new TableClient("<azure-cosmos-db-table-account-endpoint>", "<azure-cosmos-db-table-name>", credential);

Varlık oluşturma

Tabloda yeni bir varlık oluşturmanın en kolay yolu, 'den TableEntity yeni bir arabirim türetmek ve ardından bu türde yeni bir nesne oluşturmaktır.

export interface Product extends TableEntity {
    name: string;
    quantity: number;
    price: number;
    clearance: boolean;
}

const entity: Product = {
    rowKey: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    partitionKey: 'gear-surf-surfboards',
    name: 'Yamba Surfboard',
    quantity: 12,
    price: 850.00,
    clearance: false
};

Tabloda yeni öğe oluşturmanın en kolay yolu JSON nesnesi oluşturmaktır.

const entity = {
    rowKey: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    partitionKey: 'gear-surf-surfboards',
    name: 'Yamba Surfboard',
    quantity: 12,
    price: 850.00,
    clearance: false
};

Örnekteki yöntemini upsertEntity kullanarak TableService tabloda bir varlık oluşturun.

await table.upsertEntity<Product>(entity, "Replace"); 

await table.upsertEntity(entity, "Replace");

Bir varlık edin

Yöntemini, varlığın satır anahtarını ve varlığın getEntitybölüm anahtarını kullanarak tablodan belirli bir varlığı alabilirsiniz.

const response: GetTableEntityResponse<TableEntityResult<Product>> = await table.getEntity<Product>(partitionKey, rowKey);

const entity: Product = response as Product;

const entity = await table.getEntity(partitionKey, rowKey);

Sorgu varlıkları

Bir varlık ekledikten sonra, OData filtresiyle kullanarak listEntities belirli bir filtreyle eşleşen tüm varlıkları almak için bir sorgu da çalıştırabilirsiniz.

const partitionKey: string = 'gear-surf-surfboards';

const filter: string = odata`PartitionKey eq '${partitionKey}'`

const queryOptions: TableEntityQueryOptions = { filter: filter }

const entities: PagedAsyncIterableIterator<TableEntityResult<Product>, TableEntityResultPage<Product>> = table.listEntities<Product>({ queryOptions: queryOptions });

const partitionKey = 'gear-surf-surfboards';

const entities = table.listEntities({
    queryOptions: {
        filter: odata`PartitionKey eq '${partitionKey}'`
    }
});

zaman uyumsuz for await bir döngü kullanarak entities sayfalandırılmış kümesinin sorgu sonuçlarını ayrıştırın.

for await(const entity of entities) {
    // Do something
}

for await(const entity of entities) {
    // Do something
}

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

  • Last updated on