All Products
Search
Document Center

:Menghubungkan ke instans yang kompatibel dengan DynamoDB menggunakan kode

Last Updated:Jun 22, 2026

Topik ini menjelaskan cara menghubungkan ke instans yang kompatibel dengan DynamoDB menggunakan AWS CLI, Python, dan Java.

Prasyarat

Diperlukan instans yang kompatibel dengan DynamoDB. Saat membuat instans tersebut, pilih DynamoDB sebagai Jenis Protokol. Untuk informasi selengkapnya, lihat Buat instans kluster sharded.

Titik akhir koneksi

Dapatkan titik akhir koneksi untuk instans Anda yang kompatibel dengan DynamoDB.

  1. Masuk ke Konsol ApsaraDB for MongoDB.

  2. Di pojok kiri atas halaman, pilih kelompok sumber daya dan wilayah instans tersebut.

  3. Di panel navigasi sebelah kiri, klik List of Shard cluster instances.

  4. Temukan instans target lalu klik ID-nya.

  5. Di panel navigasi sebelah kiri, klik Database Connection.

  6. Di bagian VPC Connection, lihat titik akhir koneksi instans tersebut. Jenis Protokol untuk titik akhir ini adalah protokol kompatibel DynamoDB, dan alamatnya diawali dengan dds-.

Jika aplikasi Anda dideploy pada Instance ECS, instans ApsaraDB for MongoDB dan Instance ECS tersebut harus memenuhi kondisi berikut agar konektivitas jaringan terjamin.

  • Keduanya harus berada di wilayah yang sama. Jika Anda memiliki Instance ECS yang sudah ada, Anda dapat memeriksa wilayahnya. Untuk informasi selengkapnya, lihat Lihat wilayah Instance ECS.

  • Opsi: Untuk latensi jaringan yang lebih rendah, kami menyarankan menempatkannya di zona yang sama. Jika Anda memiliki Instance ECS yang sudah ada, Anda dapat memeriksa zonanya. Untuk informasi selengkapnya, lihat Lihat zona Instance ECS.

  • Keduanya harus menggunakan jenis jaringan yang sama. Jika Anda memiliki Instance ECS yang sudah ada, Anda dapat memeriksa jenis jaringannya. Untuk informasi selengkapnya, lihat Lihat jenis jaringan Instance ECS. Jika Instance ECS menggunakan Classic network, Anda dapat memigrasikannya dari Classic network ke VPC. Untuk informasi selengkapnya, lihat Migrasi Instance ECS dari jaringan klasik ke VPC.

Menghubungkan menggunakan AWS CLI

