মাসের পর মাস কাজটা ফেলে রাখা থেকে ১,৮২,০০০ ব্যবহারকারী মাইগ্রেট করা পর্যন্ত: শেষ পর্যন্ত যেভাবে আমার অ্যাপটি Supabase-এ সরালাম।
১,৮২,০০০ ব্যবহারকারীকে নতুন ব্যাকএন্ডে সরানো ছোট কাজ নয়, বিশেষ করে যখন আপনি একা কাজ করা একজন মোবাইল ডেভেলপার, যাকে পাশাপাশি একটি ফুল-টাইম চাকরিও সামলাতে হয়। কিন্তু আমি সেটা করে ফেলেছি। আমার অ্যাপ OSM Tactics-কে একটি জট পাকানো NestJS + MongoDB সেটআপ থেকে Supabase-এ সরিয়েছি, যা এখন ব্যাকএন্ডের জগতে আলোচনার কেন্দ্রে। এই আর্টিকেলে পুরো যাত্রাটা দেখাব: কেন Supabase বেছে নিলাম, কী কী চ্যালেঞ্জের মুখে পড়লাম, আর মাইগ্রেশনটা কীভাবে সফল করলাম।
কেন Supabase?
আমার অ্যাপের ব্যাকএন্ড যখন পুরনো মনে হতে লাগল, আমি আরও ভালো কিছুর খোঁজ শুরু করলাম, আর Supabase আমার নজর কাড়ল। এটি একটি ওপেন-সোর্স জিনিস, অনেকটা Firebase-এর মতো, কিন্তু শুরু করা আরও সহজ। এটি আপনাকে সহজ API-সহ একটি PostgreSQL ডেটাবেস, রিয়েল-টাইম সুবিধা আর লগইন ফিচার সব সাজিয়ে দেয়। আমার মতো একজন মোবাইল অ্যাপ বানানো মানুষের জন্য এটা একদম উপযুক্ত, কারণ আমি জটিল সার্ভারের ঝামেলায় জড়াতে চাই না। প্রায় পাঁচ মিনিটেই একটি Supabase প্রজেক্ট চালু করা যায়, আর ডকুমেন্টেশন খুবই সোজাসাপ্টা, তাই ব্যাকএন্ড বিশেষজ্ঞ না হয়েও আমি দিশেহারা বোধ করিনি।
তবে Supabase শুধু সহজই নয়, এটা বড়ও হচ্ছে। এখনো Firebase-এর মতো বিশাল নয়, কিন্তু অসংখ্য ডেভেলপার এটা ব্যবহার করছেন, আর কমিউনিটি দ্রুত বাড়ছে। আমার যা দরকার সবই এতে আছে: ডেটা রাখার ডেটাবেস, লগইন টুল, ফাইল আপলোডের জায়গা, এমনকি পূর্ণ সার্ভার ছাড়াই চালানো যায় এমন ছোট ফাংশন। Firebase এর ভেতরের কাজ লুকিয়ে রাখে, কিন্তু Supabase ব্যবহার করে PostgreSQL, যা একটি পুরনো, নির্ভরযোগ্য ডেটাবেস যার ওপর অগণিত মানুষ ভরসা করে। অর্থাৎ আমি যেভাবে চাই সেভাবে জিনিস বদলাতে পারি এবং পরে আটকে না গিয়ে এটাকে বড় করতে পারি। তার ওপর অনলাইনে ডেভেলপারদের একটি বড় দল GitHub-এর মতো জায়গায় টিপস, কৌশল আর সমাধান শেয়ার করে। জানতাম আটকে গেলে Google করতে পারব বা কাউকে জিজ্ঞেস করতে পারব। সময়ের টানাটানিতে থাকা আমার মতো একা কোডারের কাছে Supabase সঠিক পছন্দ মনে হয়েছিল: সহজ, কিন্তু আমার অ্যাপ সামলানোর মতো যথেষ্ট শক্তিশালী।
বড় পরিবর্তনের আগের পুরনো সেটআপ

