建立資料表列出資料表說明資料表 (取得相關資訊)修改 (更新) 資料表刪除資料表詳細資訊

處理資料表DynamoDB

資料表是 DynamoDB 資料庫中所有項目的容器。您必須先建立資料表，然後才可以從 DynamoDB 新增或移除資料。

對於每個資料表，您必須定義：

對於您的帳戶和區域都具有獨一性的資料表名稱。
每個值的主索引鍵都必須獨一無二，資料表中任兩個項目不能有相同的主索引鍵值。

主索引鍵可以是簡單的，包含單一分割區 (HASH) 索引鍵；也可以是複合的，包含分割區和排序 (RANGE) 索引鍵。

每個鍵值都有一個關聯的數據類型，由ScalarAttributeType類枚舉。索引鍵值可以是二進位 (B)、數值 (N)、或字串 (S)。如需詳細資訊，請參閱Amazon DynamoDB開發人員指南中的命名規則和資料類型。
佈建的輸送量值，用於定義表格的保留讀取/寫入容量單位數目。

注意
Amazon DynamoDB定價是根據您在表格上設定的佈建輸送量值，因此請只保留您認為表格需要的容量。

您可以隨時修改表格的佈建輸送量，因此您可以在需求變更時調整容量。

建立資料表

使用用DynamoDB戶端的createTable方法建立新DynamoDB資料表。您需要建構資料表屬性和資料表結構描述，這兩項都會用來識別資料表的主索引鍵。您也必須提供初始佈建的輸送量值和資料表名稱。僅在建立資料表時定義關鍵資DynamoDB料表屬性。

注意

如果具有您選擇的名稱的資料表已存在，AmazonServiceException就會擲回一個。

匯入


import com.amazonaws.AmazonServiceException;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.services.dynamodbv2.model.AttributeDefinition;
import com.amazonaws.services.dynamodbv2.model.CreateTableRequest;
import com.amazonaws.services.dynamodbv2.model.CreateTableResult;
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;

使用簡單主索引鍵建立資料表

此程式碼會使用簡單主索引鍵 ("Name") 來建立資料表。

Code


CreateTableRequest request = new CreateTableRequest()
    .withAttributeDefinitions(new AttributeDefinition(
             "Name", ScalarAttributeType.S))
    .withKeySchema(new KeySchemaElement("Name", KeyType.HASH))
    .withProvisionedThroughput(new ProvisionedThroughput(
             new Long(10), new Long(10)))
    .withTableName(table_name);

final AmazonDynamoDB ddb = AmazonDynamoDBClientBuilder.defaultClient();

try {
    CreateTableResult result = ddb.createTable(request);
    System.out.println(result.getTableDescription().getTableName());
} catch (AmazonServiceException e) {
    System.err.println(e.getErrorMessage());
    System.exit(1);
}

請參閱（詳見）的完整實例GitHub。

使用複合主索引鍵建立資料表

將另一個AttributeDefinition和新增KeySchemaElement至CreateTableRequest。

Code


CreateTableRequest request = new CreateTableRequest()
    .withAttributeDefinitions(
          new AttributeDefinition("Language", ScalarAttributeType.S),
          new AttributeDefinition("Greeting", ScalarAttributeType.S))
    .withKeySchema(
          new KeySchemaElement("Language", KeyType.HASH),
          new KeySchemaElement("Greeting", KeyType.RANGE))
    .withProvisionedThroughput(
          new ProvisionedThroughput(new Long(10), new Long(10)))
    .withTableName(table_name);

請參閱（詳見）的完整實例GitHub。

列出資料表

您可以通過調DynamoDB用客戶端的listTables方法列出特定區域中的表。

注意

如果您的帳戶和區域不存在具名資料表，ResourceNotFoundException就會擲回 a。

匯入


import com.amazonaws.AmazonServiceException;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.services.dynamodbv2.model.ListTablesRequest;
import com.amazonaws.services.dynamodbv2.model.ListTablesResult;

Code


final AmazonDynamoDB ddb = AmazonDynamoDBClientBuilder.defaultClient();

ListTablesRequest request;

boolean more_tables = true;
String last_name = null;