Bagian ini menunjukkan cara menggunakan AWS Command Line Interface (AWS CLI) pada sistem Ubuntu 16.04.6 LTS untuk menghubungkan ke instans yang kompatibel dengan DynamoDB. Untuk informasi selengkapnya tentang AWS CLI, lihat Apa itu AWS Command Line Interface?.

  1. Instal klien AWS CLI.

    1. Jalankan perintah berikut untuk mengunduh versi terbaru AWS CLI dan menyimpannya sebagai awscliv2.zip:

      curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
    2. Jalankan perintah berikut untuk mengekstrak file awscliv2.zip:

      unzip awscliv2.zip
      Catatan

      Jika Anda belum menginstal unzip, jalankan perintah sudo apt install unzip untuk menginstalnya.

    3. Jalankan perintah berikut untuk menginstal AWS CLI:

      sudo ./aws/install

    Saat muncul pesan You can now run: /usr/local/bin/aws --version, artinya AWS CLI telah terinstal. Anda kemudian dapat menjalankan perintah /usr/local/bin/aws --version untuk memeriksa versi AWS CLI saat ini.

  2. Jalankan perintah /usr/local/bin/aws configure untuk mengonfigurasi AWS CLI. Masukkan nilai-nilai berikut, lalu tekan Enter setelah masing-masing.

    Parameter

    Deskripsi

    Contoh

    AWS Access Key ID

    Masukkan ID kunci akses. Layanan yang kompatibel dengan DynamoDB tidak memvalidasi kunci ini, sehingga Anda dapat memasukkan string karakter apa pun.

    XXXXXXXXXX

    AWS Secret Access Key

    Masukkan kunci akses rahasia. Layanan yang kompatibel dengan DynamoDB tidak memvalidasi kunci ini, sehingga Anda dapat memasukkan string karakter apa pun.

    XXXXXXXXXX

    Default region name

    Masukkan nama wilayah AWS default.

    us-west-2

    Default output format

    Format output default. Anda dapat mengosongkan parameter ini.

    json

    Catatan

    Untuk informasi selengkapnya tentang cara mengonfigurasi AWS CLI, lihat Dasar-dasar konfigurasi.

  3. Jalankan perintah berikut untuk menghubungkan ke instans target yang kompatibel dengan DynamoDB dan membuat tabel.

    aws dynamodb --endpoint-url <connection-endpoint-of-your-DynamoDB-compatible-instance> \ 
        create-table --table-name <your-table-name> \
        --attribute-definitions AttributeName=<attribute-name>,AttributeType=<attribute-data-type> \
        --key-schema AttributeName=<primary-key-attribute-name>,KeyType=<key-role> \
        --provisioned-throughput ReadCapacityUnits=<provisioned-read-throughput>,WriteCapacityUnits=<provisioned-write-throughput>

    Parameter

    Deskripsi

    --endpoint-url

    Titik akhir instans target yang kompatibel dengan DynamoDB. Titik akhir harus diawali dengan http://.

    create-table

    Perintah untuk membuat tabel.

    Catatan

    Untuk informasi selengkapnya, lihat create-table.

    --table-name

    Nama tabel yang akan dibuat.

    --attribute-definitions

    Array atribut yang menjelaskan skema kunci untuk tabel atau indeks. Parameter ini memerlukan sub-parameter berikut:

    • AttributeName: Nama atribut.

    • AttributeType: Tipe data atribut.

      Catatan

      Untuk informasi selengkapnya, lihat create-table.

    --key-schema

    Atribut-atribut yang membentuk kunci primer untuk tabel atau indeks. Parameter ini memerlukan sub-parameter berikut:

    • AttributeName: Nama atribut kunci. Atribut ini didefinisikan menggunakan parameter --attribute-definitions.

    • KeyType: Peran kunci. Nilai yang valid: HASH dan RANGE. HASH menentukan kunci partisi dan RANGE menentukan kunci pengurutan.

      Catatan

      Untuk informasi selengkapnya, lihat create-table.

    --provisioned-throughput

    Pengaturan throughput yang disediakan untuk tabel atau indeks. Parameter ini memerlukan sub-parameter berikut:

    • ReadCapacityUnits: Throughput baca yang disediakan.

    • WriteCapacityUnits: Throughput tulis yang disediakan.

    Catatan

    Untuk informasi selengkapnya, lihat create-table.

    Contoh:

    /usr/local/bin/aws dynamodb --endpoint-url http://dds-xxxx.mongodb.rds.aliyuncs.com:3717 \ # Menghubungkan ke titik akhir instans yang kompatibel dengan DynamoDB yang ditentukan.
        create-table --table-name student \ # Membuat tabel bernama student.
        --attribute-definitions AttributeName=name,AttributeType=S AttributeName=age,AttributeType=N \ # Skema tabel mencakup atribut 'name' bertipe String (S) dan atribut 'age' bertipe Number (N).
        --key-schema AttributeName=name,KeyType=HASH AttributeName=age,KeyType=RANGE \ # Menentukan 'name' sebagai kunci partisi dan 'age' sebagai kunci pengurutan.
        --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 # Menetapkan throughput baca dan tulis yang disediakan menjadi 5.

    Jika output berikut dikembalikan, artinya Anda telah berhasil menghubungkan ke instans target yang kompatibel dengan DynamoDB dan membuat tabel.

    {
        "TableDescription": {
            "TableName": "student",
            "KeySchema": [
                {
                    "AttributeName": "name",
                    "KeyType": "HASH"
                },
                {
                    "AttributeName": "age",
                    "KeyType": "RANGE"
                }
            ],
            "TableStatus": "CREATING",
            "TableSizeBytes": 0,
            "ItemCount": 0
        }
    }
                            