Supabase-এ ঝাঁপ দেওয়ার আগে চলুন দেখি আমি কী ব্যবহার করছিলাম। আমার অ্যাপ OSM Tactics Android আর iOS-এর জন্য একটি মোবাইল গেম, যেখানে মানুষ ট্যাকটিক কৌশল সাজায়। এসবে আগ্রহ থাকলে এটা বেশ মজার। ব্যাকএন্ডটা আমি নিজেই NestJS দিয়ে বানিয়েছিলাম, যা Node.js-এর একটি ফ্রেমওয়ার্ক। আমার এটা পছন্দ ছিল কারণ এটি TypeScript-এর সাথে কাজ করে আর সবকিছু গুছিয়ে রাখে। এটি MongoDB-র সাথে কথা বলত, একটি ডেটাবেস যেখানে আমি সব ব্যবহারকারীর তথ্য, গেমের ডেটা আর অন্যান্য জিনিস রাখতাম। প্রায় চার বছর ধরে আমি এই সেটআপ চালাচ্ছিলাম।
মাইগ্রেশনের আগে mongodb-র সর্বশেষ স্ন্যাপশট, Osm Tactics, যার আরেক নাম “Osm Guide”
কিন্তু সমস্যা হলো: আমি ফুল-টাইম চাকরি করা একজন মাত্র মানুষ, আর এই ব্যাকএন্ড বাঁচিয়ে রাখা আমাকে শেষ করে দিচ্ছিল। শুরুতে NestJS আর MongoDB ঠিকই ছিল, আমি সামলাতে পারতাম। কিন্তু যত ব্যবহারকারী যোগ দিল, ব্যাপারটা তত অগোছালো হলো। সার্ভার যেন ক্র্যাশ না করে, নিরাপত্তার ফাঁক বন্ধ করা আর যথেষ্ট দ্রুত রাখা, এসবে আমাকে অনেক বেশি সময় দিতে হচ্ছিল। নিরাপত্তাই ছিল সবচেয়ে খারাপ অংশ। আমি কিছুটা Node.js জানি, কিন্তু আমি একজন মোবাইল অ্যাপের মানুষ, ব্যাকএন্ড বিশেষজ্ঞ নই। এটা তখনো কোনোমতে কাজ করছিল, কিন্তু যেন একটা পুরনো গাড়ি যা বারবার নষ্ট হয়। চিরকাল জোড়াতালি দিয়ে চালানো সম্ভব ছিল না। আমার দরকার ছিল নতুন কিছু, যা আমাকে চুল ছিঁড়তে বাধ্য করবে না।
ঝাঁপ: মাইগ্রেট করার সিদ্ধান্ত

