মাইগ্রেশন ও SQL স্ক্রিপ্ট
প্লাগইনের স্কিমা ম্যানেজ করার একটি উপায় বেছে নিন। সেই অনুযায়ী Database:Mode সেট করুন।
| উপায় | কখন ব্যবহার করবেন | Database:Mode |
|---|---|---|
| স্বয়ংক্রিয় তৈরি | স্টার্টআপে অ্যাপ নিজেই টেবিল তৈরি করলে সমস্যা নেই | Auto বা Create |
| EF Core মাইগ্রেশন | আপনি আগে থেকেই EF Core মাইগ্রেশন পাঠান | Auto বা Migrate (CI প্রয়োগ করলে None) |
| SQL স্ক্রিপ্ট | একজন DBA প্রতিটি স্কিমা পরিবর্তন রিভিউ করে চালান | None |
EF Core মাইগ্রেশন
মাইগ্রেশনগুলো আপনার অ্যাপে রাখুন:
builder.Services.AddSuperAdmin(builder.Configuration.GetSection("SuperAdmin"),
db => db.UseSqlServer(cs, sql => sql.MigrationsAssembly(typeof(Program).Assembly.GetName().Name)));
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet ef migrations add SuperAdminInit --context SuperAdminDbContext --output-dir Data/SuperAdminMigrations
dotnet ef migrations add SuperAdminVNext --context SuperAdminDbContext --output-dir Data/SuperAdminMigrations # after package upgrades
মাইগ্রেশন থাকলে InitializeSuperAdminAsync() সেগুলো প্রয়োগ করে। নিজে প্রয়োগ করতে Mode = None দিন এবং CI/CD-তে dotnet ef database update --context SuperAdminDbContext চালান।
SQL স্ক্রিপ্ট (EF মাইগ্রেশন ছাড়া)
প্যাকেজে ডিফল্ট প্রিফিক্স sa_ ও ডিফল্ট স্কিমার জন্য তৈরি স্ক্রিপ্ট আছে। সেগুলো এর sql ফোল্ডারে (~/.nuget/packages/superadmin.rbac/<version>/sql/):
| ফোল্ডার | 0001_init.sql | 0002_user_attributes.sql |
|---|---|---|
sqlserver, postgresql, mysql, oracle, sqlite | সব টেবিল ও ইনডেক্স তৈরি করে, এবং বিদ্যমান টেবিলে নতুন ভার্সনের কলাম যোগ করে | 0.1.x থেকে আপগ্রেড: sa_users.Attributes যোগ করে |
প্রতিটি স্ক্রিপ্ট আবার চালানো নিরাপদ:
- SQL Server প্রতিটি স্টেটমেন্ট এক্সিস্টেন্স চেকে মোড়ায় (এবং
ANSI_NULLS/QUOTED_IDENTIFIERসেট করে)। - PostgreSQL ও SQLite
IF NOT EXISTSব্যবহার করে। - MySQL
information_schemaচেক করে। - Oracle "already exists" এরর (ORA-00955, ORA-01408, ORA-01430) উপেক্ষা করে।
- SQLite-এ
ADD COLUMN IF NOT EXISTSনেই, তাই এর আপগ্রেড স্টেটমেন্টগুলো কমেন্ট আকারে থাকে, যেগুলো একবার চালাতে হয়।
আপনার কনফিগারেশনের জন্য স্ক্রিপ্ট তৈরি করুন
অন্য প্রিফিক্স, স্কিমা বা Oracle 19c-র জন্য আপনার কনফিগারেশন থেকে স্ক্রিপ্ট তৈরি করুন। কোনো ডাটাবেস কানেকশন খোলা হয় না:
var sql = app.GenerateSuperAdminSqlScript(); // or IServiceProvider.GenerateSuperAdminSqlScript()
তৈরি স্ক্রিপ্টে আপগ্রেড স্টেটমেন্টও সবসময় থাকে। প্যাকেজ আপগ্রেডের পর এটি আবার তৈরি করে চালান।
স্ক্রিপ্ট আপনার পরিচিত টুলে চালান, তারপর Database:Mode None করুন। Mode = None হলে অ্যাপ স্টার্টআপে থেমে যায় এবং কোনো টেবিল বা কলাম না থাকলে তার তালিকা দেখায়।
কমান্ড লাইন
builder.Build()-এর পরে একটি লাইন যোগ করুন:
var app = builder.Build();
if (await app.RunSuperAdminCommandAsync(args)) return;
dotnet run -- superadmin sql-script --output superadmin.sql # the create script for this configuration
dotnet MyApp.dll superadmin seed-admin --user admin # create the schema (per Mode) and an admin user
seed-admin পাসওয়ার্ড SUPERADMIN_ADMIN_PASSWORD এনভায়রনমেন্ট ভ্যারিয়েবল থেকে পড়ে, অথবা ইকো না করে জিজ্ঞাসা করে। পাসওয়ার্ড কখনো লগে লেখা হয় না।