Driver Amazon QLDB for .NET - Amazon Quantum Ledger Database (Amazon QLDB)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Driver Amazon QLDB for .NET

Untuk bekerja dengan data dalam buku besar Anda, Anda dapat terhubung ke Amazon QLDB dari aplikasi Microsoft .NET Anda dengan menggunakan driver yangAWS disediakan. Pengemudi menargetkan .NET Standard 2.0. Lebih khusus lagi, mendukung .NET Core (LTS) 2.1+ dan .NET Framework 4.5.2+. Untuk informasi tentang kompatibilitas, lihat .NET Standard di situs Microsoft Docs.

Kami sangat merekomendasikan penggunaan pemetaan objek Ion untuk sepenuhnya melewati kebutuhan untuk mengonversi secara manual antara jenis Amazon Ion dan tipe C # asli.

Topik berikut menjelaskan cara untuk memulai dengan driver QLDB for .NET.

Sumber daya driver

Untuk informasi selengkapnya tentang fungsi yang didukung oleh driver .NET, lihat sumber daya berikut:

Prasyarat

Sebelum memulai dengan driver QLDB for .NET, Anda harus melakukan hal berikut:

  1. Ikuti petunjukAWS pengaturan diMengakses Amazon QLDB. Ini termasuk hal berikut:

    1. Daftar ke AWS.

    2. Buat pengguna dengan izin QLDB yang sesuai.

    3. Memberikan akses terprogram untuk pengembangan.

  2. Unduh dan instal .NET Core SDK versi 2.1 atau yang lebih baru dari situs unduhan Microsoft .NET.

  3. (Opsional) Instal lingkungan pengembangan terintegrasi (IDE) pilihan Anda, seperti Visual Studio, Visual Studio untuk Mac, atau Visual Studio Code. Anda dapat men-download ini dari situs Microsoft Visual Studio.

  4. Konfigurasikan lingkungan pengembangan Anda untuk AWS SDK for .NET:

    1. SiapkanAWS kredensi Anda. Kami merekomendasikan membuat file kredensi bersama.

      Untuk petunjuknya, lihat MengonfigurasiAWS kredensi menggunakan file kredensil di PanduanAWS SDK for .NET Pengembang.

    2. Tetapkan default AndaWilayah AWS. Untuk mempelajari caranya, lihat Wilayah AWSseleksi.

      Untuk daftar lengkap Wilayah yang tersedia, lihat titik akhir dan kuota Amazon QLDB di bagian Referensi Umum AWS.

Selanjutnya, Anda dapat mengatur aplikasi sampel dasar dan menjalankan contoh kode singkat—atau Anda dapat menginstal driver dalam proyek .NET yang ada.

  • Untuk menginstal driver QLDB danAWS SDK for .NET dalam proyek yang ada, lanjutkan keInstalasi.

  • Untuk menyiapkan proyek dan menjalankan contoh kode pendek yang menunjukkan transaksi data dasar pada buku besar, lihatQuick start tutorial.

Instalasi

Gunakan manajer NuGet paket untuk menginstal driver QLDB untuk .NET. Sebaiknya gunakan Visual Studio atau IDE pilihan Anda untuk menambahkan dependensi proyek. Nama paket driver adalah Amazon.qldb.driver.

Misalnya di Visual Studio, buka NuGet Package Manager Console pada menu Tools. Kemudian, masukkan perintah berikut diPM> perintah.

PM> Install-Package Amazon.QLDB.Driver

Menginstal driver juga menginstal dependensinya, termasuk paketAWS SDK for .NET dan Amazon Ion.

Instal pemetaan objek Ion

Versi 1.3.0 driver QLDB untuk .NET memperkenalkan dukungan untuk menerima dan mengembalikan tipe data C # asli tanpa perlu bekerja dengan Amazon Ion. Untuk menggunakan fitur ini, tambahkan paket berikut ke proyek Anda.

  • Amazon.qldb.driver.serialization - Sebuah perpustakaan yang dapat memetakan nilai Ion ke C # objek CLR lama polos (POCO), dan sebaliknya. Pemeta objek Ion ini memungkinkan aplikasi Anda berinteraksi langsung dengan tipe data C # asli tanpa perlu bekerja dengan Ion. Untuk panduan singkat tentang cara menggunakan pustaka ini, lihat file Serialization.md di GitHub repositoriawslabs/amazon-qldb-driver-dotnet.

Untuk menginstal paket ini, masukkan perintah berikut.

PM> Install-Package Amazon.QLDB.Driver.Serialization

Untuk contoh kode singkat tentang cara menjalankan transaksi data dasar pada buku besar, lihatReferensi Referensi.