সবকিছু সরানোর সিদ্ধান্ত দ্রুত আসেনি। অনেক সময় লেগেছে, কারণ আমি বারবার কাজটা পিছিয়ে দিচ্ছিলাম। OSM Tactics অসংখ্য ফিচারওয়ালা কোনো বিশাল অ্যাপ নয়, কিন্তু ১,৮২,০০০ ব্যবহারকারী মানে সামলানোর মতো অনেক ডেটা। MongoDB, যেখানে ডেটা একদম ঢিলেঢালা আর মুক্ত, সেখান থেকে Supabase-এর PostgreSQL-এ যাওয়া, যেখানে সবকিছু গোছানো টেবিলে থাকে, কঠিন শোনাচ্ছিল। ডেটা যেভাবে সাজানো ছিল তা নতুন করে করতে হবে, আর নিশ্চিত করতে হবে যে গুরুত্বপূর্ণ কিছু হারাচ্ছি না। পুরনো NestJS-MongoDB জুটি তখনো চলছিল, কিন্তু আমার একটা খারাপ অনুভূতি হচ্ছিল যে শিগগিরই এটা ভেঙে পড়বে। এই দুশ্চিন্তা আমাকে খোঁচাতেই থাকল, যতক্ষণ না শেষে বললাম, “ঠিক আছে, করেই ফেলি।”
সিদ্ধান্ত নেওয়ার পরে বড় পরিসরে পরিকল্পনা করতে হলো। বসে বসে ঠিক করলাম কীভাবে আমার MongoDB-র জিনিসগুলো Supabase টেবিলে রূপান্তর করব, যেন সবকিছু কোথায় যাবে তার একটা মানচিত্র আঁকা। প্রথম ধাপ ছিল MongoDB থেকে সব ডেটা নিরাপদে বের করে আনা, তাই সেগুলো JSON ফাইলে ঢালার জন্য একটা ছোট স্ক্রিপ্ট লিখলাম। এই সেই কোড, সাধারণ, কিন্তু কাজ করেছে:
async function exportCollection(collectionName, outputFileName, query = {}) {
try {
await mongoose.connect(mongoURI);
const Model = mongoose.model(
collectionName,
genericSchema,
collectionName.toLowerCase()
);
const documents = await Model.find(query).lean();
const outputPath = path.join(__dirname, outputFileName);
fs.writeFileSync(outputPath, JSON.stringify(documents, null, 2));
await mongoose.disconnect();
return documents;
} catch (error) {
if (mongoose.connection.readyState !== 0) {
await mongoose.disconnect();
}
}
}
এই স্ক্রিপ্ট MongoDB-র সাথে যুক্ত হয়ে সব ডেটা টেনে বের করে আমার কম্পিউটারে JSON ফাইল হিসেবে সেভ করত। এটা ছিল একটা ব্যাকআপের মতো: ভুল করলেও সব না হারিয়ে পরীক্ষা-নিরীক্ষা করতে পারতাম। প্রতিটি collection-এর জন্য এটা চালালাম, ফাইলগুলো ঠিক দেখাচ্ছে কি না দেখে নিলাম, আর কপি আছে জেনে একটু স্বস্তি পেলাম। তবু আসল কাজ শুরু করতে গড়িমসি করছিলাম। স্ক্রিনের দিকে তাকিয়ে থাকতাম, কফিতে চুমুক দিতাম, আর ভাবতাম, “হয়তো কাল।” ঢিলেমি থামিয়ে সত্যিই কাজে নামতে একটা বড় ধাক্কা লেগেছিল, কিন্তু একবার নামার পরে পুরোপুরি ডুবে গেলাম।
ব্যবহারকারী মাইগ্রেট করা: পাসওয়ার্ডের ধাঁধা
এখানেই ব্যাপারটা সত্যিই জটিল হয়ে উঠল: ১,৮২,০০০ ব্যবহারকারীকে সরানো আর তাদের পাসওয়ার্ড কার্যকর রাখা। অ্যাপ আপডেট করার পরে ব্যবহারকারীরা একই email আর পাসওয়ার্ড দিয়ে লগইন করার আশা করেন, এটাই তো হওয়া উচিত। কিন্তু এটা করা ছিল এক দুঃস্বপ্ন। ভালো খবর? Supabase পাসওয়ার্ডের জন্য bcrypt ব্যবহার করে, MongoDB-তে আমি যা ব্যবহার করতাম ঠিক তা-ই, তাই সব পাসওয়ার্ড নতুন করে করতে বা ব্যবহারকারীদের নতুন পাসওয়ার্ড বেছে নিতে বলতে হয়নি। সেটা হতো ভয়ংকর অভিজ্ঞতা: মানুষ পাসওয়ার্ড রিসেট করা ঘৃণা করে, আর আমি অনেক ব্যবহারকারী হারাতাম।
Supabase-এর খুঁতখুঁতে Auth টেবিল সামলানো
লগইনের জন্য Supabase-এর একটি auth.users টেবিল আছে, আর এটা খুবই কড়া। এতে অনেক ফিল্ড আছে যেগুলো একদম ঠিকঠাক পূরণ করতে হয়, না হলে এটা বিগড়ে যায়। যেমন null-এর বদলে খালি string দিলে এটা ভেঙে যায়। এই GitHub থ্রেডে অন্যদের পাওয়া কিছু error দেখলাম, আর সেটা আমাকে ভয় পাইয়ে সোজা করে দিল। আমাকে একদম নিখুঁতভাবে মেলাতে হতো। Supabase-এর জন্য একজন ব্যবহারকারী দেখতে এমন ছিল (আমি ফোন সংক্রান্ত কিছু ব্যবহার করিনি, তাই সেগুলো null; আপনি করলে বদলে নিন):
const supabaseUser = {
id: uid,
email: user.email,
encrypted_password: user.password || null,
instance_id: "00000000–0000–0000–0000–000000000000",
aud: "authenticated",
role: "authenticated",
email_confirmed_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
created_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
updated_at: user.updatedAt ? new Date(user.updatedAt).toISOString() : null,
last_sign_in_at: null,
phone: user.phone || null,
phone_confirmed_at: null,
confirmed_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
invited_at: null,
confirmation_token: "",
confirmation_sent_at: null,
recovery_token: "",
recovery_sent_at: null,
email_change_token_new: "",
email_change: "",
email_change_sent_at: null,
email_change_token_current: "",
email_change_confirm_status: 0,
banned_until: null,
reauthentication_token: "",
reauthentication_sent_at: null,
is_super_admin: null,
phone_change: "",
phone_change_token: "",
phone_change_sent_at: null,
is_sso_user: false,
deleted_at: null,
is_anonymous: false,
raw_user_meta_data: JSON.stringify(rawUserMetaData),
raw_app_meta_data: JSON.stringify(rawAppMetaData),
};
প্রতিটি ফিল্ড ঠিকঠাক না হলে Supabase সেটা নিত না। আমার সব MongoDB ব্যবহারকারী সরাতে একটা বড় স্ক্রিপ্ট লিখলাম, যেটা তাদের তুলে এনে এই ফরম্যাটে রূপান্তর করে একটি CSV ফাইল হিসেবে সেভ করত। এই সেই স্ক্রিপ্ট, লম্বা, কিন্তু পুরো প্রক্রিয়াটা দেখায়:
const fs = require("fs");
const path = require("path");
const { parse } = require("json2csv");
const { v4: uuidv4 } = require("uuid");
const mongoose = require("mongoose");
const mongoURI = "your-connection-string";
// Define a generic schema for flexible document structure
const userSchema = new mongoose.Schema({}, { strict: false });
async function fetchUsersFromMongoDB() {
try {
console.log("Connecting to MongoDB…");
await mongoose.connect(mongoURI);
console.log("Connected to MongoDB");
const UserModel = mongoose.model("Users", userSchema, "users");
console.log("Fetching users from MongoDB…");
const users = await UserModel.find({}).lean();
console.log(`Found ${users.length} users in MongoDB`);
await mongoose.disconnect();
console.log("Disconnected from MongoDB");
return users;
} catch (error) {
console.error("Error fetching users from MongoDB:", error);
if (mongoose.connection.readyState !== 0) {
await mongoose.disconnect();
}
throw error;
}
}
async function processUsers() {
console.time("Total processing time");
const mongoUsersFilePath = path.join(__dirname, "mongo_users.json");
try {
// Step 1: Fetch users from MongoDB
const users = await fetchUsersFromMongoDB();
// Step 2: Write users to a fresh JSON file
fs.writeFileSync(mongoUsersFilePath, JSON.stringify(users, null, 2));
console.log(`Fresh users data written to: ${mongoUsersFilePath}`);
// Step 3: Read the fresh users file
const usersData = JSON.parse(fs.readFileSync(mongoUsersFilePath, "utf8"));
console.log(`Read ${usersData.length} users from fresh file`);
// Step 4: Filter users to include only those with an email or at least one provider
const filteredUsers = usersData.filter((user) => {
return user.email || user.googleId || user.appleId;
});
console.log(`Filtered users: ${filteredUsers.length}`);
// Create a Set to track used IDs and ensure uniqueness
const usedIds = new Set();
const usedEmails = new Set();
const duplicateEmails = [];
// Step 5: Transform the data to match Supabase Auth users structure
const transformedUsers = [];
filteredUsers.forEach((user) => {
if (!user.email) {
console.log("Skipping user without email:", user._id);
return;
}
// Check for duplicate email
const lowerEmail = user.email.toLowerCase();
if (usedEmails.has(lowerEmail)) {
duplicateEmails.push({
email: user.email,
id: user._id,
googleId: user.googleId,
appleId: user.appleId,
});
console.warn(`Duplicate email detected and skipped: ${user.email}`);
return;
}
// Mark this email as used
usedEmails.add(lowerEmail);
let uid = uuidv4();
while (usedIds.has(uid)) {
console.warn("Duplicate ID detected:", uid);
uid = uuidv4();
}
usedIds.add(uid);
const rawUserMetaData = {
sub: uid,
email: user.email,
email_verified: true,
phone_verified: false,
};
const providers = [];
// Check for Google ID
if (user.googleId) {
providers.push("google");
rawUserMetaData.iss = "https://accounts.google.com";
rawUserMetaData.sub = user.googleId;
rawUserMetaData.provider_id = user.googleId;
}
// Check for Apple ID
if (user.appleId) {
providers.push("apple"); // Only override iss and sub if Google wasn't already set
if (!user.googleId) {
rawUserMetaData.iss = "https://appleid.apple.com";
rawUserMetaData.sub = user.appleId;
rawUserMetaData.provider_id = user.appleId;
}
}
// If no external providers, use email
if (providers.length === 0) {
providers.push("email");
}
// Set the raw app metadata
const rawAppMetaData = {
provider: providers[0], // Primary provider is the first one
providers: providers, // All providers in an array
};
transformedUsers.push({
id: uid,
email: user.email || null,
encrypted_password: user.password,
instance_id: "00000000–0000–0000–0000–000000000000",
aud: "authenticated",
role: "authenticated",
invited_at: null,
confirmation_token: "",
confirmation_sent_at: null,
recovery_token: "",
recovery_sent_at: null,
email_change_token_new: "",
email_change: "",
email_change_sent_at: null,
last_sign_in_at: new Date().toISOString(),
is_super_admin: null,
phone: "",
phone_confirmed_at: null,
phone_change: "",
phone_change_token: "",
phone_change_sent_at: null,
confirmed_at: new Date().toISOString(),
email_change_token_current: "",
email_change_confirm_status: 0,
banned_until: null,
reauthentication_token: "",
reauthentication_sent_at: null,
is_sso_user: false,
deleted_at: null,
is_anonymous: false,
created_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
updated_at: null,
email_confirmed_at: user.createdAt
? new Date(user.createdAt).toISOString()
: new Date().toISOString(),
phone: user.phone || null,
phone_confirmed_at: null,
raw_user_meta_data: rawUserMetaData,
raw_app_meta_data: rawAppMetaData,
});
});
// Step 6: Convert the transformed data to CSV
const csvFields = [
"id",
"email",
"encrypted_password",
"instance_id",
"aud",
"role",
"email_confirmed_at",
"invited_at",
"confirmation_token",
"confirmation_sent_at",
"recovery_token",
"recovery_sent_at",
"email_change_token_new",
"email_change",
"email_change_sent_at",
"last_sign_in_at",
"raw_app_meta_data",
"raw_user_meta_data",
"is_super_admin",
"created_at",
"updated_at",
"phone",
"phone_confirmed_at",
"phone_change",
"phone_change_token",
"phone_change_sent_at",
"confirmed_at",
"email_change_token_current",
"email_change_confirm_status",
"banned_until",
"reauthentication_token",
"reauthentication_sent_at",
"is_sso_user",
"deleted_at",
"is_anonymous",
];
// Write duplicate emails to a file for reference
if (duplicateEmails.length > 0) {
fs.writeFileSync(
path.join(__dirname, "duplicate_emails.json"),
JSON.stringify(duplicateEmails, null, 2)
);
console.log("Duplicate emails written to duplicate_emails.json");
}
const csv = parse(transformedUsers, { fields: csvFields });
// Step 7: Write the CSV to a file
const csvFilePath = path.join(__dirname, "supabase_users.csv");
fs.writeFileSync(csvFilePath, csv);
console.log("CSV file has been generated:", csvFilePath);
// Step 8: Delete the temporary fresh users file
if (fs.existsSync(mongoUsersFilePath)) {
fs.unlinkSync(mongoUsersFilePath);
console.log(`Temporary file deleted: ${mongoUsersFilePath}`);
}
console.timeEnd("Total processing time");
} catch (error) {
console.error("Error processing users:", error);
} finally {
if (fs.existsSync(mongoUsersFilePath)) {
try {
fs.unlinkSync(mongoUsersFilePath);
console.log(`Temporary file deleted: ${mongoUsersFilePath}`);
} catch (deleteError) {
console.error(`Error deleting temporary file: ${deleteError.message}`);
}
}
}
}
CSV হাতে আসার পরে আমি Supabase-এ auth.users-এর মতো দেখতে একটি নকল টেবিল বানালাম। আসল টেবিলের সেটআপ একটি লম্বা SQL, যা Supabase-এর এডিটরে schema auth > users > Definition-এ দেখা যায়:
create table auth.users (
instance_id uuid null,
id uuid not null,
aud character varying(255) null,
role character varying(255) null,
email character varying(255) null,
encrypted_password character varying(255) null,
email_confirmed_at timestamp with time zone null,
invited_at timestamp with time zone null,
confirmation_token character varying(255) null,
confirmation_sent_at timestamp with time zone null,
recovery_token character varying(255) null,
recovery_sent_at timestamp with time zone null,
email_change_token_new character varying(255) null,
email_change character varying(255) null,
email_change_sent_at timestamp with time zone null,
last_sign_in_at timestamp with time zone null,
raw_app_meta_data jsonb null,
raw_user_meta_data jsonb null,
is_super_admin boolean null,
created_at timestamp with time zone null,
updated_at timestamp with time zone null,
phone text null default null::character varying,
phone_confirmed_at timestamp with time zone null,
phone_change text null default ''::character varying,
phone_change_token character varying(255) null default ''::character varying,
phone_change_sent_at timestamp with time zone null,
confirmed_at timestamp with time zone GENERATED ALWAYS as (LEAST(email_confirmed_at, phone_confirmed_at)) STORED null,
email_change_token_current character varying(255) null default ''::character varying,
email_change_confirm_status smallint null default 0,
banned_until timestamp with time zone null,
reauthentication_token character varying(255) null default ''::character varying,
reauthentication_sent_at timestamp with time zone null,
is_sso_user boolean not null default false,
deleted_at timestamp with time zone null,
is_anonymous boolean not null default false,
constraint users_pkey primary key (id),
constraint unique_email unique (email),
constraint users_phone_key unique (phone),
constraint users_email_change_confirm_status_check check (
(
(email_change_confirm_status >= 0)
and (email_change_confirm_status <= 2)
)
)
) TABLESPACE pg_default;
create unique INDEX IF not exists confirmation_token_idx on auth.users using btree (confirmation_token) TABLESPACE pg_default
where
((confirmation_token)::text !~ '^[0-9 ]*$'::text);
create unique INDEX IF not exists email_change_token_current_idx on auth.users using btree (email_change_token_current) TABLESPACE pg_default
where
(
(email_change_token_current)::text !~ '^[0-9 ]*$'::text
);
create unique INDEX IF not exists email_change_token_new_idx on auth.users using btree (email_change_token_new) TABLESPACE pg_default
where
(
(email_change_token_new)::text !~ '^[0-9 ]*$'::text
);
create unique INDEX IF not exists reauthentication_token_idx on auth.users using btree (reauthentication_token) TABLESPACE pg_default
where
(
(reauthentication_token)::text !~ '^[0-9 ]*$'::text
);
create unique INDEX IF not exists recovery_token_idx on auth.users using btree (recovery_token) TABLESPACE pg_default
where
((recovery_token)::text !~ '^[0-9 ]*$'::text);
create unique INDEX IF not exists users_email_partial_key on auth.users using btree (email) TABLESPACE pg_default
where
(is_sso_user = false);
create index IF not exists users_instance_id_email_idx on auth.users using btree (instance_id, lower((email)::text)) TABLESPACE pg_default;
create index IF not exists users_instance_id_idx on auth.users using btree (instance_id) TABLESPACE pg_default;
create index IF not exists users_is_anonymous_idx on auth.users using btree (is_anonymous) TABLESPACE pg_default;
আমার অস্থায়ী টেবিলের জন্য সেই সেটআপ কপি করলাম, তাতে CSV আপলোড করলাম, তারপর এই স্ক্রিপ্ট দিয়ে একবারে এক হাজার করে ব্যবহারকারী আসল auth.users টেবিলে সরালাম:
DO $$
DECLARE
batch_size INT := 1000; -- Adjust batch size as needed
records_inserted INT;
BEGIN
LOOP
INSERT INTO auth.users (
id,
email,
encrypted_password,
instance_id,
aud,
role,
email_confirmed_at,
invited_at,
confirmation_token,
confirmation_sent_at,
recovery_token,
recovery_sent_at,
email_change_token_new,
email_change,
email_change_sent_at,
last_sign_in_at,
raw_app_meta_data,
raw_user_meta_data,
is_super_admin,
created_at,
updated_at,
phone,
phone_confirmed_at,
phone_change,
phone_change_token,
phone_change_sent_at,
email_change_token_current,
email_change_confirm_status,
banned_until,
reauthentication_token,
reauthentication_sent_at,
is_sso_user,
deleted_at,
is_anonymous
)
SELECT
id,
email,
encrypted_password,
COALESCE(instance_id, '00000000-0000-0000-0000-000000000000'),
COALESCE(aud, 'authenticated'),
COALESCE(NULLIF(role, ''), 'authenticated'),
COALESCE(email_confirmed_at, NOW()),
COALESCE(invited_at, NULL),
COALESCE(confirmation_token, ''),
COALESCE(confirmation_sent_at, NULL),
COALESCE(recovery_token, ''),
COALESCE(recovery_sent_at, NULL),
COALESCE(email_change_token_new, ''),
COALESCE(email_change, ''),
COALESCE(email_change_sent_at, NULL),
COALESCE(last_sign_in_at, NOW()),
raw_app_meta_data, -- Use value from test_users table
raw_user_meta_data, -- Use value from test_users table
COALESCE(is_super_admin, NULL),
COALESCE(created_at, NOW()),
COALESCE(updated_at, NOW()),
COALESCE(phone, NULL),
COALESCE(phone_confirmed_at, NULL),
COALESCE(phone_change, ''),
COALESCE(phone_change_token, ''),
COALESCE(phone_change_sent_at, NULL),
COALESCE(email_change_token_current, ''),
COALESCE(email_change_confirm_status, 0),
COALESCE(banned_until, NULL),
COALESCE(reauthentication_token, ''),
COALESCE(reauthentication_sent_at, NULL),
COALESCE(is_sso_user, false),
COALESCE(deleted_at, NULL),
COALESCE(is_anonymous, false)
FROM public.test_users
LIMIT batch_size
ON CONFLICT (email) DO NOTHING; -- Ignore duplicates
GET DIAGNOSTICS records_inserted = ROW_COUNT;
-- Exit the loop if no more records are inserted
IF records_inserted = 0 THEN
EXIT;
END IF;
END LOOP;
END $$;
এভাবে আমি প্রতিটি ধাপ দেখতে পারছিলাম: export, রূপান্তর, লোড। কোনো অভিনব টুলের চেয়ে এতে বেশি সময় লেগেছে হয়তো, কিন্তু ঠিক কী ঘটছে তা জানতে আমার ভালো লাগছিল। CSV লোড করার পরে অস্থায়ী টেবিলটা দেখতাম, কয়েকটা রো নমুনা হিসেবে যাচাই করতাম, তারপর batch স্ক্রিপ্ট চলতে দেখতাম যাতে সেটা আটকে না যায়।
কাস্টম ফিল্ডের কোনো জায়গা নেই
Supabase-এর auth.users টেবিলে নিজের ফিল্ড যোগ করা যায় না, যা আমাকে বিভ্রান্ত করেছিল। MongoDB-তে আমি সেখানে একটা username ফিল্ড বসিয়ে দিতাম, কোনো ব্যাপার না। কিন্তু Supabase বলে না: যা দেওয়া আছে তা-ই নিয়ে থাকতে হবে। raw_user_meta_data-তে বাড়তি জিনিস গুঁজে দেওয়ার কথা ভেবেছিলাম, যা একটা JSON ঝোলার মতো, কিন্তু পরে সার্চ করার জন্য সেটা অগোছালো। তার বদলে আমি একটি নতুন profiles টেবিল বানালাম, যা user ID দিয়ে auth.users-এর সাথে যুক্ত। এতে username আর locale-এর মতো জিনিস থাকে, সবকিছু গোছানো থাকে।
এই আলোচনাটাও দেখুন, কাজে লাগতে পারে: https://github.com/orgs/supabase/discussions/3491
এটা সেটআপ করা মানে বাড়তি কাজ: MongoDB থেকে সেই বাড়তি ফিল্ডগুলো টেনে আনতে হলো, সঠিক ব্যবহারকারীদের সাথে মেলাতে হলো, আর নতুন টেবিলে লোড করতে হলো। সেই ডেটা তুলে আনতে আরেকটা স্ক্রিপ্ট লিখলাম, সেটাকে CSV-তে রূপান্তর করলাম, আর auth-এর কাজ শেষ হওয়ার পরে Supabase-এ আপলোড করলাম। এখন সেটআপটা ভালো, কারণ কিছু না ভেঙে পরে আরও ফিল্ড যোগ করতে পারি, কিন্তু একটার বদলে দুটো টেবিল সামলাতে হওয়ায় মাইগ্রেশনে বেশি সময় লেগেছে।
Google/Apple সাইন-ইন মাইগ্রেশন