while(more_tables) {
    try {
        if (last_name == null) {
        	request = new ListTablesRequest().withLimit(10);
        }
        else {
        	request = new ListTablesRequest()
        			.withLimit(10)
        			.withExclusiveStartTableName(last_name);
        }

        ListTablesResult table_list = ddb.listTables(request);
        List<String> table_names = table_list.getTableNames();

        if (table_names.size() > 0) {
            for (String cur_name : table_names) {
                System.out.format("* %s\n", cur_name);
            }
        } else {
            System.out.println("No tables found!");
            System.exit(0);
        }

        last_name = table_list.getLastEvaluatedTableName();
        if (last_name == null) {
            more_tables = false;
        }

根據預設，每次呼叫最多會傳回 100 個表格 — 用getLastEvaluatedTableName於傳回的ListTablesResult物件來取得最後一個評估的資料表。您可以使用這個值，在前次列表最後傳回值之後開始列表。

請參閱（詳見）的完整實例GitHub。

說明資料表 (取得相關資訊)

調DynamoDB用客戶端的describeTable方法。

注意

如果您的帳戶和區域不存在具名資料表，ResourceNotFoundException就會擲回 a。

匯入


import com.amazonaws.AmazonServiceException;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.services.dynamodbv2.model.AttributeDefinition;
import com.amazonaws.services.dynamodbv2.model.ProvisionedThroughputDescription;
import com.amazonaws.services.dynamodbv2.model.TableDescription;

Code


final AmazonDynamoDB ddb = AmazonDynamoDBClientBuilder.defaultClient();

try {
    TableDescription table_info =
       ddb.describeTable(table_name).getTable();

    if (table_info != null) {
        System.out.format("Table name  : %s\n",
              table_info.getTableName());
        System.out.format("Table ARN   : %s\n",
              table_info.getTableArn());
        System.out.format("Status      : %s\n",
              table_info.getTableStatus());
        System.out.format("Item count  : %d\n",
              table_info.getItemCount().longValue());
        System.out.format("Size (bytes): %d\n",
              table_info.getTableSizeBytes().longValue());

        ProvisionedThroughputDescription throughput_info =
           table_info.getProvisionedThroughput();
        System.out.println("Throughput");
        System.out.format("  Read Capacity : %d\n",
              throughput_info.getReadCapacityUnits().longValue());
        System.out.format("  Write Capacity: %d\n",
              throughput_info.getWriteCapacityUnits().longValue());

        List<AttributeDefinition> attributes =
           table_info.getAttributeDefinitions();
        System.out.println("Attributes");
        for (AttributeDefinition a : attributes) {
            System.out.format("  %s (%s)\n",
                  a.getAttributeName(), a.getAttributeType());
        }
    }
} catch (AmazonServiceException e) {
    System.err.println(e.getErrorMessage());
    System.exit(1);
}

請參閱（詳見）的完整實例GitHub。

修改 (更新) 資料表

您可以透過呼叫DynamoDB用戶端的updateTable方法，隨時修改表格的佈建輸送量值。

注意

如果您的帳戶和區域不存在具名資料表，ResourceNotFoundException就會擲回 a。

匯入


import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.services.dynamodbv2.model.ProvisionedThroughput;
import com.amazonaws.AmazonServiceException;

Code


ProvisionedThroughput table_throughput = new ProvisionedThroughput(
      read_capacity, write_capacity);

final AmazonDynamoDB ddb = AmazonDynamoDBClientBuilder.defaultClient();

try {
    ddb.updateTable(table_name, table_throughput);
} catch (AmazonServiceException e) {
    System.err.println(e.getErrorMessage());
    System.exit(1);
}

請參閱（詳見）的完整實例GitHub。

刪除資料表

調用DynamoDB客戶端的deleteTable方法並將其傳遞給表的名稱。

注意

如果您的帳戶和區域不存在具名資料表，ResourceNotFoundException就會擲回 a。

匯入


import com.amazonaws.AmazonServiceException;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;
import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;

Code


final AmazonDynamoDB ddb = AmazonDynamoDBClientBuilder.defaultClient();

try {
    ddb.deleteTable(table_name);
} catch (AmazonServiceException e) {
    System.err.println(e.getErrorMessage());
    System.exit(1);
}

請參閱（詳見）的完整實例GitHub。

詳細資訊

Amazon DynamoDB開發人員指南中使用表格的準則
使用Amazon DynamoDB開發人員指南DynamoDB中的表格

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Amazon DynamoDB 範例

在中處理項目DynamoDB