Menghubungkan menggunakan Python

  • Python 2.6 atau versi yang lebih baru telah diinstal. Untuk informasi selengkapnya, lihat situs web resmi Python.

  • Boto3 telah diinstal. Untuk informasi selengkapnya, lihat Menginstal Boto3.

Kode berikut menunjukkan cara menghubungkan ke instans yang kompatibel dengan DynamoDB menggunakan Python dan membuat tabel bernama Book:

import boto3

def create_book_table(dynamodb=None):
 if not dynamodb:
 # Ganti endpoint_url dengan titik akhir aktual instans Anda yang kompatibel dengan DynamoDB.
 dynamodb = boto3.resource('dynamodb', endpoint_url="http://dds-xxxx.mongodb.rds.aliyuncs.com:3717")
 table = dynamodb.create_table(
 TableName='Book',
 KeySchema=[
 {
 'AttributeName':'title',
 'KeyType':'HASH'
 },
 {
 'AttributeName':'year',
 'KeyType':'RANGE'
 }
 ],
 AttributeDefinitions=[
 {
 'AttributeName':'title',
 'AttributeType':'S'
 },
 {
 'AttributeName':'year',
 'AttributeType':'N'
 },
 ],
 ProvisionedThroughput={
 'ReadCapacityUnits':5,
 'WriteCapacityUnits':5
 }
 )
 return table

if __name__ == '__main__':
 book_table =create_book_table()
 print("Table status:", book_table.table_status)

Menghubungkan menggunakan Java

Diperlukan AWS SDK untuk Java. Untuk informasi selengkapnya, lihat Menyiapkan AWS SDK untuk Java.

Kode berikut menunjukkan cara menggunakan Java untuk menghubungkan ke instans yang kompatibel dengan DynamoDB dan membuat tabel bernama Book:

package com.amazonaws.codesamples.gsg;

import java.util.Arrays;
import com.amazonaws.client.builder.AwsClientBuilder;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.services.dynamodbv2.document.DynamoDB;
import com.amazonaws.services.dynamodbv2.document.Table;
import com.amazonaws.services.dynamodbv2.model.AttributeDefinition;
import com.amazonaws.services.dynamodbv2.model.KeySchemaElement;
import com.amazonaws.services.dynamodbv2.model.KeyType;
import com.amazonaws.services.dynamodbv2.model.ProvisionedThroughput;
import com.amazonaws.services.dynamodbv2.model.ScalarAttributeType;

public class MoviesCreateTable {
 public static void main(String[] args) throws Exception {
 
        // Ganti titik akhir dan wilayah dengan nilai aktual untuk instans Anda yang kompatibel dengan DynamoDB.
        AmazonDynamoDB client =AmazonDynamoDBClientBuilder.standard()
            .withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("http://dds-xxxx.mongodb.rds.aliyuncs.com:3717",
"us-east-1"))
            .build();

 DynamoDB dynamoDB = new DynamoDB(client);

 String tableName ="Book";

 try {
 System.out.println("Creating table...");
 Table table =dynamoDB.createTable(tableName,
 Arrays.asList(new
KeySchemaElement("title", KeyType.HASH), // kunci partisi
 new KeySchemaElement("year", KeyType.RANGE)), // kunci pengurutan
 Arrays.asList(new AttributeDefinition("title", ScalarAttributeType.S),
 new AttributeDefinition("year", ScalarAttributeType.N)),
 new ProvisionedThroughput(5L, 5L));
 table.waitForActive();
System.out.println("OK. Table status: " + table.getDescription().getTableStatus());
 }
 catch (Exception e) {
System.err.println("Unable to create table: ");
System.err.println(e.getMessage());
 }
 }
}

Contoh koneksi dalam bahasa lain

Untuk contoh lainnya, lihat Memulai DynamoDB dan AWS SDK.