Bagikan melalui

Mulai Cepat: Menggunakan Azure Cosmos DB untuk Tabel dengan Azure SDK untuk Java

  • Berlaku untuk: ✅ Table

Dalam panduan memulai cepat ini, Anda mendeploy aplikasi dasar Azure Cosmos DB untuk Tabel menggunakan Azure SDK untuk Java. Azure Cosmos DB for Table adalah penyimpanan data tanpa skema yang memungkinkan aplikasi menyimpan data tabel terstruktur di cloud. Anda mempelajari cara membuat tabel, baris, dan melakukan tugas dasar dalam sumber daya Azure Cosmos DB Anda menggunakan Azure SDK untuk Java.

Dokumentasi referensi API | Kode sumber pustaka | Paket (Maven) | Azure Developer CLI

Prasyarat

  • Azure Developer CLI
  • Desktop Docker
  • Java 21

Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.

Menginisialisasi proyek

Gunakan Azure Developer CLI (azd) untuk membuat akun Azure Cosmos DB for Table dan menyebarkan aplikasi sampel kontainer. Aplikasi sampel menggunakan pustaka klien untuk mengelola, membuat, membaca, dan mengkueri data sampel.

  1. Buka terminal di direktori kosong.

  2. Jika Anda belum diautentikasi, autentikasi ke Azure Developer CLI menggunakan azd auth login. Ikuti langkah-langkah yang ditentukan oleh alat untuk mengautentikasi ke CLI menggunakan kredensial Azure pilihan Anda.

    azd auth login

  3. Gunakan azd init untuk menginisialisasi proyek.

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

  4. Selama inisialisasi, konfigurasikan nama lingkungan yang unik.

  5. Sebarkan akun Azure Cosmos DB menggunakan azd up. Templat Bicep juga menyebarkan sebuah contoh aplikasi web.

    azd up

  6. Selama proses provisi, pilih langganan Anda, lokasi yang diinginkan, dan grup sumber daya target. Tunggu hingga proses provisi selesai. Prosesnya dapat memakan waktu sekitar lima menit.

  7. Setelah provisi sumber daya Azure Anda selesai, URL ke aplikasi web yang sedang berjalan disertakan dalam output.

    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. Gunakan URL di konsol untuk menavigasi ke aplikasi web Anda di browser. Amati output aplikasi yang sedang berjalan.

Cuplikan layar aplikasi web yang sedang berjalan.

Memasang pustaka klien

Pustaka klien tersedia melalui Maven, sebagai azure-data-tables paket.

  1. Navigasi ke /src/web folder dan buka file pom.xml .

    cd ./src

  2. Jika belum ada, tambahkan entri untuk azure-data-tables paket.

    <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-data-tables</artifactId>
</dependency>

Mengimpor pustaka

Impor semua namespace yang diperlukan ke dalam kode aplikasi Anda.

import com.azure.core.http.rest.PagedFlux;
import com.azure.data.tables.TableAsyncClient;
import com.azure.data.tables.TableClientBuilder;
import com.azure.data.tables.models.ListEntitiesOptions;
import com.azure.data.tables.models.TableEntity;
import com.azure.identity.DefaultAzureCredential;
import com.azure.identity.DefaultAzureCredentialBuilder;

Model objek

Nama Deskripsi
TableServiceAsyncClient Jenis ini adalah jenis klien utama dan digunakan untuk mengelola metadata atau database di seluruh akun.
TableAsyncClient Tipe ini mewakili klien untuk tabel dalam akun.

Contoh kode

Kode sampel dalam templat menggunakan tabel bernama cosmicworks-products. Tabel cosmicworks-products berisi detail seperti nama, kategori, kuantitas, harga, pengidentifikasi unik, dan bendera penjualan untuk setiap produk. Kontainer menggunakan pengidentifikasi unik* sebagai kunci baris dan kategori sebagai kunci partisi.

Mengautentikasi klien

Sampel ini membuat instans baru dari kelas TableServiceAsyncClient.

DefaultAzureCredential azureTokenCredential = new DefaultAzureCredentialBuilder()
    .build();

TableServiceAsyncClient client = new TableServiceClientBuilder()
    .endpoint("<azure-cosmos-db-table-account-endpoint>")
    .credential(credential)
    .buildAsyncClient();

Mendapatkan meja

Sampel ini membuat instans kelas TableAsyncClient menggunakan metode GetTableClient dari kelas TableServiceClient.

TableAsyncClient table = client
    .getTableClient("<azure-cosmos-db-table-name>");

Membuat entitas

Cara term mudah untuk membuat entitas baru dalam tabel adalah dengan menggunakan createEntity.

String rowKey = "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb";
String partitionKey = "gear-surf-surfboards";

TableEntity entity = new TableEntity(partitionKey, rowKey)
        .addProperty("Name", "Yamba Surfboard")
        .addProperty("Quantity", 12)
        .addProperty("Price", 850.00)
        .addProperty("Sale", false);

Buat entitas dalam koleksi menggunakan upsertEntity.

Mono<Void> response = table.upsertEntity(entity);

Memperoleh objek

Anda dapat mengambil entitas tertentu dari tabel menggunakan getEntity.

String rowKey = "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb";
String partitionKey = "gear-surf-surfboards";

TableEntity entity = table.getEntity(partitionKey, rowKey);

Mengkueri entitas

Setelah menyisipkan entitas, Anda juga dapat menjalankan kueri untuk mendapatkan semua entitas yang cocok dengan filter tertentu dengan menggunakan listEntities dan ListEntitiesOptions kelas . Gunakan metode setFilter untuk menentukan filter string OData.

ListEntitiesOptions options = new ListEntitiesOptions()
    .setFilter("PartitionKey eq 'gear-surf-surfboards'");

PagedFlux<TableEntity> tableEntities = table.listEntities(options, null, null);

Uraikan hasil kueri yang dipaginasi dengan menggunakan langganan.

tableEntities
    .DoOnNext(entity -> {
        // Do something
    });

Membersihkan sumber daya

Saat Anda tidak lagi memerlukan aplikasi sampel atau sumber daya, hapus deployment beserta seluruh sumber daya terkait.

azd down

Konten terkait

  • Last updated on