Todos os produtos
Search
Central de documentação

:Criar um banco de dados

Última atualização: Jun 26, 2026

Chame a operação CreateDatabase para criar um banco de dados em uma instância.

Para executar tarefas de gerenciamento de dados, como alteração de dados e design de schema, utilize o Data Management (DMS). Para mais informações, consulte Lista de operações por função do DMS.

Antes de chamar esta operação, verifique se os seguintes requisitos são atendidos:

  • A instância está no estado Running.

  • O número máximo de bancos de dados para a instância não foi atingido. Chame a operação DescribeDBInstanceAttribute para consultar o número máximo de bancos de dados.

  • A instância não é uma instância somente leitura.

    Nota

    Esta operação não é compatível com instâncias que executam SQL Server 2017 EE (edição cluster) nem com instâncias que executam PostgreSQL com SSDs locais. Nesses casos, execute a instrução CREATE DATABASE para criar um banco de dados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

ParameterTypeRequiredExampleDescription
ActionStringYesCreateDatabase

A operação a ser executada. Defina o valor como CreateDatabase.

DBInstanceIdStringYesrm-uf6wjk5xxxxxxxxxx

O ID da instância.

DBNameStringYesrds_mysql

O nome do banco de dados.

Nota
  • O nome deve ter entre 2 e 64 caracteres.
  • O nome deve começar com uma letra minúscula e terminar com uma letra minúscula ou um dígito.
  • O nome pode conter letras minúsculas, dígitos, underscores (_) e hífens (-).
  • O nome deve ser exclusivo dentro da instância.
  • Para mais informações sobre caracteres inválidos, consulte Tabela de palavras-chave proibidas.
CharacterSetNameStringYesgbk

O conjunto de caracteres.

  • Valores válidos para bancos de dados MySQL ou MariaDB: utf8, gbk, latin1 e utf8mb4
  • Valores válidos para bancos de dados SQL Server: Chinese_PRC_CI_AS, Chinese_PRC_CS_AS, SQL_Latin1_General_CP1_CI_AS, SQL_Latin1_General_CP1_CS_AS e Chinese_PRC_BIN
  • Valores válidos para bancos de dados PostgreSQL: um valor no formato Character set,<Collate>,<Ctype>. Exemplo: UTF8,C,en_US.utf8.
    • Valores válidos para o conjunto de caracteres: KOI8U, UTF8, WIN866, WIN874, WIN1250, WIN1251, WIN1252, WIN1253, WIN1254, WIN1255, WIN1256, WIN1257, WIN1258, EUC_CN, EUC_KR, EUC_TW, EUC_JP, EUC_JIS_2004, KOI8R, MULE_INTERNAL, LATIN1, LATIN2, LATIN3, LATIN4, LATIN5, LATIN6, LATIN7, LATIN8, LATIN9, LATIN10, ISO_8859_5, ISO_8859_6, ISO_8859_7, ISO_8859_8 e SQL_ASCII
    • Valores válidos para o campo Collate: execute a instrução SELECT DISTINCT collname FROM pg_collation; para obter o valor do campo. O valor padrão é C.
    • Valores válidos para o campo Ctype: execute a instrução SELECT DISTINCT collctype FROM pg_collation; para obter o valor do campo. O valor padrão é en_US.utf8.
DBDescriptionStringNoTest database

A descrição do banco de dados. Deve ter entre 2 e 256 caracteres e pode conter letras, dígitos, underscores (_) e hífens (-). A descrição deve começar com uma letra.

Nota A descrição não pode começar com http:// ou https://.
ResourceGroupIdStringNorg-acfmy*****

O ID do grupo de recursos.

Parâmetros de resposta

Parameter

Type

Example

Description

RequestId

String

5A77D650-27A1-4E08-AD9E-59008EDB6927

O ID da requisição.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=CreateDatabase
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&DBName=rds_mysql
&CharacterSetName=gbk
&<Common request parameters>

Exemplos de resposta com sucesso

XML formato

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDatabaseResponse>
  <RequestId>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestId>
</CreateDatabaseResponse>

JSON formato

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestID" : "5A77D650-27A1-4E08-AD9E-59008EDB6927"
}

Códigos de erro

HTTP status code

Error code

Error message

Description

400

EngineMigration.ActionDisabled

Specified action is disabled while custins is in engine migration.

O erro é retornado porque a operação especificada está desabilitada durante a migração de engine da instância.

400

Database.AddError

Create Db failed, please check input value and instance status

O erro é retornado porque a criação do banco de dados falhou. Verifique os parâmetros de entrada e o status da instância.

400

Database.ConnectError

Database connect error. please check instance status and database processlist

O erro é retornado porque a conexão com o banco de dados está anormal. Verifique o status da instância e o pool de conexões do banco de dados.

Para uma lista de códigos de erro, acesse o API Error Center.