Utilisation des élements : .NET

Vous pouvez utiliser l'API de bas niveau AWS SDK for .NET pour effectuer des opérations CRUD (création, lecture, mise à jour et suppression) classiques sur un élément dans une table. Voici les étapes à suivre courantes pour effectuer des opérations CRUD sur des données à l'aide de l'API de bas niveau .NET.

Placement d'un élément

La méthode PutItem charge un élément dans une table. Si l'élément existe, il remplace la totalité de l'élément.

Voici les étapes à suivre pour charger un élément à l'aide de l'API SDK .NET de bas niveau.

L'exemple de code C# suivant illustre les étapes précédentes. L'exemple charge un élément dans la table ProductCatalog.

AmazonDynamoDBClient client = new AmazonDynamoDBClient();
string tableName = "ProductCatalog";

var request = new PutItemRequest
{
   TableName = tableName,
   Item = new Dictionary<string, AttributeValue>()
      {
          { "Id", new AttributeValue { N = "201" }},
          { "Title", new AttributeValue { S = "Book 201 Title" }},
          { "ISBN", new AttributeValue { S = "11-11-11-11" }},
          { "Price", new AttributeValue { S = "20.00" }},
          {
            "Authors",
            new AttributeValue
            { SS = new List<string>{"Author1", "Author2"}   }
          }
      }
};
client.PutItem(request);

Dans l'exemple précédent, vous chargez un élément book (livre) qui possède les attributs Id, Title, ISBN et Authors. Notez que Id est un attribut de type numérique, et que tous les autres attributs sont de type String (chaîne). Authors est un ensemble String.

Spécification de paramètres facultatifs

Vous pouvez également fournir des paramètres facultatifs à l'aide de l'objet PutItemRequest, comme illustré dans l'exemple C# suivant. L'échantillon spécifie les paramètres facultatifs suivants :

var request = new PutItemRequest
 {
   TableName = tableName,
   Item = new Dictionary<string, AttributeValue>()
               {
                   { "Id", new AttributeValue { N = "104" }},
                   { "Title", new AttributeValue { S = "Book 104  Title" }},
                   { "ISBN", new AttributeValue { S = "444-4444444444" }},
                   { "Authors",
                     new AttributeValue { SS = new List<string>{"Author3"}}}
               },
    // Optional parameters.
    ExpressionAttributeNames = new Dictionary<string,string>()
    {
        {"#I", "ISBN"}
    },
    ExpressionAttributeValues = new Dictionary<string, AttributeValue>()
    {
        {":isbn",new AttributeValue {S = "444-4444444444"}}
    },
    ConditionExpression = "#I = :isbn"

};
var response = client.PutItem(request);

Pour plus d'informations, consultez PutItem.

Obtention d'un élément

La méthode GetItem extrait un élément.

Voici les étapes à suivre pour extraire un élément à l'aide de l'API AWS SDK for .NET de bas niveau.

L'exemple de code C# suivant illustre les étapes précédentes. L'exemple extrait un élément de la table ProductCatalog.

AmazonDynamoDBClient client = new AmazonDynamoDBClient();
string tableName = "ProductCatalog";

var request = new GetItemRequest
 {
   TableName = tableName,
   Key = new Dictionary<string,AttributeValue>() { { "Id", new AttributeValue { N = "202" } } },
 };
 var response = client.GetItem(request);

// Check the response.
var result = response.GetItemResult;
var attributeMap = result.Item; // Attribute list in the response.

Spécification de paramètres facultatifs

Vous pouvez également fournir des paramètres facultatifs à l'aide de l'objet GetItemRequest, comme illustré dans l'exemple C# suivant. L'exemple spécifie les paramètres facultatifs suivants :

AmazonDynamoDBClient client = new AmazonDynamoDBClient();
string tableName = "ProductCatalog";

var request = new GetItemRequest
 {
   TableName = tableName,
   Key = new Dictionary<string,AttributeValue>() { { "Id", new AttributeValue { N = "202" } } },
   // Optional parameters.
   ProjectionExpression = "Id, ISBN, Title, Authors",
   ConsistentRead = true
 };

 var response = client.GetItem(request);