Google আর Apple লগইনও ঝামেলার ছিল। MongoDB-তে আমার googleId আর appleId ফিল্ড ছিল, আর কিছু ব্যবহারকারীর দুটোই একটি email-এর সাথে বাঁধা ছিল। Supabase এগুলো সামলায় raw_user_meta_data-র বিশেষ ফিল্ড দিয়ে, যেমন iss, sub আর provider_id।
আমি যেভাবে সেটআপ করেছিলাম:
const uid = uuidv4();
const providers = [];
// Build raw user metadata
const rawUserMetaData = {
sub: uid,
email: user.email,
email_verified: true,
phone_verified: false,
};
// Check for Google ID
if (user.googleId) {
providers.push("google");
rawUserMetaData.iss = "https://accounts.google.com";
rawUserMetaData.sub = user.googleId;
rawUserMetaData.provider_id = user.googleId;
}
// Check for Apple ID
if (user.appleId) {
providers.push("apple");
if (!user.googleId) {
rawUserMetaData.iss = "https://appleid.apple.com";
rawUserMetaData.sub = user.appleId;
rawUserMetaData.provider_id = user.appleId;
}
}
// If no external providers, use email
if (providers.length === 0) {
providers.push("email");
}
অ্যাপে Supabase-এর API ব্যবহার করতে সাইন-ইন ফ্লো আপডেট করলাম। Apple-এর জন্য:
import * as AppleAuthentication from "expo-apple-authentication";
import { supabase } from "your-supabase-client";
const credential = await AppleAuthentication.signInAsync({
requestedScopes: [
AppleAuthentication.AppleAuthenticationScope.FULL_NAME,
AppleAuthentication.AppleAuthenticationScope.EMAIL,
],
});
if (credential.identityToken) {
const { data, error } = await supabase.auth.signInWithIdToken({
provider: "apple",
token: credential.identityToken,
});
}
আর Google-এর জন্য:
import { GoogleSignin } from "@react-native-google-signin/google-signin";
import { supabase } from "your-supabase-client";
const googleUser = await GoogleSignin.signIn();
if (googleUser.idToken) {
const { data, error } = await supabase.auth.signInWithIdToken({
provider: "google",
token: googleUser.idToken,
});
}
এটা কাজ করল, কিন্তু যাদের Google আর Apple দুটোই আছে তাদের সামলানো ঝামেলার ছিল: একটাকে মূল ID হিসেবে বেছে নিয়ে অন্যটাকে বাড়তি হিসেবে তালিকায় রাখতে হয়েছিল। কেউ যেন লগইন করতে না পেরে আটকে না যান, তা নিশ্চিত করতে অ্যাপে অনেকবার টেস্ট করেছি।
সতর্কতা: Supabase-এ CSV export-এর সম্ভাব্য সমস্যা আজকের হিসাবে (29/03/2025), টেবিলের ডেটা CSV হিসেবে export করা অনির্ভরযোগ্য হতে পারে, তাই Supabase আর আপনার মূল সোর্সের মধ্যে ডেটা তুলনা করার সময় এটা মাথায় রাখুন।
TypeScript টাইপ জেনারেট করা
Supabase-এর একটা দারুণ কৌশল আছে: এটা আপনার জন্য TypeScript টাইপ বানিয়ে দেয়। একটা কমান্ড চালালেই এটা এমন ফাইল বের করে দেয়, যা আপনার কোডকে জানিয়ে দেয় আপনার ডেটাবেস ঠিক দেখতে কেমন। আমার React Native আর Expo অ্যাপের জন্য এটা বিশাল ব্যাপার ছিল: কোন ডেটা পাব তা আন্দাজ করতে বা নিজে টাইপ লিখতে হয়নি। এতে বাগ অনেক কমে গেল, কারণ ভুল করলেই TypeScript আমাকে ধমক দিত। আগে বোকা ভুল ঠিক করতে ঘণ্টার পর ঘণ্টা কাটাতাম; এখন অনেক দ্রুত হয়।
টেবিল সেটআপের পরে কমান্ডটা চালালাম, টাইপের ফাইল পেলাম, আর অ্যাপে যুক্ত করে দিলাম। হঠাৎ করে user.email বা profile.username-এর মতো জিনিস এমনিই কাজ করতে লাগল, বানান ঠিক লিখেছি কি না তা নিয়ে আর ভাবতে হয়নি। ছোট জিনিস, কিন্তু এতে অ্যাপের কোডিং আন্দাজের খেলার মতো কম আর জয়ের মতো বেশি মনে হতে লাগল।
ডেটাবেস ফাংশনকে দিয়ে কাজ করানো
Supabase-এ ছোট ছোট SQL ফাংশন লেখা যায় যা ডেটাবেসের ভেতরে চলে, আর এটা খুবই কাজের। কিছু বদলাতে অ্যাপের দিকে একগাদা কোড লেখার বদলে আমি কাজটা ডেটাবেসকে দিয়ে দিলাম।
ব্যবহারকারীর প্রোফাইলে credit যোগ করার জন্য আমি এটা বানিয়েছিলাম:
declare
current_credits int;
new_credits int;
begin
-- Get current credits from user_profiles table
select assistant_credits
into current_credits
from public.user_profiles
where public.user_profiles.user_id = increase_assistant_credits.user_id;
if current_credits is null then
current_credits := 0;
end if;
new_credits := current_credits + credits_to_add;
-- Update assistant_credits in user_profiles table
update public.user_profiles
set assistant_credits = new_credits
where public.user_profiles.user_id = increase_assistant_credits.user_id;
return new_credits;
end;
এটা ব্যবহারকারীর credit নেয়, কিছু যোগ করে, আর আবার সেভ করে, সব এক ধাপে। এটা না থাকলে আমাকে credit আনতে হতো, অ্যাপে যোগ করতে হতো, তারপর ফেরত পাঠাতে হতো, যার মানে বেশি কোড আর ভুলের বেশি সুযোগ। অন্য কাজের জন্যও এরকম কয়েকটা লিখেছি, আর ভারী কাজটা ডেটাবেস করায় অ্যাপটা আরও চটপটে মনে হতে লাগল।
ব্যাকএন্ডের একটি সতর্কতা
এখানে একটা মোড় আছে: Supabase আমার ব্যাকএন্ড পুরোপুরি সরিয়ে দেয়নি। কিছু admin লগইন সুবিধা ব্যবহার করতে এই service_role key লাগে, কিন্তু এটা অ্যাপে রাখা যায় না, কারণ সেটা নিরাপদ নয়। তাই সেই গোপন কাজগুলো সামলাতে আমি একটা ছোট NestJS সার্ভার রেখে দিয়েছি। আগের মতো বড় নয়, কিন্তু সবকিছু সুরক্ষিত রাখতে এটা আছে। বেশিরভাগ কাজ Supabase করে, তাই আমার পুরনো সেটআপের চেয়ে এটা এখনো অনেক সহজ।
উপসংহার: কষ্টের মূল্য ছিল

