Partilhar via


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();