# CreateTable **Importante** ***Esta seção refere-se à versão de API 2011-12-05, que está obsoleta e não deve ser usada para novos aplicativos.*** **Para obter a documentação da API de baixo nível atual, consulte a [Referência da API do Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).** ## Descrição A operação `CreateTable` adiciona uma nova tabela à sua conta. O nome da tabela deve ser exclusivo entre aqueles associados à conta da AWS que emite a solicitação e à região da AWS que recebe a solicitação (como dynamodb.us-west-2.amazonaws.com). Cada endpoint do DynamoDB é totalmente independente. Por exemplo, se você tiver duas tabelas chamadas “MyTable”, uma em dynamodb.us-west-2.amazonaws.com e outra em dynamodb.us-west-1.amazonaws.com, elas serão completamente independentes e não compartilharão nenhum dado. A operação `CreateTable` desencadeia um fluxo de trabalho assíncrono para começar a criação da tabela. O DynamoDB retorna imediatamente o estado da tabela (`CREATING`) até que ela atinja o estado `ACTIVE`. Quando a tabela estiver no estado `ACTIVE`, você poderá realizar as operações de plano de dados. Use a operação [DescribeTables](API_DescribeTables_v20111205.md) para verificar o status da tabela. ## Solicitações ### Sintaxe ``` // This header is abbreviated. // For a sample of a complete header, see API de baixo nível do DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.CreateTable content-type: application/x-amz-json-1.0 {"TableName":"Table1", "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10} } ``` **** | Nome | Descrição | Obrigatório | | --- | --- | --- | | TableName | O nome da tabela a ser criada.Os caracteres permitidos são a-z, A-Z, 0-9, '\$1' (sublinhado), '-' (traço) e '.' (ponto). Os nomes podem ter de 3 a 255 caracteres. Tipo: string | Sim | | KeySchema | A estrutura da chave primária (simples ou composta) da tabela. O par de nome-valor de `HashKeyElement` é obrigatório, e um par de nome-valor de `RangeKeyElement` é opcional (obrigatório apenas para chaves primárias compostas). Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Nomes de elementos de chave primária podem ter entre 1 e 255 caracteres de comprimento, sem restrições de caracteres. Os valores possíveis para AttributeType são "S" (string), "N" (numérico) ou "B" (binário).Tipo: mapa de `HashKeyElement`, ou `HashKeyElement` e `RangeKeyElement` para uma chave primária composta. | Sim | | ProvisionedThroughput | Novo throughput da tabela especificada consistindo em valores para ReadCapacityUnits e WriteCapacityUnits. Para obter detalhes, consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Para conhecer os valores máximos/mínimos atuais, consulte [Cotas no Amazon DynamoDB](ServiceQuotas.md). Tipo: matriz | Sim | | ProvisionedThroughput: ReadCapacityUnits | Define o número mínimo de `ReadCapacityUnits` consistentes consumidas por segundo para a tabela especificada antes que o DynamoDB balanceie a carga com outras operações. As operações de leitura eventualmente consistente requerem menos esforço que uma operação de leitura consistente, portanto, uma definição de 50 `ReadCapacityUnits` consistentes por segundo oferece 100 `ReadCapacityUnits` eventualmente consistentes por segundo. Tipo: número | Sim | | ProvisionedThroughput: WriteCapacityUnits | Define o número mínimo de WriteCapacityUnits consumidas por segundo para a tabela especificada antes que o DynamoDB balanceie a carga com outras operações. Tipo: número | Sim | ## Respostas ### Sintaxe ``` HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.310506263362E9, "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"CREATING" } } ``` **** | Nome | Descrição | | --- | --- | | TableDescription | Um contêiner para as propriedades da tabela. | | CreationDateTime | Data em que a tabela foi criada, no formato de [tempo epoch UNIX](http://www.epochconverter.com/).Tipo: número | | KeySchema | A estrutura da chave primária (simples ou composta) da tabela. O par de nome-valor de `HashKeyElement` é obrigatório, e um par de nome-valor de `RangeKeyElement` é opcional (obrigatório apenas para chaves primárias compostas). Para obter mais informações sobre chaves primárias, consulte [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: mapa de `HashKeyElement`, ou `HashKeyElement` e `RangeKeyElement` para uma chave primária composta. | | ProvisionedThroughput | O throughput da tabela especificada consistindo em valores para `ReadCapacityUnits` e `WriteCapacityUnits`. Consulte [Modo de capacidade provisionada do DynamoDB](provisioned-capacity-mode.md). Tipo: matriz | | ProvisionedThroughput :ReadCapacityUnits | O número mínimo de `ReadCapacityUnits` consumidas por segundo antes que o DynamoDB balanceie a carga com outras operações.Tipo: número | | ProvisionedThroughput :WriteCapacityUnits | O número mínimo de `ReadCapacityUnits` consumidas por segundo antes que `WriteCapacityUnits` balanceie a carga com outras operações.Tipo: número | | TableName | O nome da tabela criada. Tipo: string | | TableStatus | O estado atual da tabela (`CREATING`). Quando a tabela estiver no estado `ACTIVE`, você poderá inserir dados nela.Use a API [DescribeTables](API_DescribeTables_v20111205.md) para verificar o status da tabela.Tipo: string | ## Erros especiais **** | Erro | Descrição | | --- | --- | | ResourceInUseException | Tentativa de recriar uma tabela já existente. | | LimitExceededException | O número de solicitações simultâneas de tabela (número cumulativo de tabelas no estado `CREATING`, `DELETING` ou `UPDATING`) excede o máximo permitido. Para conhecer os valores máximos/mínimos atuais, consulte [Cotas no Amazon DynamoDB](ServiceQuotas.md). . | ## Exemplos O exemplo a seguir cria uma tabela com uma chave primária composta que contém uma string e um número. Para obter exemplos sobre o uso do AWS SDK, consulte [Trabalhar com tabelas e dados no DynamoDB](WorkingWithTables.md). ### Exemplo de solicitação ``` // This header is abbreviated. // For a sample of a complete header, see API de baixo nível do DynamoDB. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.CreateTable content-type: application/x-amz-json-1.0 {"TableName":"comp-table", "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10} } ``` ### Exemplo de resposta ``` HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.310506263362E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}, "TableName":"comp-table", "TableStatus":"CREATING" } } ``` ## Ações relacionadas + [DescribeTables](API_DescribeTables_v20111205.md) + [DeleteTable](API_DeleteTable_v20111205.md)