:Se connecter à une instance compatible DynamoDB à l'aide de code

Prérequis

Vous devez disposer d'une instance compatible DynamoDB. Lors de la création de l'instance, sélectionnez DynamoDB comme type de protocole. Pour plus d'informations, consultez Créer une instance de cluster fragmenté.

Endpoint de connexion

Récupérez l'endpoint de connexion de votre instance compatible DynamoDB.

1. Connectez-vous à la console ApsaraDB for MongoDB.

2. Dans le coin supérieur gauche de la page, sélectionnez le groupe de ressources et la région de l'instance.

3. Dans le volet de navigation de gauche, cliquez sur List of Shard cluster instances.

4. Localisez l'instance cible et cliquez sur son ID.

5. Dans le volet de navigation de gauche, cliquez sur Database Connection.

6. Dans la section VPC Connection, affichez l'endpoint de connexion de l'instance. Le Type de protocole pour cet endpoint est Protocole compatible DynamoDB, et l'adresse commence par dds-.

Se connecter à l'aide d'AWS CLI

Cette section explique comment utiliser l'interface de ligne de commande AWS (AWS CLI) sur un système Ubuntu 16.04.6 LTS pour se connecter à une instance compatible DynamoDB. Pour plus d'informations sur AWS CLI, consultez Qu'est-ce qu'AWS Command Line Interface ?.

1. Installez le client AWS CLI.

   1. Exécutez la commande suivante pour télécharger la dernière version d'AWS CLI et l'enregistrer sous le nom awscliv2.zip :

      curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

   2. Exécutez la commande suivante pour décompresser le fichier awscliv2.zip :

      unzip awscliv2.zip

      Remarque

      Si unzip n'est pas installé, exécutez la commande sudo apt install unzip pour l'installer.

   3. Exécutez la commande suivante pour installer AWS CLI :

      sudo ./aws/install

   Lorsque le message You can now run: /usr/local/bin/aws --version s'affiche, l'installation d'AWS CLI est terminée. Exécutez alors la commande /usr/local/bin/aws --version pour vérifier la version actuelle d'AWS CLI.

2. Exécutez la commande /usr/local/bin/aws configure pour configurer AWS CLI. Saisissez les valeurs suivantes en appuyant sur Entrée après chacune d'elles.

   Paramètre	Description	Exemple
   AWS Access Key ID	Saisissez un ID de clé d'accès. Le service compatible DynamoDB ne valide pas cette clé ; vous pouvez donc saisir n'importe quelle chaîne de caractères.	XXXXXXXXXX
   AWS Secret Access Key	Saisissez une clé d'accès secrète. Le service compatible DynamoDB ne valide pas cette clé ; vous pouvez donc saisir n'importe quelle chaîne de caractères.	XXXXXXXXXX
   Default region name	Saisissez le nom d'une région AWS par défaut.	us-west-2
   Default output format	Format de sortie par défaut. Vous pouvez laisser ce paramètre vide.	json

   Remarque

   Pour plus d'informations sur la configuration d'AWS CLI, consultez Configuration de base.

3. Exécutez la commande suivante pour vous connecter à l'instance compatible DynamoDB cible et créer une table.

   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>

   Paramètre	Description
   --endpoint-url	Endpoint de l'instance compatible DynamoDB cible. L'endpoint doit commencer par http://.
   create-table	Commande de création d'une table. Remarque Pour plus d'informations, consultez create-table.
   --table-name	Nom de la table à créer.
   --attribute-definitions	Tableau d'attributs décrivant le schéma de clé de la table ou de l'index. Ce paramètre nécessite les sous-paramètres suivants : AttributeName : nom de l'attribut. AttributeType : type de données de l'attribut. Remarque Pour plus d'informations, consultez create-table.
   --key-schema	Attributs constituant la clé primaire d'une table ou d'un index. Ce paramètre nécessite les sous-paramètres suivants : AttributeName : nom d'un attribut de clé. L'attribut est défini à l'aide du paramètre --attribute-definitions. KeyType : rôle de la clé. Valeurs valides : HASH et RANGE. HASH spécifie la clé de partition et RANGE spécifie la clé de tri. Remarque Pour plus d'informations, consultez create-table.
   --provisioned-throughput	Paramètres de débit provisionné pour la table ou l'index. Ce paramètre nécessite les sous-paramètres suivants : ReadCapacityUnits : débit de lecture provisionné. WriteCapacityUnits : débit d'écriture provisionné. Remarque Pour plus d'informations, consultez create-table.

   Exemple :

   /usr/local/bin/aws dynamodb --endpoint-url http://dds-xxxx.mongodb.rds.aliyuncs.com:3717 \ # Connect to the specified endpoint of the DynamoDB-compatible instance.
       create-table --table-name student \ # Create a table named student.
       --attribute-definitions AttributeName=name,AttributeType=S AttributeName=age,AttributeType=N \ # The table schema includes a 'name' attribute of type String (S) and an 'age' attribute of type Number (N).
       --key-schema AttributeName=name,KeyType=HASH AttributeName=age,KeyType=RANGE \ # Specify 'name' as the partition key and 'age' as the sort key.
       --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 # Set the provisioned read throughput and provisioned write throughput to 5.

   Si la sortie suivante s'affiche, la connexion à l'instance compatible DynamoDB cible est établie et la table est créée.

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

Se connecter à l'aide de Python

• Python 2.6 ou une version ultérieure est installé. Pour plus d'informations, consultez le site Web officiel de Python.

• Boto3 est installé. Pour plus d'informations, consultez Installation de Boto3.

import boto3

def create_book_table(dynamodb=None):
 if not dynamodb:
 # Replace the endpoint_url with the actual endpoint of your DynamoDB-compatible instance.
 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)

Se connecter à l'aide de Java

AWS SDK for Java est requis. Pour plus d'informations, consultez Configurer AWS SDK for Java.

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 {
 
        // Replace the endpoint and region with the actual values for your DynamoDB-compatible instance.
        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), // partition key
 new KeySchemaElement("year", KeyType.RANGE)), // sort key
 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());
 }
 }
}

Exemples de connexion dans d'autres langages

Pour plus d'exemples, consultez Prise en main de DynamoDB et des kits SDK AWS.