Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Menyiapkan DynamoDB Selain layanan web Amazon DynamoDB AWS , menyediakan versi DynamoDB yang dapat diunduh yang dapat Anda jalankan di komputer Anda. Versi yang dapat diunduh berguna untuk mengembangkan dan menguji kode Anda. Ini memungkinkan Anda menulis dan menguji aplikasi secara lokal tanpa mengakses layanan web DynamoDB. Topik di bagian ini menjelaskan cara menyiapkan DynamoDB (versi yang dapat diunduh) dan layanan web DynamoDB. **Topics** + [Menyiapkan DynamoDB (layanan web)](SettingUp.DynamoWebService.md) + [Menyiapkan DynamoDB lokal (versi yang dapat diunduh)](DynamoDBLocal.md) # Menyiapkan DynamoDB (layanan web) Untuk menggunakan layanan web Amazon DynamoDB: 1. [Daftar AWS. ](#SettingUp.DynamoWebService.SignUpForAWS). 1. [Dapatkan kunci AWS akses](#SettingUp.DynamoWebService.GetCredentials) (digunakan untuk mengakses DynamoDB secara terprogram). **catatan** Jika Anda berencana untuk berinteraksi dengan DynamoDB hanya melalui Konsol Manajemen AWS, Anda tidak memerlukan AWS kunci akses, dan Anda dapat melompat ke depan. [Menggunakan konsol](AccessingDynamoDB.md#ConsoleDynamoDB) 1. [Konfigurasikan kredensial Anda](#SettingUp.DynamoWebService.ConfigureCredentials) (digunakan untuk mengakses DynamoDB secara terprogram). ## Mendaftar untuk AWS Untuk menggunakan layanan DynamoDB, Anda harus memiliki akun. AWS Jika belum memiliki akun, Anda diminta membuatnya saat mendaftar. Anda tidak dikenakan biaya untuk AWS layanan apa pun yang Anda daftarkan kecuali Anda menggunakannya. **Untuk mendaftar AWS** 1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](https://portal.aws.amazon.com/billing/signup) 1. Ikuti petunjuk online. Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon. Saat Anda mendaftar untuk sebuah Akun AWS, sebuah *Pengguna root akun AWS*dibuat. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik keamanan terbaik, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan [tugas yang memerlukan akses pengguna root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). ## Memberikan akses terprogram Sebelum Anda dapat mengakses DynamoDB secara terprogram atau melalui AWS CLI(), Anda harus memiliki akses AWS Command Line Interface terprogram. Anda tidak memerlukan akses terprogram jika Anda berencana menggunakan hanya konsol DynamoDB. Pengguna membutuhkan akses terprogram jika mereka ingin berinteraksi dengan AWS luar. Konsol Manajemen AWS Cara untuk memberikan akses terprogram tergantung pada jenis pengguna yang mengakses AWS. Untuk memberi pengguna akses programatis, pilih salah satu opsi berikut. **** | Pengguna mana yang membutuhkan akses programatis? | Untuk | Oleh | | --- | --- | --- | | IAM | (Disarankan) Gunakan kredenal konsol sebagai kredensil sementara untuk menandatangani permintaan terprogram ke,, atau. AWS CLI AWS SDKs AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html) | | Identitas tenaga kerja (Pengguna yang dikelola di Pusat Identitas IAM) | Gunakan kredensi sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html) | | IAM | Gunakan kredensi sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk dalam [Menggunakan kredensil sementara dengan AWS sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) di Panduan Pengguna IAM. | | IAM | (Tidak direkomendasikan)Gunakan kredensi jangka panjang untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html) | ## Mengonfigurasi kredensial Anda Sebelum Anda dapat mengakses DynamoDB secara terprogram atau melalui AWS CLI, Anda harus mengonfigurasi kredensialnya untuk mengaktifkan otorisasi untuk aplikasi Anda. Ada beberapa cara untuk melakukan ini. Misalnya, Anda dapat secara manual membuat file kredensial untuk menyimpan ID kunci akses dan kunci akses rahasia Anda. Anda juga dapat menggunakan AWS CLI perintah `aws configure` untuk membuat file secara otomatis. Alternatifnya, Anda dapat menggunakan variabel lingkungan. Untuk informasi selengkapnya tentang mengonfigurasi kredensional Anda, lihat panduan pengembang SDK khusus pemrograman AWS . Untuk menginstal dan mengkonfigurasi AWS CLI, lihat[Menggunakan AWS CLI](AccessingDynamoDB.md#Tools.CLI). ## Integrasi dengan layanan DynamoDB lainnya Anda dapat mengintegrasikan DynamoDB dengan banyak layanan lainnya. AWS Untuk informasi selengkapnya, lihat berikut ini: + [Menggunakan DynamoDB dengan layanan lain AWS](OtherServices.md) + [CloudFormation untuk DynamoDB](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html) + [Menggunakan AWS Backup dengan DynamoDB](backuprestore_HowItWorksAWS.md) + [AWS Identity and Access Management (IAM) dan DynamoDB](identity-and-access-mgmt.md) + [Menggunakan AWS Lambda dengan Amazon DynamoDB](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html) # Menyiapkan DynamoDB lokal (versi yang dapat diunduh) Dengan versi Amazon DynamoDB yang dapat diunduh, Anda dapat mengembangkan dan menguji aplikasi tanpa mengakses layanan web DynamoDB. Sebaliknya, basis data bersifat mandiri di komputer Anda. Saat Anda siap untuk menyebarkan aplikasi Anda dalam produksi, Anda menghapus titik akhir lokal dalam kode, dan kemudian menunjuk ke layanan web DynamoDB. Memiliki versi lokal ini membantu Anda menghemat throughput, penyimpanan data, dan biaya transfer data. Selain itu, Anda tidak memerlukan koneksi internet saat mengembangkan aplikasi. DynamoDB lokal tersedia sebagai [unduhan](DynamoDBLocal.DownloadingAndRunning.md#DynamoDBLocal.DownloadingAndRunning.title) (memerlukan JRE), sebagai [ dependensi Apache Maven](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html#apache-maven), atau sebagai [citra Docker](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html#docker). Jika Anda lebih memilih menggunakan layanan web Amazon DynamoDB, lihat [Menyiapkan DynamoDB (layanan web)](SettingUp.DynamoWebService.md). **Topics** + [Men-deploy DynamoDB secara lokal pada komputer Anda](DynamoDBLocal.DownloadingAndRunning.md) + [Catatan penggunaan DynamoDB lokal](DynamoDBLocal.UsageNotes.md) + [Riwayat rilis DynamoDB lokal](DynamoDBLocalHistory.md) + [Telemetri di DynamoDB lokal](DynamoDBLocalTelemetry.md) # Men-deploy DynamoDB secara lokal pada komputer Anda **catatan** DynamoDB lokal tersedia dalam tiga versi: v3.x (Current), v2.x (Legacy), dan v1.x (Deprecated). DynamoDB v3.x direkomendasikan untuk pengujian dan penggunaan pengembangan lokal Anda. Migrasi dari DynamoDB v2.x lokal ke v3.x memerlukan pembaruan pernyataan impor `com.amazonaws.services.dynamodbv2` dari ke dan memperbarui dependensi Maven `software.amazon.dynamodb` untuk pengguna Maven. [Jika Anda memigrasikan aplikasi yang menggunakan SDK for Java v1.x ke SDK for Java 2.x, ikuti langkah-langkah untuk SDK for Java 2.x.AWS](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/migration.html) ## Unduh DynamoDB lokal Ikuti langkah berikut untuk menyiapkan dan menjalankan DynamoDB pada komputer Anda. **Untuk menyiapkan DynamoDB pada komputer Anda** 1. Unduh DynamoDB lokal secara gratis dari salah satu lokasi berikut. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocal.DownloadingAndRunning.html) **penting** Untuk menjalankan DynamoDB v2.6.0 atau lebih tinggi di komputer Anda, Anda harus memiliki Java Runtime Environment (JRE) versi 17.x atau yang lebih baru. Aplikasi tidak berjalan pada versi JRE sebelumnya. 1. Setelah Anda mengunduh arsip, ekstrak isinya dan salin direktori yang diekstrak ke lokasi pilihan Anda. 1. Untuk memulai DynamoDB di komputer Anda, buka jendela prompt perintah, navigasikan ke direktori tempat Anda mengekstrak `DynamoDBLocal.jar`, dan ketik perintah berikut. ``` java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb ``` **catatan** Jika Anda menggunakan Windows PowerShell, pastikan untuk melampirkan nama parameter atau seluruh nama dan nilai seperti ini: ` java -D"java.library.path=./DynamoDBLocal_lib" -jar DynamoDBLocal.jar ` DynamoDB memproses permintaan masuk hingga Anda menghentikannya. Untuk menghentikan DynamoDB, tekan Ctrl\$1C pada prompt perintah. DynamoDB menggunakan port 8000 secara default. Jika port 8000 tidak tersedia, perintah ini memunculkan pengecualian. Untuk daftar lengkap opsi runtime DynamoDB, termasuk `-port`, masukkan perintah ini. ` java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help ` 1. Sebelum Anda dapat mengakses DynamoDB secara terprogram atau melalui AWS Command Line Interface (AWS CLI), Anda harus mengonfigurasi kredensial Anda untuk mengaktifkan otorisasi bagi aplikasi Anda. DynamoDB yang dapat diunduh memerlukan kredensial untuk bisa berfungsi, seperti yang ditunjukkan dalam contoh berikut. ``` AWS Access Key ID: "fakeMyKeyId" AWS Secret Access Key: "fakeSecretAccessKey" Default Region Name: "fakeRegion" ``` Anda dapat menggunakan perintah `aws configure` dari AWS CLI untuk menyiapkan kredensial. Untuk informasi selengkapnya, lihat [Menggunakan AWS CLI](AccessingDynamoDB.md#Tools.CLI). 1. Mulai menulis aplikasi. Untuk mengakses DynamoDB berjalan secara lokal dengan, gunakan parameter AWS CLI. `--endpoint-url ` Misalnya, gunakan perintah berikut untuk membuat daftar tabel DynamoDB. ``` aws dynamodb list-tables --endpoint-url http://localhost:8000 ``` ## Jalankan DynamoDB lokal sebagai image Docker Versi Amazon DynamoDB yang dapat diunduh tersedia sebagai citra Docker. Untuk informasi selengkapnya, lihat [dynamodb-local](https://hub.docker.com/r/amazon/dynamodb-local). Untuk melihat versi lokal DynamoDB Anda saat ini, masukkan perintah berikut: ``` java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -version ``` Untuk contoh penggunaan DynamoDB lokal sebagai bagian dari aplikasi REST yang dibangun di atas AWS Serverless Application Model AWS SAM(), lihat aplikasi [SAM DynamoDB](https://github.com/aws-samples/aws-sam-java-rest) untuk mengelola pesanan. Contoh aplikasi ini menunjukkan cara menggunakan DynamoDB lokal untuk pengujian. Jika Anda ingin menjalankan aplikasi multi-kontainer yang juga menggunakan kontainer lokal DynamoDB, gunakan Docker Compose untuk menentukan dan menjalankan semua layanan di aplikasi Anda, termasuk DynamoDB lokal. **Untuk menginstal dan menjalankan DynamoDB lokal dengan penulisan Docker:** 1. Unduh dan instal [desktop Docker](https://www.docker.com/products/docker-desktop). 1. Salin kode berikut ke file dan simpan sebagai `docker-compose.yml`. ``` services: dynamodb-local: command: "-jar DynamoDBLocal.jar -sharedDb -dbPath ./data" image: "amazon/dynamodb-local:latest" container_name: dynamodb-local ports: - "8000:8000" volumes: - "./docker/dynamodb:/home/dynamodblocal/data" working_dir: /home/dynamodblocal ``` Jika Anda ingin aplikasi Anda dan DynamoDB lokal berada dalam kontainer terpisah, gunakan file yaml berikut. ``` version: '3.8' services: dynamodb-local: command: "-jar DynamoDBLocal.jar -sharedDb -dbPath ./data" image: "amazon/dynamodb-local:latest" container_name: dynamodb-local ports: - "8000:8000" volumes: - "./docker/dynamodb:/home/dynamodblocal/data" working_dir: /home/dynamodblocal app-node: depends_on: - dynamodb-local image: amazon/aws-cli container_name: app-node ports: - "8080:8080" environment: AWS_ACCESS_KEY_ID: 'DUMMYIDEXAMPLE' AWS_SECRET_ACCESS_KEY: 'DUMMYEXAMPLEKEY' command: dynamodb describe-limits --endpoint-url http://dynamodb-local:8000 --region us-west-2 ``` Skrip docker-compose.yml ini membuat kontainer `app-node` dan kontainer `dynamodb-local`. Skrip menjalankan perintah di kontainer `app-node` yang menggunakan AWS CLI untuk terhubung ke kontainer `dynamodb-local` dan menjelaskan batas akun dan tabel. Untuk digunakan dengan gambar aplikasi Anda sendiri, ganti nilai `image` pada contoh di bawah dengan nilai gambar aplikasi Anda. ``` version: '3.8' services: dynamodb-local: command: "-jar DynamoDBLocal.jar -sharedDb -dbPath ./data" image: "amazon/dynamodb-local:latest" container_name: dynamodb-local ports: - "8000:8000" volumes: - "./docker/dynamodb:/home/dynamodblocal/data" working_dir: /home/dynamodblocal app-node: image: location-of-your-dynamodb-demo-app:latest container_name: app-node ports: - "8080:8080" depends_on: - "dynamodb-local" links: - "dynamodb-local" environment: AWS_ACCESS_KEY_ID: 'DUMMYIDEXAMPLE' AWS_SECRET_ACCESS_KEY: 'DUMMYEXAMPLEKEY' REGION: 'eu-west-1' ``` **catatan** Skrip YAMB mengharuskan Anda menentukan kunci AWS akses dan kunci AWS rahasia, tetapi skrip tersebut tidak diharuskan menjadi kunci yang valid AWS bagi Anda untuk mengakses DynamoDB lokal. 1. Jalankan perintah baris perintah berikut: ``` docker-compose up ``` ## Jalankan DynamoDB lokal sebagai dependensi Apache Maven **catatan** [Jika Anda memigrasikan aplikasi yang menggunakan SDK for Java v1.x ke SDK for Java 2.x, ikuti langkah-langkah untuk SDK for Java 2.x.AWS](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/migration.html) Ikuti langkah-langkah berikut untuk menggunakan Amazon DynamoDB dalam aplikasi Anda sebagai dependensi. **Untuk men-deploy DynamoDB sebagai repositori Apache Maven** 1. Unduh dan instal Apache Maven. Untuk informasi selengkapnya, lihat [Mengunduh Apache Maven](https://maven.apache.org/download.cgi) dan [Menginstal Apache Maven](https://maven.apache.org/install.html). 1. Tambahkan repositori DynamoDB Maven ke file Project Object Model (POM) aplikasi Anda. ``` software.amazon.dynamodb DynamoDBLocal 3.3.0 ``` Contoh template untuk digunakan dengan Spring Boot 3 and/or Spring Framework 6: ``` 4.0.0 org.example SpringMavenDynamoDB 1.0-SNAPSHOT 3.0.1 17 17 UTF-8 org.springframework.boot spring-boot-starter-parent 3.1.0 software.amazon.dynamodb DynamoDBLocal 3.3.0 org.springframework.boot spring-boot-starter ${spring-boot.version} org.springframework.boot spring-boot-starter-web ${spring-boot.version} org.springframework.boot spring-boot-starter-data-jpa ${spring-boot.version} org.springframework spring-context 6.0.0 org.springframework spring-core 6.0.0 ``` **catatan** Anda juga dapat menggunakan URL [repositori pusat Maven](https://mvnrepository.com/artifact/com.amazonaws/DynamoDBLocal?repo=dynamodb-local-release). ## Jalankan DynamoDB lokal di AWS CloudShell AWS CloudShell adalah shell pra-otentikasi berbasis browser yang dapat Anda luncurkan langsung dari file. Konsol Manajemen AWS Anda dapat menavigasi ke AWS CloudShell dari Konsol Manajemen AWS beberapa cara yang berbeda. Untuk informasi selengkapnya, lihat [Memulai dengan AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/getting-started.html). Ikuti langkah-langkah ini untuk menjalankan DynamoDB lokal di mana saja di AWS CloudShell . Konsol Manajemen AWS **Untuk menjalankan DynamoDB lokal di Anda di AWS CloudShell Konsol Manajemen AWS** 1. Luncurkan AWS CloudShell dari antarmuka konsol, pilih yang tersedia Wilayah AWS, dan alihkan ke shell pilihan Anda, seperti Bash, PowerShell, atau Z shell. 1. Untuk memilih Wilayah AWS, buka menu **Pilih Wilayah** dan pilih yang [didukung Wilayah AWS](https://docs.aws.amazon.com/cloudshell/latest/userguide/supported-aws-regions.html). (Wilayah yang Tersedia disorot.) 1. Dari Konsol Manajemen AWS, luncurkan AWS CloudShell dengan memilih salah satu opsi berikut: 1. Pada bilah navigasi, pilih **AWS CloudShell**ikon. 1. Di kotak **Cari**, masukkan kata CloudShell, lalu pilih **CloudShell**. 1. Di widget yang **baru dikunjungi**, pilih **CloudShell**. 1. Dari toolbar konsol, pilih **CloudShell**. 1. Untuk menjalankan DynamoDB lokal AWS CloudShell di Anda dapat menggunakan alias. `dynamodb-local` Anda dapat menentukan opsi baris perintah tambahan untuk mengubah pengaturan lokal DynamoDB. Lihat [Catatan penggunaan DynamoDB lokal](DynamoDBLocal.UsageNotes.md) opsi yang tersedia. **catatan** Untuk menjalankan DynamoDB lokal di latar belakang, jalankan DynamoDB lokal menggunakan:. AWS CloudShell `dynamodb-local &` 1. Untuk mengakses DynamoDB berjalan secara lokal dengan, AWS CloudShell gunakan parameter AWS CLI. `--endpoint-url` Misalnya, gunakan perintah berikut untuk daftar tabel DynamoDB: `aws dynamodb list-tables --endpoint-url http://localhost:8000` [Untuk contoh proyek sampel yang menampilkan beberapa pendekatan untuk menyiapkan dan menggunakan DynamoDB lokal, termasuk mengunduh file JAR, menjalankannya sebagai image Docker, dan menggunakannya sebagai dependensi Maven, lihat DynamoDB Local Sample Java Project.](https://github.com/awslabs/amazon-dynamodb-local-samples/tree/main) # Catatan penggunaan DynamoDB lokal Kecuali titik akhir, aplikasi yang berjalan dengan versi Amazon DynamoDB yang dapat diunduh juga harus bekerja dengan layanan web DynamoDB. Namun, saat menggunakan DynamoDB secara lokal, Anda harus mengetahui hal berikut: + *Jika Anda menggunakan `-sharedDb` opsi, DynamoDB membuat file database tunggal bernama .db. shared-local-instance* Setiap program yang terhubung ke DynamoDB mengakses file ini. Jika Anda menghapus file, Anda kehilangan semua data yang Anda simpan di dalamnya. + Jika Anda menghilangkan`-sharedDb`, file database bernama *myaccesskeyid\$1region.db*, dengan ID kunci AWS akses dan AWS Region seperti yang muncul dalam konfigurasi aplikasi Anda. Jika Anda menghapus file, Anda kehilangan semua data yang Anda simpan di dalamnya. + Jika Anda menggunakan opsi `-inMemory`, DynamoDB tidak menulis file basis data apa pun sama sekali. Sebaliknya, semua data ditulis ke memori, dan data tidak disimpan saat Anda menghentikan DynamoDB. + Jika Anda menggunakan opsi `-inMemory`, opsi `-sharedDb` juga diperlukan. + Jika Anda menggunakan opsi `-optimizeDbBeforeStartup`, Anda juga harus menentukan parameter `-dbPath` agar DynamoDB dapat menemukan file basis datanya. + AWS SDKs Untuk DynamoDB mengharuskan konfigurasi aplikasi Anda menentukan nilai kunci akses dan AWS nilai Region. Kecuali Anda menggunakan opsi `-sharedDb` atau `-inMemory`, DynamoDB menggunakan nilai-nilai ini untuk memberi nama file basis data lokal. Nilai-nilai ini tidak harus berupa AWS nilai yang valid untuk dijalankan secara lokal. Namun, Anda mungkin merasa nyaman menggunakan nilai yang valid sehingga Anda dapat menjalankan kode di cloud di lain waktu dengan mengubah titik akhir yang Anda gunakan. + DynamoDB lokal selalu mengembalikan null untuk `billingModeSummary.` + DynamoDB lokal `AWS_ACCESS_KEY_ID` hanya dapat berisi huruf (A–Z, a–z) dan angka (0–9). + DynamoDB lokal tidak [Point-in-time mendukung pemulihan](Point-in-time-recovery.md) (PITR). **Topics** + [Opsi baris perintah](#DynamoDBLocal.CommandLineOptions) + [Mengatur Titik Akhir Lokal](#DynamoDBLocal.Endpoint) + [Perbedaan antara DynamoDB yang dapat diunduh dan layanan web DynamoDB](#DynamoDBLocal.Differences) ## Opsi baris perintah Anda dapat menggunakan opsi baris perintah berikut dengan versi DynamoDB yang dapat diunduh: + `-cors``value`— Memungkinkan dukungan untuk berbagi sumber daya lintas asal (CORS) untuk. JavaScript Anda harus memberikan daftar domain tertentu yang "diizinkan" yang dipisahkan koma. Pengaturan default untuk `-cors` adalah tanda bintang (\$1), yang memungkinkan akses publik. + `-dbPath` `value` — Direktori tempat DynamoDB menulis file basis datanya. Jika Anda tidak menentukan opsi ini, file akan ditulis ke direktori saat ini. Anda tidak dapat menentukan `-dbPath` dan `-inMemory` sekaligus. + `-delayTransientStatuses` — Menyebabkan DynamoDB menimbulkan penundaan untuk operasi tertentu. DynamoDB (versi download) dapat melakukan beberapa tugas hampir seketika, seperti operasi pada tabel dan indeks. create/update/delete Namun, layanan DynamoDB memerlukan lebih banyak waktu untuk tugas ini. Menyetel parameter ini membantu DynamoDB yang berjalan di komputer Anda menyimulasikan perilaku layanan web DynamoDB dengan lebih dekat. (Saat ini, parameter ini menyebabkan penundaan hanya untuk indeks sekunder global yang berstatus *CREATING* atau *DELETING*.) + `-help` — Mencetak ringkasan dan opsi penggunaan. + `-inMemory` — DynamoDB berjalan di memori alih-alih menggunakan file basis data. Saat Anda menghentikan DynamoDB, tidak ada data yang disimpan. Anda tidak dapat menentukan `-dbPath` dan `-inMemory` sekaligus. + `-optimizeDbBeforeStartup` — Mengoptimalkan tabel basis data yang mendasarinya sebelum memulai DynamoDB di komputer Anda. Anda juga harus menentukan `-dbPath` saat menggunakan parameter ini. + `-port` `value` — Nomor port yang digunakan DynamoDB untuk berkomunikasi dengan aplikasi Anda. Jika Anda tidak menentukan opsi ini, port defaultnya adalah `8000`. **catatan** DynamoDB menggunakan port 8000 secara default. Jika port 8000 tidak tersedia, perintah ini memunculkan pengecualian. Anda dapat menggunakan opsi `-port` untuk menentukan nomor port yang berbeda. Untuk daftar lengkap opsi runtime DynamoDB, termasuk `-port`, masukkan perintah ini: `java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help` + `-sharedDb` — Jika Anda menentukan `-sharedDb`, DynamoDB menggunakan file basis data tunggal, bukan file terpisah untuk setiap kredensial dan Wilayah. + `-disableTelemetry` — Ketika ditentukan, DynamoDB lokal tidak akan mengirim telemetri apa pun. + `-version`— Mencetak versi DynamoDB lokal. ## Mengatur Titik Akhir Lokal Secara default, AWS SDKs dan alat menggunakan titik akhir untuk layanan web Amazon DynamoDB. Untuk menggunakan SDKs dan alat dengan versi DynamoDB yang dapat diunduh, Anda harus menentukan titik akhir lokal: `http://localhost:8000` ### AWS Command Line Interface Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk berinteraksi dengan DynamoDB yang dapat diunduh. Untuk mengakses DynamoDB yang berjalan secara lokal, gunakan parameter `--endpoint-url`. Berikut ini adalah contoh menggunakan daftar tabel di AWS CLI DynamoDB di komputer Anda. ``` aws dynamodb list-tables --endpoint-url http://localhost:8000 ``` **catatan** Tidak AWS CLI dapat menggunakan versi DynamoDB yang dapat diunduh sebagai titik akhir default. Karena itu, Anda harus menentukan `--endpoint-url` dengan setiap AWS CLI perintah. ### AWS SDKs Cara Anda menentukan titik akhir bergantung pada bahasa pemrograman dan AWS SDK yang Anda gunakan. Bagian berikut menjelaskan cara melakukannya: + [Java: Mengatur AWS Wilayah dan titik akhir](CodeSamples.Java.md#CodeSamples.Java.RegionAndEndpoint)(DynamoDB lokal mendukung SDK AWS for Java V1 dan V2) + CodeSamples.Jawa. RegionAndEndpoint [.NET: Mengatur AWS Wilayah dan titik akhir](CodeSamples.DotNet.md#CodeSamples.DotNet.RegionAndEndpoint) ## Perbedaan antara DynamoDB yang dapat diunduh dan layanan web DynamoDB Versi DynamoDB yang dapat diunduh ditujukan hanya untuk pengembangan dan pengujian. Sebagai perbandingan, layanan web DynamoDB adalah layanan terkelola dengan skalabilitas, ketersediaan, dan fitur daya tahan yang membuatnya sangat cocok untuk penggunaan produksi. Versi DynamoDB yang dapat diunduh berbeda dengan layanan web dengan cara berikut: + Wilayah AWS dan Akun AWS berbeda tidak didukung di tingkat klien. + Pengaturan throughput yang disediakan diabaikan dalam DynamoDB yang dapat diunduh, meskipun operasi `CreateTable` memerlukannya. Untuk `CreateTable`, Anda dapat menentukan nomor yang Anda inginkan untuk throughput baca dan tulis yang disediakan, meskipun angka-angka ini tidak digunakan. Anda dapat memanggil `UpdateTable` sebanyak yang Anda inginkan per hari. Namun, perubahan nilai throughput yang disediakan akan diabaikan. + Operasi `Scan` dilakukan secara berurutan. Pemindaian paralel tidak didukung. Parameter `Segment` dan `TotalSegments` dari operasi `Scan` akan diabaikan. + Kecepatan operasi baca dan tulis pada data tabel hanya dibatasi oleh kecepatan komputer Anda. Operasi `CreateTable`, `UpdateTable`, dan `DeleteTable` terjadi segera, dan status tabel selalu ACTIVE. Operasi `UpdateTable` yang hanya mengubah pengaturan throughput yang disediakan pada tabel atau indeks sekunder global terjadi segera. Jika operasi `UpdateTable` membuat atau menghapus setiap indeks sekunder global, indeks tersebut melakukan transisi melalui status normal (seperti CREATING dan DELETING) sebelum status indeks menjadi ACTIVE. Tabel tetap ACTIVE selama waktu ini. + Operasi baca bersifat konsisten pada akhirnya. Namun, karena kecepatan DynamoDB lokal berjalan di komputer Anda, sebagian besar pembacaan tampaknya sangat konsisten. + Metrik koleksi item dan ukuran koleksi item tidak dilacak. Dalam respons operasi, null akan dikembalikan, bukan metrik koleksi item. + Dalam DynamoDB, terdapat batas data sebesar 1 MB yang dikembalikan per set hasil. Layanan web DynamoDB dan versi yang dapat diunduh menerapkan batas ini. Namun, ketika mengkueri indeks, layanan DynamoDB menghitung hanya ukuran kunci dan atribut terproyeksi. Sebaliknya, versi DynamoDB yang dapat diunduh menghitung ukuran keseluruhan item. + Jika Anda menggunakan DynamoDB Streams, laju serpihan yang dibuat mungkin berbeda. Dalam layanan web DynamoDB, perilaku pembuatan serpihan sebagian dipengaruhi oleh aktivitas partisi tabel. Ketika Anda menjalankan DynamoDB secara lokal, tidak ada pembuatan partisi tabel. Dalam kedua kasus, serpihan bersifat fana, sehingga aplikasi Anda tidak harus bergantung pada perilaku serpihan. + `TransactionConflictExceptions`tidak dilemparkan oleh DynamoDB yang dapat diunduh untuk transaksional. APIs Sebaiknya Anda menggunakan kerangka kerja mocking Java untuk menyimulasikan `TransactionConflictExceptions` di handler DynamoDB untuk menguji cara aplikasi Anda merespons transaksi yang bertentangan. + Di layanan web DynamoDB, apakah diakses melalui konsol atau, nama tabel peka huruf AWS CLI besar/kecil. Tabel bernama `Authors` dan yang bernama `authors` bisa ada sebagai tabel terpisah. Dalam versi yang dapat diunduh, nama tabel tidak peka huruf besar-kecil, dan upaya membuat kedua tabel ini akan menghasilkan kesalahan. + Penandaan tidak didukung dalam versi DynamoDB yang dapat diunduh. + [Versi DynamoDB yang dapat diunduh mengabaikan parameter Limit di. [ExecuteStatement](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ExecuteStatement.html)](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ExecuteStatement.html#DDB-ExecuteStatement-request-Limit) # Riwayat rilis DynamoDB lokal Tabel berikut menjelaskan perubahan penting dalam setiap rilis *DynamoDB lokal*. **** | Versi | Ubah | Deskripsi | Date | | --- | --- | --- | --- | | 3.3.0 | Menambahkan dukungan kunci multi-atribut untuk Indeks Sekunder Global | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | Januari 19, 2026 | | 3.2.0 | Memperbaiki Masalah Kompatibilitas dengan beberapa Versi Kotlin | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | Januari 09, 2026 | | 3.1.0 | Meningkatkan kinerja untuk Kueri PartiQL, Termasuk ketergantungan Joda-time | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | September 14, 2025 | | 3.0.0 | Migrasi dari AWS SDK Java V1 ke V2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | Juli 17, 2025 | | 2.6.0 | Support tabel ARN sebagai nama tabel di DynamoDB APIs Perbaikan kinerja dan pembaruan keamanan | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | Maret 13, 2025 | | 2.5.4 | Upgrade ke Dependensi Jetty | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | Desember 12, 2024 | | 2.5.3 | Memutakhirkan Dependensi Jackson ke 2.17.x di Log4j Core (Menyelesaikan CVE-2022-1471) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 6 November 2024 | | 2.5.2 | Perbaikan bug untuk alur kerja tabel Perbarui | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | Juni 20, 2024 | | 2.5.1 | Patch untuk bug yang diperkenalkan dalam OndemandThroughPut fitur | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | Juni 5, 2024 | | 2.5.0 | Support untuk throughput maksimum yang dapat dikonfigurasi untuk tabel sesuai permintaan,,, dan `ReturnValuesOnConditionCheckFailure` `BatchExecuteStatement` `ExecuteTransactionRequest` | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 28 Mei 2024 | | 2.4.0 | Dukungan untuk `ReturnValuesOnConditionCheckFailure` - Mode Tertanam | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | April 17, 2024 | | 2.3.0 | Peningkatan Dermaga dan JDK | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | Maret 14, 2024 | | 2.2.0 | Ditambahkan dukungan untuk perlindungan penghapusan tabel dan parameter `ReturnValuesOnConditionCheckFailure` | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 14 Desember 2023 | | 2.1.0 | Support untuk SQLLite Native Libraries untuk proyek Maven dan menambahkan telemetri | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 23 Oktober 2023 | | 2.0.0 | Migrasi dari javax ke jakarta namespace dan Support JDK11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 5 Juli 2023 | | 1.25.1 | Memutakhirkan Dependensi Jackson ke 2.17.x di Log4j Core (Menyelesaikan CVE-2022-1471) | Memutakhirkan Dependensi Jackson ke 2.17.x di Log4j Core (Menyelesaikan CVE-2022-1471) untuk mengatasi kerentanan keamanan kritis di perpustakaan SnakeYaml, yang merupakan ketergantungan transitif | 6 November 2024 | | 1.25.0 | Ditambahkan dukungan untuk perlindungan penghapusan tabel dan parameter `ReturnValuesOnConditionCheckFailure` | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 18 Desember 2023 | | 1.24.0 | Support untuk SQLLite Native Libraries untuk proyek Maven dan menambahkan telemetri | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 23 Oktober 2023 | | 1.23.0 | Penanganan akses tidak valid dan kunci rahasia saat server dinyalakan | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 28 Juni 2023 | | 1.22.0 | Dukungan Operasi Batas untuk PartiQL | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 8 Juni 2023 | | 1.21.0 | Dukungan untuk 100 tindakan per transaksi | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 26 Januari 2023 | | 1.20.0 | Menambahkan dukungan untuk M1 Mac | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 12 September 2022 | | 1.19.0 | Peningkatan Parser PartiQL | Meningkatkan Parser PartiQL dan pustaka terkait lainnya | 27 Juli 2022 | | 1.18.0 | Peningkatan log4j-core dan Jackson-core | Meningkatkan log4j-core ke 2.17.1 dan Jackson-core 2.10.x ke 2.12.0 | 10 Januari 2022 | | 1.17.2 | Peningkatan log4j-core | Meningkatkan dependensi log4j-core ke versi 2.16 | 16 Januari 2021 | | 1.17.1 | Peningkatan log4j-core | Pembaruan dependensi log4j-core untuk mem-patch eksploitasi zero-day guna mencegah eksekusi kode jarak jauh - Log4Shel | 10 Januari 2021 | | 1.17.0 | Menghentikan penggunaan Javascript Web Shell | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/DynamoDBLocalHistory.html) | 8 Januari 2021 | # Telemetri di DynamoDB lokal Di AWS, kami mengembangkan dan meluncurkan layanan berdasarkan apa yang kami pelajari dari interaksi dengan pelanggan, dan kami menggunakan umpan balik pelanggan untuk mengulangi produk kami. Telemetri adalah informasi tambahan yang membantu kami lebih memahami kebutuhan pelanggan, mendiagnosis masalah, dan menghadirkan fitur yang meningkatkan pengalaman pelanggan. DynamoDB lokal mengumpulkan telemetri, seperti metrik penggunaan umum, informasi sistem dan lingkungan, serta kesalahan. Untuk detail tentang jenis telemetri yang dikumpulkan, lihat [Jenis informasi yang dikumpulkan](#DynamoDBLocalTelemetry.TypesOfInformationCollected). DynamoDB lokal tidak mengumpulkan informasi pribadi, seperti nama pengguna atau alamat email. DynamoDB lokal juga tidak mengekstraksi informasi tingkat proyek yang sensitif. Sebagai pelanggan, Anda mengontrol apakah telemetri diaktifkan, dan Anda dapat mengubah pengaturan kapan saja. Jika telemetri tetap aktif, DynamoDB lokal mengirimkan data telemetri di latar belakang tanpa memerlukan interaksi pelanggan tambahan. ## Menonaktifkan telemetri menggunakan opsi baris perintah Anda dapat menonaktifkan telemetri menggunakan opsi baris perintah saat memulai DynamoDB lokal menggunakan opsi `-disableTelemetry`. Untuk informasi selengkapnya, lihat [Opsi baris perintah](DynamoDBLocal.UsageNotes.md#DynamoDBLocal.CommandLineOptions). ## Menonaktifkan telemetri untuk satu sesi Di sistem operasi macOS dan Linux, Anda dapat menonaktifkan telemetri untuk satu sesi. Untuk menonaktifkan telemetri untuk sesi Anda saat ini, jalankan perintah berikut untuk mengatur variabel lingkungan `DDB_LOCAL_TELEMETRY` ke `false`. Ulangi perintah tersebut untuk setiap sesi atau terminal baru. ``` export DDB_LOCAL_TELEMETRY=0 ``` ## Menonaktifkan telemetri untuk profil Anda di semua sesi Jalankan perintah berikut guna menonaktifkan telemetri untuk semua sesi saat Anda menjalankan DynamoDB lokal di sistem operasi Anda. **Untuk menonaktifkan telemetri di Linux** 1. Jalankan: ``` echo "export DDB_LOCAL_TELEMETRY=0" >>~/.profile ``` 1. Jalankan: ``` source ~/.profile ``` **Untuk menonaktifkan telemetri di macOS** 1. Jalankan: ``` echo "export DDB_LOCAL_TELEMETRY=0" >>~/.profile ``` 1. Jalankan: ``` source ~/.profile ``` **Untuk menonaktifkan telemetri di Windows** 1. Jalankan: ``` setx DDB_LOCAL_TELEMETRY 0 ``` 1. Jalankan: ``` refreshenv ``` ## Matikan telemetri menggunakan DynamoDB lokal yang disematkan pada proyek Maven Anda dapat mematikan telemetri menggunakan DynamoDB lokal tertanam pada proyek Maven. ``` boolean disableTelemetry = true; // AWS SDK v1 AmazonDynamoDB amazonDynamoDB = DynamoDBEmbedded.create(disableTelemetry).amazonDynamoDB(); // AWS SDK v2 DynamoDbClient ddbClientSDKv2Local = DynamoDBEmbedded.create(disableTelemetry).dynamoDbClient(); ``` ## Jenis informasi yang dikumpulkan + **Informasi penggunaan** — Telemetri generik seperti server start/stop dan API atau Operasi yang disebut. + **Informasi sistem dan lingkungan** — Versi Java, sistem operasi (Windows, Linux, atau macOS), lingkungan tempat DynamoDB lokal dijalankan (misalnya, Stand alone JAR, Kontainer Docker, atau sebagai Dependensi Maven), dan nilai hash atribut penggunaan. ## Pelajari selengkapnya Data telemetri yang dikumpulkan DynamoDB lokal mematuhi kebijakan privasi data. AWS Untuk informasi selengkapnya, lihat berikut ini: + [AWS ketentuan layanan](https://aws.amazon.com/service-terms/) + [FAQ privasi data](https://aws.amazon.com/compliance/data-privacy-faq/)