// Check the response.
var result = response.GetItemResult;
var attributeMap = result.Item; 

Pour plus d'informations, consultez GetItem.

Mise à jour d'un élément

La méthode UpdateItem met à jour un élément existant s'il est présent. Vous pouvez utiliser l'opération UpdateItem pour mettre à jour des valeurs d'attribut existantes, ajouter des attributs ou supprimer des attributs dans la collection existante. Si l'élément qui possède la clé primaire spécifiée est introuvable, l'opération ajoute un nouvel élément.

L'opération UpdateItem suit les directives suivantes :

Voici les étapes à suivre pour mettre à jour un élément à l'aide de l'API SDK .NET de bas niveau.

L'exemple de code C# suivant présente les étapes précédentes. L'exemple de code met à jour un élément book (livre) dans la table ProductCatalog. Il ajoute un nouvel auteur à la collection Authors et supprime l'attribut ISBN existant. Il permet également de réduire le prix d'un niveau.

AmazonDynamoDBClient client = new AmazonDynamoDBClient();
string tableName = "ProductCatalog";

var request = new UpdateItemRequest
{
    TableName = tableName,
    Key = new Dictionary<string,AttributeValue>() { { "Id", new AttributeValue { N = "202" } } },
    ExpressionAttributeNames = new Dictionary<string,string>()
    {
        {"#A", "Authors"},
        {"#P", "Price"},
        {"#NA", "NewAttribute"},
        {"#I", "ISBN"}
    },
    ExpressionAttributeValues = new Dictionary<string, AttributeValue>()
    {
        {":auth",new AttributeValue { SS = {"Author YY","Author ZZ"}}},
        {":p",new AttributeValue {N = "1"}},
        {":newattr",new AttributeValue {S = "someValue"}},
    },

    // This expression does the following:
    // 1) Adds two new authors to the list
    // 2) Reduces the price
    // 3) Adds a new attribute to the item
    // 4) Removes the ISBN attribute from the item
    UpdateExpression = "ADD #A :auth SET #P = #P - :p, #NA = :newattr REMOVE #I"
};
var response = client.UpdateItem(request);

Spécification de paramètres facultatifs

Vous pouvez également fournir des paramètres facultatifs à l'aide de l'objet UpdateItemRequest, comme illustré dans l'exemple C# suivant. Il spécifie les deux paramètres facultatifs suivants :

AmazonDynamoDBClient client = new AmazonDynamoDBClient();
string tableName = "ProductCatalog";

var request = new UpdateItemRequest
{
    Key = new Dictionary<string,AttributeValue>() { { "Id", new AttributeValue { N = "202" } } },

    // Update price only if the current price is 20.00.
    ExpressionAttributeNames = new Dictionary<string,string>()
    {
        {"#P", "Price"}
    },
    ExpressionAttributeValues = new Dictionary<string, AttributeValue>()
    {
        {":newprice",new AttributeValue {N = "22"}},
        {":currprice",new AttributeValue {N = "20"}}
    },
    UpdateExpression = "SET #P = :newprice",
    ConditionExpression = "#P = :currprice",
    TableName = tableName,
    ReturnValues = "ALL_NEW" // Return all the attributes of the updated item.
};

var response = client.UpdateItem(request);

Pour plus d'informations, consultez UpdateItem.

Compteurs atomiques

Vous pouvez utiliser updateItem pour implémenter un compteur atomique, où vous incrémentez ou décrémentez la valeur d'un attribut existant sans interférer avec d'autres demandes d'écriture. Pour mettre à jour un compteur atomique, utilisez updateItem avec un attribut de type Number dans le paramètre UpdateExpression, et ADD pour Action.

L'extrait de code suivant illustre cette action, en incrémentant l'attribut Quantity d'une unité.

AmazonDynamoDBClient client = new AmazonDynamoDBClient();
string tableName = "ProductCatalog";

