Criar e remover APIs
Os métodos EnsureCreated() e EnsureDeleted() fornecem uma alternativa leve às Migrações para gerenciar o esquema de banco de dados. Esses métodos são úteis em cenários em que os dados são transitórios e podem ser descartados quando o esquema é alterado. Por exemplo, durante a criação de protótipos, em testes ou para caches locais.
Alguns provedores (especialmente os não relacionais) não dão suporte a Migrações. Para esses provedores, EnsureCreated
geralmente é a maneira mais fácil de inicializar o esquema de banco de dados.
Aviso
EnsureCreated
e Migrações não funcionam bem juntas. Se você estiver usando Migrações, não use EnsureCreated
para inicializar o esquema.
A transição EnsureCreated
para Migrações não é uma experiência perfeita. A maneira mais simples de fazer isso é remover o banco de dados e criá-lo novamente usando Migrações. Se você pretende usar Migrações no futuro, é melhor começar apenas com Migrações em vez de usar EnsureCreated
.
EnsureDeleted
O método EnsureDeleted
removerá o banco de dados se ele existir. Se você não tiver as permissões apropriadas, uma exceção será gerada.
// Drop the database if it exists
dbContext.Database.EnsureDeleted();
EnsureCreated
EnsureCreated
criará o banco de dados se ele não existir e inicializará o esquema de banco de dados. Se houver tabelas (incluindo tabelas para outra classe DbContext
), o esquema não será inicializado.
// Create the database if it doesn't exist
dbContext.Database.EnsureCreated();
Dica
Versões assíncronas desses métodos também estão disponíveis.
Script SQL
Para obter o SQL usado pelo método EnsureCreated
, você pode usar o método GenerateCreateScript.
var sql = dbContext.Database.GenerateCreateScript();
Várias classes DbContext
EnsureCreated só funciona quando nenhuma tabela está presente no banco de dados. Se necessário, você pode escrever sua própria verificação para ver se o esquema precisa ser inicializado e usar o serviço IRelationalDatabaseCreator subjacente para inicializar o esquema.
// TODO: Check whether the schema needs to be initialized
// Initialize the schema for this DbContext
var databaseCreator = dbContext.GetService<IRelationalDatabaseCreator>();
databaseCreator.CreateTables();