@aws-sdk/client-dynamodb
Version:
AWS SDK for JavaScript Dynamodb Client for Node.js, Browser and React Native
118 lines • 4.96 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.CreateGlobalTableCommand = void 0;
const models_0_1 = require("../models/models_0");
const Aws_json1_0_1 = require("../protocols/Aws_json1_0");
const middleware_serde_1 = require("@aws-sdk/middleware-serde");
const smithy_client_1 = require("@aws-sdk/smithy-client");
/**
* <p>Creates a global table from an existing table. A global table creates a replication
* relationship between two or more DynamoDB tables with the same table name in the
* provided Regions. </p>
* <note>
* <p>This operation only applies to <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html">Version 2017.11.29</a> of global tables.</p>
* </note>
*
* <p>If you want to add a new replica table to a global table, each of the following conditions
* must be true:</p>
* <ul>
* <li>
* <p>The table must have the same primary key as all of the other replicas.</p>
* </li>
* <li>
* <p>The table must have the same name as all of the other replicas.</p>
* </li>
* <li>
* <p>The table must have DynamoDB Streams enabled, with the stream containing both the new and the old
* images of the item.</p>
* </li>
* <li>
* <p>None of the replica tables in the global table can contain any data.</p>
* </li>
* </ul>
* <p>
* If global secondary indexes are specified, then the following conditions must also be met:
* </p>
* <ul>
* <li>
* <p>
* The global secondary indexes must have the same name.
* </p>
* </li>
* <li>
* <p>
* The global secondary indexes must have the same hash key and sort key (if present).
* </p>
* </li>
* </ul>
* <p>
* If local secondary indexes are specified, then the following conditions must also be met:
* </p>
* <ul>
* <li>
* <p>
* The local secondary indexes must have the same name.
* </p>
* </li>
* <li>
* <p>
* The local secondary indexes must have the same hash key and sort key (if present).
* </p>
* </li>
* </ul>
*
* <important>
* <p>
* Write capacity settings should be set consistently across your replica tables and
* secondary indexes. DynamoDB strongly recommends enabling auto scaling to manage the write
* capacity settings for all of your global tables replicas and indexes.
* </p>
* <p>
* If you prefer to manage write capacity settings manually, you should provision equal
* replicated write capacity units to your replica tables. You should also provision
* equal replicated write capacity units to matching secondary indexes across
* your global table.
* </p>
* </important>
*/
class CreateGlobalTableCommand extends smithy_client_1.Command {
// Start section: command_properties
// End section: command_properties
constructor(input) {
// Start section: command_constructor
super();
this.input = input;
this.resolved = false;
// End section: command_constructor
}
/**
* @internal
*/
resolveMiddleware(clientStack, configuration, options) {
if (!this.resolved) {
this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
this.resolved = true;
}
const stack = clientStack.concat(this.middlewareStack);
const { logger } = configuration;
const clientName = "DynamoDBClient";
const commandName = "CreateGlobalTableCommand";
const handlerExecutionContext = {
logger,
clientName,
commandName,
inputFilterSensitiveLog: models_0_1.CreateGlobalTableInput.filterSensitiveLog,
outputFilterSensitiveLog: models_0_1.CreateGlobalTableOutput.filterSensitiveLog,
};
const { requestHandler } = configuration;
return stack.resolve((request) => requestHandler.handle(request.request, options || {}), handlerExecutionContext);
}
serialize(input, context) {
return Aws_json1_0_1.serializeAws_json1_0CreateGlobalTableCommand(input, context);
}
deserialize(output, context) {
return Aws_json1_0_1.deserializeAws_json1_0CreateGlobalTableCommand(output, context);
}
}
exports.CreateGlobalTableCommand = CreateGlobalTableCommand;
//# sourceMappingURL=CreateGlobalTableCommand.js.map