var request = new UpdateItemRequest
{
    Key = new Dictionary<string, AttributeValue>() { { "Id", new AttributeValue { N = "121" } } },
    ExpressionAttributeNames = new Dictionary<string, string>()
    {
        {"#Q", "Quantity"}
    },
    ExpressionAttributeValues = new Dictionary<string, AttributeValue>()
    {
        {":incr",new AttributeValue {N = "1"}}
    },
    UpdateExpression = "SET #Q = #Q + :incr",
    TableName = tableName
};

var response = client.UpdateItem(request);

Suppression d'un élément

La méthode DeleteItem supprime un élément d'une table.

Voici les étapes à suivre pour supprimer un élément à l'aide de l'API SDK .NET de bas niveau.

AmazonDynamoDBClient client = new AmazonDynamoDBClient();
string tableName = "ProductCatalog";

var request = new DeleteItemRequest
{
    TableName = tableName,
    Key = new Dictionary<string,AttributeValue>() { { "Id", new AttributeValue { N = "201" } } },
};

var response = client.DeleteItem(request);

Spécification de paramètres facultatifs

Vous pouvez également fournir des paramètres facultatifs à l'aide de l'objet DeleteItemRequest, comme illustré dans l'exemple de code C# suivant. Il spécifie les deux paramètres facultatifs suivants :

var request = new DeleteItemRequest
{
    TableName = tableName,
    Key = new Dictionary<string,AttributeValue>() { { "Id", new AttributeValue { N = "201" } } },

    // Optional parameters.
    ReturnValues = "ALL_OLD",
    ExpressionAttributeNames = new Dictionary<string, string>()
    {
        {"#IP", "InPublication"}
    },
    ExpressionAttributeValues = new Dictionary<string, AttributeValue>()
    {
        {":inpub",new AttributeValue {BOOL = false}}
    },
    ConditionExpression = "#IP = :inpub"
};

var response = client.DeleteItem(request);

Pour plus d'informations, consultez DeleteItem.

Écriture par lots : insertion et suppression de plusieurs éléments

L'écriture par lots fait référence à l'insertion et la suppression de plusieurs éléments dans un lot. La méthode BatchWriteItem vous permet d'insérer et de supprimer plusieurs éléments d'une ou de plusieurs tables en un seul appel. Voici les étapes à suivre pour extraire plusieurs éléments à l'aide de l'API SDK .NET de bas niveau.

L'exemple de code C# suivant présente les étapes précédentes. L'exemple crée une BatchWriteItemRequest pour effectuer les opérations d'écriture suivantes :

Le code exécute BatchWriteItem pour effectuer une opération par lot.

AmazonDynamoDBClient client = new AmazonDynamoDBClient();

string table1Name = "Forum";
string table2Name = "Thread";

var request = new BatchWriteItemRequest
 {
   RequestItems = new Dictionary<string, List<WriteRequest>>
    {
      {
        table1Name, new List<WriteRequest>
        {
          new WriteRequest
          {
             PutRequest = new PutRequest
             {
                Item = new Dictionary<string,AttributeValue>
                {
                  { "Name", new AttributeValue { S = "Amazon S3 forum" } },
                  { "Threads", new AttributeValue { N = "0" }}
                }
             }
          }
        }
      } ,
      {
        table2Name, new List<WriteRequest>
        {
          new WriteRequest
          {
            PutRequest = new PutRequest
            {
               Item = new Dictionary<string,AttributeValue>
               {
                 { "ForumName", new AttributeValue { S = "Amazon S3 forum" } },
                 { "Subject", new AttributeValue { S = "My sample question" } },
                 { "Message", new AttributeValue { S = "Message Text." } },
                 { "KeywordTags", new AttributeValue { SS = new List<string> { "Amazon S3", "Bucket" }  } }
               }
            }
          },
          new WriteRequest
          {
             DeleteRequest = new DeleteRequest
             {
                Key = new Dictionary<string,AttributeValue>()
                {
                   { "ForumName", new AttributeValue { S = "Some forum name" } },
                   { "Subject", new AttributeValue { S = "Some subject" } }
                }
             }
          }
        }
      }
    }
 };
response = client.BatchWriteItem(request);

Pour obtenir un exemple pratique, consultez Exemple : opérations par lot à l'aide de l'API de bas niveau AWS SDK for .NET.

