ডাটাবেস
প্লাগইনের নিজস্ব SuperAdminDbContext ও কানেকশন স্ট্রিং আছে। এর টেবিলগুলো আপনার অ্যাপের ডাটাবেসে বা আলাদা ডাটাবেসে থাকতে পারে, এমনকি অন্য ডাটাবেস সার্ভারেও।
টেবিল
ডিফল্ট প্রিফিক্স sa_ সহ:
sa_users, sa_roles, sa_permissions, sa_permission_routes, sa_menus, sa_user_roles, sa_role_permissions, sa_user_permissions, sa_role_menus, sa_operation_logs, sa_settings।
সব DateTime মান UTC হিসেবে (DateTimeKind.Utc) সংরক্ষিত ও পঠিত হয়, তাই ToLocalTime() সঠিক স্থানীয় সময় দেয়।
সমর্থিত ডাটাবেস
আপনার ডাটাবেসের জন্য EF Core 10 প্রোভাইডার ইনস্টল করে AddSuperAdmin-এ দিন:
| ডাটাবেস | প্রোভাইডার প্যাকেজ | AddSuperAdmin(..., db => ...) | টেস্ট করা |
|---|---|---|---|
| SQL Server, Azure SQL, LocalDB | Microsoft.EntityFrameworkCore.SqlServer | db.UseSqlServer(cs) | হ্যাঁ (LocalDB) |
| PostgreSQL | Npgsql.EntityFrameworkCore.PostgreSQL | db.UseNpgsql(cs) | হ্যাঁ (17) |
| MySQL | MySql.EntityFrameworkCore (Oracle-এর প্রোভাইডার) | db.UseMySQL(cs) | হ্যাঁ (9.1) |
| Oracle 23ai | Oracle.EntityFrameworkCore | db.UseOracle(cs) | শুধু স্ক্রিপ্ট ও মডেল চেক |
| Oracle 19c / 21c | Oracle.EntityFrameworkCore | db.UseOracle(cs, o => o.UseOracleSQLCompatibility(OracleSQLCompatibility.DatabaseVersion19)) | শুধু স্ক্রিপ্ট ও মডেল চেক |
| SQLite | Microsoft.EntityFrameworkCore.Sqlite | db.UseSqlite(cs) | হ্যাঁ |
| MongoDB | - | সমর্থিত নয় | - |
"হ্যাঁ" মানে প্রোভাইডার টেস্ট স্যুট (tests/.../ProviderTests.cs: তৈরি, সিড, ইউজার, রোল, পারমিশন, মেনু, নির্দিষ্ট id সহ ইম্পোর্ট, UTC তারিখ, লগ পার্জ, ইনস্টল/পুনরায় চালানো/আপগ্রেড স্ক্রিপ্ট) একটি আসল সার্ভারের বিরুদ্ধে পাস করেছে। নিজের সার্ভারে চালাতে SA_TEST_SQLSERVER, SA_TEST_POSTGRES, SA_TEST_MYSQL বা SA_TEST_ORACLE-এ কানেকশন স্ট্রিং দিন।
প্রোভাইডার নোট
- MySQL / MariaDB:
Pomelo.EntityFrameworkCore.MySql-এর এখনো EF Core 10 রিলিজ নেই (সর্বশেষ 9.0.0), তাইMySql.EntityFrameworkCoreব্যবহার করুন। ADO.NET দিয়ে SQL স্ক্রিপ্ট চালাতে কানেকশন স্ট্রিংয়েAllow User Variables=Trueযোগ করুন। MariaDB টেস্ট করা হয়নি। - Oracle: Oracle-এ
''হলোNULL, তাই "যেকোনো মেথড" কলামsa_permission_routes.HttpMethodsসেখানে nullable। JSON অ্যাট্রিবিউট, লগ করা ইনপুট ও সেটিংসNCLOB। প্যাকেজেরsql/oracleস্ক্রিপ্টেBOOLEAN(23ai) ব্যবহার হয়েছে। 19c/21c-র জন্য উপরের কম্প্যাটিবিলিটি অপশন দিন এবংsuperadmin sql-scriptদিয়ে স্ক্রিপ্ট তৈরি করুন। - MongoDB: প্লাগইনের একটি রিলেশনাল ডাটাবেস দরকার (জয়েন, ইন্টিজার আইডেন্টিটি, ট্রানজ্যাকশন)। আপনার অ্যাপের ডেটা MongoDB-তে থাকলে প্লাগইনের টেবিলগুলো ছোট একটি রিলেশনাল ডাটাবেসে রাখুন, যেমন SQLite বা PostgreSQL। সেখানে শুধু অ্যাডমিন ইউজার, রোল ও পারমিশন থাকবে।
মোড
InitializeSuperAdminAsync() Database:Mode অনুযায়ী স্কিমা সামলায়। তারপর এটি প্লাগইনের প্রতিটি টেবিল ও কলাম যাচাই করে, কিছু না থাকলে স্পষ্ট এরর দিয়ে অ্যাপ থামিয়ে দেয়, প্রথম রিকোয়েস্টে ব্যর্থ হওয়ার বদলে।
| মোড | কী করে |
|---|---|
Auto (ডিফল্ট) | অ্যাপে EF Core মাইগ্রেশন থাকলে সেগুলো প্রয়োগ করে, নইলে Create-এর মতো |
Create | কোনো টেবিল না থাকলে প্লাগইনের টেবিল তৈরি করে, এবং নতুন প্যাকেজ ভার্সনে আসা nullable কলাম যোগ করে। আপনার টেবিল আছে এমন ডাটাবেসেও কাজ করে |
Migrate | শুধু আপনার EF Core মাইগ্রেশন প্রয়োগ করে |
None | কিছুই ছোঁয় না, শুধু যাচাই করে। যে টিম রিভিউ করা SQL স্ক্রিপ্টে স্কিমা তৈরি করে তাদের জন্য |
নিজে স্কিমা ম্যানেজ করতে দেখুন মাইগ্রেশন ও SQL স্ক্রিপ্ট।