

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

# .NET dan DAX
<a name="DAX.client.run-application-dotnet"></a>

Ikuti langkah-langkah berikut untuk menjalankan sampel .NET pada instans Amazon EC2 Anda.

**catatan**  
Tutorial ini menggunakan .NET 9 SDK. Anda akan diberi tahu cara menjalankan program di Amazon VPC default untuk mengakses klaster Amazon DynamoDB Accelerator (DAX) Anda. Ia bekerja dengan [AWS SDK v4 untuk.NET](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html). Untuk detail tentang perubahan di V4 dan informasi tentang migrasi, lihat Migrasi ke [SDK for AWS .NET ke versi 4](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html). Jika Anda mau, Anda dapat menggunakan AWS Toolkit for Visual Studio untuk menulis aplikasi.NET dan menyebarkannya ke VPC Anda.  
Untuk informasi selengkapnya, lihat [Membuat dan Melakukan Deployment Aplikasi Elastic Beanstalk di .NET Menggunakan AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/create_deploy_NET.html) di *Panduan Developer AWS Elastic Beanstalk *.

**Cara menjalankan sampel .NET untuk DAX**

1. Buka [halaman Unduhan Microsoft](https://www.microsoft.com/net/download?initial-os=linux) dan unduh SDK .NET 9 terbaru untuk Linux. File yang diunduh adalah `dotnet-sdk-N.N.N-linux-x64.tar.gz`.

1. Ekstrak file SDK.

   ```
   mkdir dotnet
   tar zxvf dotnet-sdk-N.N.N-linux-x64.tar.gz -C dotnet
   ```

   Ganti `N.N.N` dengan nomor versi .NET SDK sebenarnya (misalnya:`9.0.305`).

1. Verifikasi instalasi.

   ```
   alias dotnet=$HOME/dotnet/dotnet
   dotnet --version
   ```

   Tindakan ini akan mencetak nomor versi .NET SDK.
**catatan**  
Sebagai ganti nomor versi, Anda mungkin menerima kesalahan berikut:  
kesalahan: libunwind.so.8: tidak dapat membuka file objek yang dibagikan: File atau direktori tersebut tidak ada  
Untuk mengatasi kesalahan ini, instal paket `libunwind`.  

   ```
   sudo yum install -y libunwind
   ```
Setelah melakukan ini, Anda akan dapat menjalankan perintah `dotnet --version` tanpa kesalahan.

1. Buat proyek .NET baru.

   ```
   dotnet new console -o myApp 
   ```

   Ini membutuhkan beberapa menit untuk melakukan one-time-only pengaturan. Setelah selesai, jalankan sampel proyek.

   ```
   dotnet run --project myApp
   ```

   Anda akan menerima pesan berikut: `Hello World!`

1. File `myApp/myApp.csproj` berisi metadata tentang proyek Anda. Untuk menggunakan klien DAX di aplikasi Anda, modifikasi file sehingga terlihat seperti berikut ini.

   ```
   <Project Sdk="Microsoft.NET.Sdk">
       <PropertyGroup>
           <OutputType>Exe</OutputType>
           <TargetFramework>net9.0</TargetFramework>
       </PropertyGroup>
       <ItemGroup>
           <PackageReference Include="AWSSDK.DAX.Client" Version="*" />
       </ItemGroup>
   </Project>
   ```

1. Unduh sampel kode sumber program (file `.zip`).

   ```
   wget http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/samples/TryDax.zip
   ```

   Setelah unduhan selesai, ekstrak file sumber.

   ```
   unzip TryDax.zip
   ```

1. Sekarang jalankan program sampel *DotNet*, satu per satu. Untuk setiap program, salin isinya ke `myApp/Program.cs`, kemudian jalankan proyek `MyApp`.

   Jalankan program .NET berikut. Program pertama membuat tabel DynamoDB bernama `TryDaxTable`. Program kedua menulis data ke tabel.

   ```
   cp TryDax/dotNet/01-CreateTable.cs myApp/Program.cs
   dotnet run --project myApp
   
   cp TryDax/dotNet/02-Write-Data.cs myApp/Program.cs
   dotnet run --project myApp
   ```

1. Berikutnya, jalankan beberapa program untuk melakukan operasi `GetItem`, `Query`, dan `Scan` di klaster DAX Anda. Untuk menentukan titik akhir klaster DAX Anda, pilih salah satu dari berikut ini:
   +  **Menggunakan konsol DynamoDB** — Pilih klaster DAX Anda. Titik akhir klaster ditampilkan pada konsol, seperti dalam contoh berikut.

     ```
     dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
     ```
   + **Menggunakan AWS CLI** — Masukkan perintah berikut.

     ```
     aws dax describe-clusters --query "Clusters[*].ClusterDiscoveryEndpoint"
     ```

     Titik akhir klaster ditampilkan pada output, seperti dalam contoh berikut.

     ```
     {
         "Address": "my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com",
         "Port": 8111,
         "URL": "dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com"
     }
     ```

   Sekarang jalankan program berikut untuk menentukan titik akhir klaster Anda sebagai parameter baris perintah. (Ganti titik akhir sampel dengan titik akhir klaster DAX Anda yang sebenarnya).

   ```
   cp TryDax/dotNet/03-GetItem-Test.cs myApp/Program.cs
   dotnet run --project myApp dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
   
   cp TryDax/dotNet/04-Query-Test.cs myApp/Program.cs
   dotnet run --project myApp dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
                           
   cp TryDax/dotNet/05-Scan-Test.cs myApp/Program.cs
   dotnet run --project myApp dax://my-cluster.l6fzcv.dax-clusters.us-east-1.amazonaws.com
   ```

   Perhatikan informasi waktu, yaitu jumlah milidetik yang diperlukan untuk pengujian `GetItem`, `Query`, dan `Scan`.

1. Jalankan program .NET berikut untuk menghapus `TryDaxTable`.

   ```
   cp TryDax/dotNet/06-DeleteTable.cs myApp/Program.cs
   dotnet run --project myApp
   ```

Untuk informasi selengkapnya tentang program tersebut, lihat bagian berikut:
+ [01- CreateTable .cs](DAX.client.run-application-dotnet.01-CreateTable.md)
+ [02-Write-Data.cs](DAX.client.run-application-dotnet.02-Write-Data.md)
+ [03- GetItem -Test.cs](DAX.client.run-application-dotnet.03-GetItem-Test.md)
+ [04-Query-Test.cs](DAX.client.run-application-dotnet.04-Query-Test.md)
+ [05-Scan-Test.cs](DAX.client.run-application-dotnet.05-Scan-Test.md)
+ [06- DeleteTable .cs](DAX.client.run-application-dotnet.06-DeleteTable.md)