Obtention par lots : obtention de plusieurs éléments

La méthode BatchGetItem vous permet de récupérer plusieurs éléments d'une ou de plusieurs tables.

Voici les étapes à suivre pour extraire plusieurs éléments à l'aide de l'API AWS SDK for .NET de bas niveau.

L'exemple de code C# suivant présente les étapes précédentes. L'exemple extrait les éléments de deux tables, Forum et Thread. La demande spécifie deux éléments dans la table Forum et trois éléments dans la table Thread. La réponse inclut des éléments des deux tables. Le code montre comment vous pouvez traiter la réponse.

AmazonDynamoDBClient client = new AmazonDynamoDBClient();

string table1Name = "Forum";
string table2Name = "Thread";

var request = new BatchGetItemRequest
{
  RequestItems = new Dictionary<string, KeysAndAttributes>()
  {
    { table1Name,
      new KeysAndAttributes
      {
        Keys = new List<Dictionary<string, AttributeValue>>()
        {
          new Dictionary<string, AttributeValue>()
          {
            { "Name", new AttributeValue { S = "DynamoDB" } }
          },
          new Dictionary<string, AttributeValue>()
          {
            { "Name", new AttributeValue { S = "Amazon S3" } }
          }
        }
      }
    },
    {
      table2Name,
      new KeysAndAttributes
      {
        Keys = new List<Dictionary<string, AttributeValue>>()
        {
          new Dictionary<string, AttributeValue>()
          {
            { "ForumName", new AttributeValue { S = "DynamoDB" } },
            { "Subject", new AttributeValue { S = "DynamoDB Thread 1" } }
          },
          new Dictionary<string, AttributeValue>()
          {
            { "ForumName", new AttributeValue { S = "DynamoDB" } },
            { "Subject", new AttributeValue { S = "DynamoDB Thread 2" } }
          },
          new Dictionary<string, AttributeValue>()
          {
            { "ForumName", new AttributeValue { S = "Amazon S3" } },
            { "Subject", new AttributeValue { S = "Amazon S3 Thread 1" } }
          }
        }
      }
    }
  }
};

var response = client.BatchGetItem(request);

// Check the response.
var result = response.BatchGetItemResult;
var responses = result.Responses; // The attribute list in the response.

var table1Results = responses[table1Name];
Console.WriteLine("Items in table {0}" + table1Name);
foreach (var item1 in table1Results.Items)
{
  PrintItem(item1);
}

var table2Results = responses[table2Name];
Console.WriteLine("Items in table {1}" + table2Name);
foreach (var item2 in table2Results.Items)
{
  PrintItem(item2);
}
// Any unprocessed keys? could happen if you exceed ProvisionedThroughput or some other error.
Dictionary<string, KeysAndAttributes> unprocessedKeys = result.UnprocessedKeys;
foreach (KeyValuePair<string, KeysAndAttributes> pair in unprocessedKeys)
{
    Console.WriteLine(pair.Key, pair.Value);
}

Spécification de paramètres facultatifs

Vous pouvez également fournir des paramètres facultatifs à l'aide de l'objet BatchGetItemRequest, comme illustré dans l'exemple de code C# suivant. L'exemple extrait deux éléments de la table Forum. Il spécifie le paramètre facultatif suivant :

AmazonDynamoDBClient client = new AmazonDynamoDBClient();

string table1Name = "Forum";

var request = new BatchGetItemRequest
{
  RequestItems = new Dictionary<string, KeysAndAttributes>()
  {
    { table1Name,
      new KeysAndAttributes
      {
        Keys = new List<Dictionary<string, AttributeValue>>()
        {
          new Dictionary<string, AttributeValue>()
          {
            { "Name", new AttributeValue { S = "DynamoDB" } }
          },
          new Dictionary<string, AttributeValue>()
          {
            { "Name", new AttributeValue { S = "Amazon S3" } }
          }
        }
      },
      // Optional - name of an attribute to retrieve.
      ProjectionExpression = "Title"
    }
  }
};

var response = client.BatchGetItem(request);

Pour plus d'informations, consultez BatchGetItem.