১,৮২,০০০ ব্যবহারকারীকে Supabase-এ সরানো শুধু একটা প্রযুক্তিগত চ্যালেঞ্জ ছিল না, এটা মানসিক চ্যালেঞ্জও ছিল। গড়িমসি, গভীর রাত আর বারবার নিজের সিদ্ধান্তে সন্দেহের মাঝে এমন মুহূর্ত এসেছে যখন সত্যিই ভেবেছি হয়তো সবকিছু ভেঙে ফেলব। এটা ছিল চাপ আর দ্বিধায় ভরা একটা ধীর, একঘেয়ে পরিশ্রম। কিন্তু ভঙ্গুর NestJS + MongoDB সেটআপ পেছনে ফেলে আরও পরিষ্কার আর রক্ষণাবেক্ষণযোগ্য কিছুতে যাওয়া পুরোপুরি মূল্যবান ছিল।
ফুল-টাইম চাকরি সামলানো একজন একা ডেভেলপার হিসেবে আমার যে সরলতা, নমনীয়তা আর কমিউনিটির সাহায্য দরকার ছিল, Supabase তা দিয়েছে। আপনি যদি নিজের অ্যাপের ব্যাকএন্ড মাইগ্রেট করার কথা ভাবেন, জেনে রাখুন এটা পুরোপুরি সম্ভব। এটা দ্রুত বা কষ্টহীন হবে না, কিন্তু একটু পরিকল্পনা (আর সম্ভবত কয়েকটা দীর্ঘ রাত) থাকলে আপনি অন্য পাশে পৌঁছাবেন এমন একটা সেটআপ নিয়ে, যার ওপর সত্যিই ভরসা করা যায়।